跳至主要內容

每天都用 TablePro?購買授權即可使用付費功能,並支持下一版本的開發。 購買授權購買授權,支持 TablePro

適用於 Mac 的 ClickHouse 用戶端

透過 ClickHouse HTTP 介面執行分析 SQL,查看查詢計畫、pipeline 或列數估計,並在資料表的 Parts 分頁管理 MergeTree 資料部件和分割區。長查詢在執行時報告已讀列數,Stop 會在伺服器端終止。

適用於 MacMac App 內建驅動程式

ClickHouse MergeTree 資料表的 Parts 分頁,列出分割區、資料片段及其列數。

概覽

查詢語言
SQL
驅動程式
隨 Mac App 內建
連線方式
主機與連接埠, SSH 通道, SSL/TLS
預設連接埠
8123
iPhone 與 iPad
無法開啟

連線

提供主機、HTTP 連接埠、使用者,可選資料庫。切換資料庫原地完成,已開啟分頁保持原資料庫。View > Sidebar as Tree 將伺服器資料庫顯示為可展開的樹狀圖。

選擇任意 SSL 模式切換為 HTTPS。443 或 ClickHouse Cloud 的 8443 連接埠會啟用 Verify Identity,使用 CA 檔案或系統信任存放區驗證憑證。Verify CA 需要 CA 檔案,用戶端憑證和金鑰可存取要求雙向 TLS 的伺服器。

未使用 TLS 時,請透過 SSH 通道存取遠端伺服器,避免在網路上傳輸明文 HTTP。

查詢與編輯

每個查詢有獨立 ID 並請求進度,長查詢會持續報告讀取列數。Stop 對該 ID 傳送 KILL QUERY,連線的查詢逾時也傳至伺服器。

Explain 選單提供 Plan、Pipeline、AST、Syntax、Estimate。縮排輸出繪製為圖或樹狀圖,Estimate 顯示查詢預計讀取的列、marks 和資料部件。

格線編輯先提供 Preview SQL,再傳送 INSERT、ALTER TABLE … UPDATE、ALTER TABLE … DELETE。ClickHouse 以背景 mutation 執行更新刪除,因此儲存表示已接受而非已套用;system.mutations 顯示進度。具體化檢視表唯讀開啟。

含 ClickHouse point 或 ring 元組的結果可在 地圖檢視開啟。自帶 FORMAT 子句的查詢將伺服器原始輸出顯示在單一欄位中,要取得格線請省略該子句。

資料表、資料部件與分割區

資料表提供 Structure、Indexes、DDL、Parts 分頁。Indexes 顯示排序鍵和資料跳過索引,DDL 顯示包含引擎和設定的完整 CREATE TABLE。

Parts 列出 system.parts 中每個資料部件及其分割區、列數、磁碟大小、修改時間和 active 標記,可在此執行 Optimize、Drop Partition、Detach Partition。

Structure 分頁可新增、修改、刪除欄位及刪除資料跳過索引。排序鍵和主索引鍵在資料表建立時固定,新增資料跳過索引用 ALTER TABLE … ADD INDEX,其他修改需重建資料表。

監控

Server Dashboard 顯示使用中查詢、合併、資料部件 mutation 和磁碟使用,列出其他工作階段並各提供 Terminate Session。慢查詢從 system.query_log 讀取最近完成且耗時超過一秒的查詢。

移動資料

透過匯入載入 CSV、TSV、JSON、JSONL、XLSX與SQL,資料表或查詢結果匯出為 CSV、JSON、SQL、XLSX、Markdown、HTML與XML。某欄位只要有一個非有效 UTF-8 值,就在格線中顯示為十六進位;選取 toValidUTF8(column) 可依文字讀取。

iPhone 與 iPad

iPhone 與 iPad App 沒有 ClickHouse 驅動程式。從 Mac 同步的 ClickHouse 連線會顯示在清單中,但無法開啟。

限制

  • 連線使用 ClickHouse 的 HTTP 介面,不使用原生 TCP 協定。
  • TLS 預設關閉。請在連線表單中選擇 SSL 模式以使用 HTTPS。
  • 沒有外部索引鍵和交易。
  • SET 陳述式的設定不會延續至下一次查詢。

關於 ClickHouse 的問題

如何僅為一個查詢修改設定?

在查詢自身加入 SETTINGS 子句,例如 SELECT … SETTINGS max_threads = 4。每個陳述式是無工作階段的獨立 HTTP 請求,單獨的 SET 不保留到下一個。

為什麼連接埠 9000 無法連線?

9000 是 ClickHouse 原生 TCP 連接埠,TablePro 不使用它。請連線 HTTP 連接埠,ClickHouse Cloud 的 HTTPS 為 8443,並確認伺服器 HTTP 介面已開啟:該連接埠上的 /ping 請求應傳回 Ok.。

取得 TablePro

Mac App 可免費下載和使用。Starter 或 Team 方案新增選用功能。
下載 Mac 版

需要 macOS 13 Ventura 或更新版本