概览
- 查询语言
- SQL
- 驱动
- 首次使用时下载
- 连接方式
- 服务 API
连接和登录
输入 .snowflakecomputing.com 前的账户标识符,例如 myorg-myaccount。请求使用 HTTPS,因此没有主机、TLS 区域或 SSH 面板。Snowflake 没有 URL scheme:在 CLI连接名称 (CLI Connection Name) 中指定配置节,留空的每个字段都会从 ~/.snowflake/connections.toml 读取。
选择 认证方式 (Auth Method):PKCS#8 密钥对、浏览器 SSO、OAuth 令牌,或密码加 MFA 验证码(TOTP) (MFA Passcode (TOTP))。密钥对要求设备时钟准确,粘贴的 OAuth 令牌不会刷新。
账户开启 ALLOW_CLIENT_MFA_CACHING 时,一个新验证码即可:TablePro 会将 Snowflake 返回的 MFA 令牌保存在钥匙串中。开启 ALLOW_ID_TOKEN 时,浏览器 SSO 会在其中保存登录令牌,后续连接会跳过浏览器,直到 Snowflake 拒绝该令牌。
仓库、角色和查询
通过 数据库 > Session Context (Database > Session Context) 更改仓库和角色。连接在空闲时保留一个会话,其他数据库的标签页会在其语句前运行 USE DATABASE。对象列表来自不需要仓库的 SHOW 命令;列详情来自需要仓库的 INFORMATION_SCHEMA。Explain 以原始文本返回 Snowflake 的计划。
网格编辑在服务器端绑定值,VARIANT、OBJECT 和 ARRAY 单元格通过 PARSE_JSON 发送。编辑按已声明的主键定位,没有主键时则匹配所有列。标准表不强制执行键约束,因此编辑或删除会影响共享同一重复键的所有行:请先检查重复值。混合表会强制执行其键约束。
Structure
DDL 视图来自 GET_DDL。Structure 标签页可添加、重命名和删除列,设置 NOT NULL、注释和主键,扩宽 VARCHAR,并在小数位数不变的情况下修改 NUMBER 的精度。
Snowflake 会拒绝的更改会在执行前被拒绝:缩窄 VARCHAR、其他任何类型更改,以及将列默认值设为新值。清除默认值可以执行。
本页介绍 Snowflake 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。
其他
移动数据
导入 CSV、TSV、JSON、JSONL、XLSX 和 SQL 文件,并将表或结果以 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML 导出到您的 Mac。Server-Side Export 位于 文件 > Server-Side Export… (File > Server-Side Export…),它以您的权限运行
COPY INTO到暂存区,写入 gzip 压缩的 CSV、Parquet 或 JSON,数据不经过您的 Mac。限制
- Duo 仅支持动态口令,不支持推送批准。
为什么侧边栏显示表,但不显示列?
列详情来自需要运行中仓库的
INFORMATION_SCHEMA:请在连接或 Session Context 中设置 仓库 (Warehouse)。如果数据库的对象完全不显示,则需要向连接所用角色授予USAGE。为什么 TIMESTAMP_LTZ 值显示为 UTC?
TablePro 以标记为
Z的 UTC 时间读取它们,而不是转换为会话的TIMEZONE。密钥对登录提示 JWT 令牌无效,应检查什么?
令牌包含您的账户 locator 和时间戳。请检查账户标识符和 Mac 的时钟,然后确认已用
ALTER USER … SET RSA_PUBLIC_KEY注册公钥。