適用於 Mac 的 Snowflake 用戶端
依帳號要求的方式登入,無須重新連線切換工作階段的倉儲和角色,再查詢、編輯資料表並卸載至 stage。
適用於 Mac首次選擇 Snowflake 時下載驅動程式
概覽
- 查詢語言
- SQL
- 驅動程式
- 首次使用時下載
- 連線方式
- 服務 API
- iPhone 與 iPad
- 無法開啟
連線與登入
填寫帳號識別碼,例如 myorg-myaccount 或舊式 xy12345.us-east-1,即 .snowflakecomputing.com 前的部分。所有請求經 HTTPS 傳送至帳號端點,因此無主機、SSL 區域或 SSH 面板。
選擇 Auth Method 後僅顯示所需欄位。金鑰對使用 PKCS#8 私密金鑰為每次連線簽章,因此 Mac 時鐘必須準確。瀏覽器 SSO 前往身分供應商,OAuth 權杖依貼上內容使用且從不重新整理。帳號強制 MFA 時,密碼需配合 MFA Passcode (TOTP) 中的目前驗證碼。
帳號開啟 ALLOW_CLIENT_MFA_CACHING 時,一次新驗證碼即可:Snowflake 傳回 MFA 權杖,TablePro 儲存在鑰匙圈。啟用 ALLOW_ID_TOKEN 時,瀏覽器 SSO 儲存登入權杖,後續連線跳過瀏覽器直到 Snowflake 拒絕。
Snowflake 無 URL scheme。可在 CLI Connection Name 指定設定區段,連線時從 ~/.snowflake/connections.toml 讀取所有留空欄位。
倉儲、角色與查詢
Database > Session Context 用 USE WAREHOUSE、USE ROLE 無須重新連線切換倉儲或角色。一個 TablePro 連線對應一個 Snowflake 工作階段,閒置時仍保持。繫結第二個資料庫的分頁在同一工作階段中先執行 USE DATABASE。
側欄依資料庫和 schema 分組物件。物件清單來自不需倉儲的 SHOW 指令,欄位詳情來自需要倉儲的 INFORMATION_SCHEMA。Explain 傳回 Snowflake 原始文字計畫。
格線編輯在伺服器繫結值,VARIANT、OBJECT、ARRAY 儲存格透過 PARSE_JSON 傳送。編輯依宣告主索引鍵定位,無主索引鍵則依所有欄位。Snowflake 從不強制索引鍵條件約束,重複鍵意味著編輯或刪除影響所有符合列,請先檢查重複。
結構
DDL 檢視來自 GET_DDL。Structure 分頁 可新增、重新命名、刪除欄位,設定 NOT NULL、註解和主索引鍵,擴寬 VARCHAR,並在小數位數相同的情況下修改 NUMBER 精確度。
Snowflake 會拒絕的修改在執行前即被拒絕,包括縮窄 VARCHAR、其他型別修改及將欄位預設值改為新值。清除預設值可以執行。
移動資料
透過連線匯入 CSV、TSV、JSON、JSONL、XLSX與SQL,將資料表或結果以 CSV、JSON、SQL、XLSX、Markdown、HTML與XML 匯出至 Mac。
要不經 Mac 卸載資料表,選擇 File > Server-Side Export…,指定 stage,可含或不含 @。Server-Side Export 以自有權限執行 COPY INTO,寫入 gzip 壓縮 CSV、Parquet 或 JSON;面板等待完成,不寫入 Mac。
iPhone 與 iPad
iPhone 與 iPad App 沒有 Snowflake 驅動程式。從 Mac 同步的 Snowflake 連線會顯示在清單中,但無法開啟。
限制
- Duo 僅支援動態密碼,不支援推播核准。
關於 Snowflake 的問題
為什麼側欄顯示資料表但不顯示欄位?
欄位詳情來自需要執行中倉儲的 INFORMATION_SCHEMA。請在連線或 Session Context 設定 Warehouse。資料庫物件完全不顯示時,需要向連線角色授予 USAGE。
為什麼 TIMESTAMP_LTZ 顯示為 UTC?
TablePro 以標記 Z 的 UTC 時間讀取,不轉換為工作階段的 TIMEZONE。
金鑰對登入提示 JWT 無效,應檢查什麼?
權杖包含帳號 locator 和時間戳記。檢查帳號識別碼和 Mac 時鐘,再確認已用 ALTER USER … SET RSA_PUBLIC_KEY 為使用者註冊公開金鑰。
取得 TablePro
需要 macOS 13 Ventura 或更新版本