// HTTP 介面 · 分析

適用於 Mac、Windows 和 Linux 的 ClickHouse 客戶端

真正懂 ClickHouse 的原生客戶端,而不是假裝它在操作交易型資料庫:精確的寬整數、能顯示索引裁剪了哪些資料片段與顆粒的執行計畫、來自查詢記錄的洞察,以及 ClickHouse 沒有對應功能時誠實地拒絕。

連線經由
ClickHouse 的 HTTP 介面
預設連接埠
8123,使用 TLS 時則為 8443
登入
ClickHouse 使用者與密碼
貼上 URL
clickhouse://user:password@host:8123/database

SQLly 為 ClickHouse 做了什麼

每個有 ClickHouse 對應工具的 SQLly 工具,都能針對 ClickHouse 的系統資料表運作。沒有對應工具的那些——因為 ClickHouse 沒有交易、沒有資料列層級更新,也沒有索引使用計數器——會直接明說,而不是中途失敗。

保留每個數字的結果

結果會隨 ClickHouse 傳送即時串流進網格。寬整數與小數保留精確位數,陣列、元組與映射以 JSON 文字呈現,多陳述式腳本會回報每個結果集或寫入的列數。

串流結果 →

會顯示索引修剪的執行計畫

預估計畫來自 ClickHouse 的 JSON EXPLAIN 並顯示每個索引修剪掉多少資料片段與顆粒——這個數字會告訴你主鍵與略過索引到底有沒有物盡其用。

查詢計畫 →

即時查詢,附帶終止功能

活動監視器會列出正在執行的作業並可終止它,查詢分頁中的取消按鈕能停止伺服器上的查詢,查詢洞察則讀取查詢記錄,找出最熱門的查詢與最近的失敗。

活動監視器 →

遵循 MergeTree 的結構編輯

資料表結構編輯器可處理 ADD, DROP, RENAME 和 MODIFY COLUMN 以及資料略過索引,並將索引鍵的變更標記為需手動審查。資料傳輸至 ClickHouse 會建立 MergeTree 資料表。

資料傳輸 →

BACKUP、RESTORE 和 OPTIMIZE

備份 / 還原磁碟 BACKUP 和 RESTORE DATABASE 到伺服器的備份磁碟,而維護選單會執行 OPTIMIZE TABLE … FINAL 來合併資料表的各個部分。

備份 / 還原 →

使用者與授權,可產生指令碼

唯讀的「安全性」檢視會顯示 ClickHouse 的使用者、角色與授權,並產生 CREATE USER 和 GRANT 語句供你檢閱後執行——ClickHouse 的存取控制就該留在 SQL 裡。

安全性 →

連線到 ClickHouse

  1. 下載 SQLly 適用於 macOS、Windows 或 Linux,從 下載頁面 下載並開啟它。
  2. 建立連線並選擇 ClickHouse。 SQLly 使用 ClickHouse 的 HTTP 介面,所以預設連接埠是 8123(使用 TLS 則為 8443)。
  3. 輸入主機、使用者、密碼,並可選擇性輸入資料庫,或貼上 clickhouse://user:password@host:8123/database URL。密碼會存進作業系統鑰匙圈。
  4. 選擇一個 TLS 模式 ,私人伺服器則可用 SSH 通道、代理或 Kubernetes 連接埠轉發——運作方式與 PostgreSQL 和 MySQL 完全相同。
  5. 測試、儲存並連線,然後在樹狀結構中瀏覽資料庫,並從瀏覽器的工具子選單或命令面板使用這些工具。

ClickHouse 上的每個 SQLly 工具

這份引擎矩陣和應用程式用來啟用或停用選單的是同一份,所以在這裡看到的就是實際狀況。當某項工具不適用於 ClickHouse 時,應用程式會說明原因——我們也一樣。

SQLly 工具在 ClickHouse 上的支援情形
工具 ClickHouse
物件總管、IntelliSense 與暫留卡片 是
預估執行計畫 是 EXPLAIN json = 1, indexes = 1:顯示每個索引各修剪掉了哪些 parts 與 granules。
活動監視器 是 執行中的查詢,可終止(Kill)。
查詢洞察 是 查詢記錄:熱門查詢和最近失敗的查詢。
伺服器儀表板 是
磁碟使用量與物件瀏覽器 是
維護選單 是 OPTIMIZE TABLE … FINAL。
結構描述比較與結構描述歷程 是
資料比較 是
資料傳輸 是 資料表以 MergeTree 建立。
測試資料產生器 是
資料表結構編輯器 是 欄位與資料跳過索引;鍵的變更會標記出來,供人工檢閱。
安全性編輯器(使用者、角色、授權) 部分 一個唯讀檢視,能產生 CREATE USER 和 GRANT 語句的腳本。
備份 / 還原 是 對伺服器的備份磁碟執行 BACKUP / RESTORE DATABASE。
SSH 通道、代理和 Kubernetes 連接埠轉發 是
唯讀連線 是
在結果網格中編輯列 否 ClickHouse 沒有資料列層級的 UPDATE 或 DELETE;請在查詢分頁中使用 ALTER TABLE … UPDATE / DELETE。
實際(已執行)計畫 否 ClickHouse 沒有 EXPLAIN ANALYZE;請在查詢洞察中查看每次執行的資料列數、位元組數與記憶體用量。
索引分析器 否 沒有索引使用計數器;索引讀取的修剪可從預估執行計畫中查看。
建立與刪除資料庫對話方塊 否 在查詢分頁中使用 CREATE DATABASE / DROP DATABASE。
程序模式 否 僅支援 SQL Server 和 PostgreSQL。
SQL Agent、Extended Events 與引導式設計工具 否 僅適用於 SQL Server 和 Azure SQL。
自動回滾安全封裝 否 ClickHouse 沒有交易,因此 SQLly 會拒絕在包覆模式下執行。

關於在 SQLly 中使用 ClickHouse 的問題

SQLly 連線到 ClickHouse 時使用哪個連接埠?

SQLly 透過 ClickHouse 的 HTTP 介面通訊:預設連接埠 8123,使用 TLS 時為 8443。SSH 通道、SOCKS 和 HTTP 代理、Kubernetes 連接埠轉送,以及四種 TLS 模式,運作方式都跟 PostgreSQL 和 MySQL 一樣。

我可以在結果網格中編輯 ClickHouse 資料列嗎?

不行。ClickHouse 沒有資料列層級的 UPDATE 或 DELETE,所以不提供在表格中直接編輯資料列的功能;請在查詢分頁中使用 ALTER TABLE … UPDATE 或 DELETE 來變更資料列。資料表結構編輯器可以處理 ADD、DROP、RENAME、MODIFY COLUMN 以及資料略過索引。

我可以檢視並停止正在執行的 ClickHouse 查詢嗎?

是的。活動監視器會列出執行中的查詢並可終止它們,查詢分頁裡按「取消」會讓伺服器停止該查詢,查詢洞察則會讀取查詢記錄,找出最熱門的查詢與最近的失敗。

為什麼自動回滾設定在 ClickHouse 上沒有作用?

ClickHouse 沒有交易,因此包覆即使 ROLLBACK 也無法復原任何變更,所有變更都會直接生效。啟用該設定後,SQLly 會拒絕在 ClickHouse 連線上執行語句並說明原因,而不是給人錯誤的安全感。

// 在你自己的 ClickHouse 上試試

把你的 ClickHouse 帶回小豬家

SQLly 在 macOS、Windows 和 Linux 上免費開始使用,不需要帳戶。