跳至主要內容

ClickHouse 用戶端

透過 HTTP 執行分析查詢,查看計畫和管線,並管理 MergeTree 的資料部件和分割區。

概覽

查詢語言
SQL
驅動程式
隨 Mac App 內建
連線方式
主機與連接埠, SSH 通道, SSL/TLS
預設連接埠
8123
最低版本
無要求
Mac 上連線至 ClickHouse 的 TablePro,顯示一條分析查詢及其結果。

連線

輸入主機、HTTP 連接埠、使用者和選用的資料庫,無須重新連線即可切換資料庫;已開啟的分頁會保留其開始時的資料庫。

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

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

查詢與編輯

Explain 選單提供 Plan、Pipeline、AST、Syntax 和 Estimate。縮排輸出會繪製為圖表或樹,Estimate 顯示查詢將讀取的列、marks 和資料部件。執行中的查詢會顯示目前已讀取的列數,Stop 會傳送 KILL QUERY,連線的查詢逾時也會傳給伺服器。

插入以及 UPDATE 和 DELETE mutation 可從格線執行。儲存成功表示已接受,並非已套用:請在 system.mutations 中追蹤進度。具體化檢視表為唯讀。point 和 ring 元組會在地圖檢視中開啟;自帶 FORMAT 子句的查詢會在單一欄位中顯示伺服器的原始輸出,因此要取得格線請省略該子句。

資料表、資料部件與監控

資料表開啟時提供 Structure、Indexes、DDL 和 Parts 分頁。Indexes 顯示排序鍵和資料跳過索引,DDL 顯示含引擎和設定的完整 CREATE TABLE,Parts 讀取 system.parts,並提供 Optimize、Drop Partition 和 Detach Partition。Structure 分頁可變更欄位並刪除資料跳過索引。排序鍵和主索引鍵在建立資料表時就已固定,因此請用 ALTER TABLE … ADD INDEX 新增資料跳過索引,其他變更則需重建資料表。

Server Dashboard 顯示使用中的查詢、合併、資料部件 mutation 和磁碟使用量,可終止其他工作階段,並從 system.query_log 列出耗時超過一秒的已完成查詢。

本頁介紹 ClickHouse 專屬的功能。Safe Mode、AI 助理、MCP 伺服器和 TablePro 的其他功能請見功能頁面。

其他

  • 搬移資料

    匯入 CSV、TSV、JSON、JSONL、XLSX 與 SQL 檔案,並將資料表或結果匯出為 CSV、JSON、SQL、XLSX、Markdown、HTML 與 XML。欄位中只要有一個值不是有效的 UTF-8,就會顯示為十六進位;請選取 toValidUTF8(column) 以文字讀取。

  • 限制

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

    將它放在查詢的 SETTINGS 子句中,例如 SELECT … SETTINGS max_threads = 4。每個陳述式都是獨立的 HTTP 請求,因此單獨的 SET 到下一個陳述式時就已失效。

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

    9000 是 ClickHouse 的原生 TCP 連接埠,TablePro 不使用它。請連線至 HTTP 連接埠,ClickHouse Cloud 的 HTTPS 則為 8443;HTTP 介面開啟時,對該連接埠的 /ping 請求會傳回 Ok.。

取得 TablePro

本頁功能全部免費。