Mac 用 ClickHouse クライアント

ホスト、HTTP ポート、ユーザーと、必要ならデータベースを指定します。データベースはその場で切り替え、既存タブは開いたときのデータベースに留まります。View > Sidebar as Tree でサーバーのデータベースを展開できるツリーとして表示します。

SSL モードを選ぶと HTTPS に切り替わります。443 または ClickHouse Cloud の 8443 ポートは Verify Identity を有効にし、CA ファイルまたはシステムの信頼ストアで証明書を検証します。Verify CA は CA ファイルが必要です。クライアント証明書と鍵で相互 TLS が必要なサーバーに接続できます。

TLS なしではネットワーク上に平文 HTTP を送る代わりに、SSH トンネル 経由でリモートサーバーに接続してください。

各クエリは固有の ID を持ち、進捗を要求するため、長いクエリも読み取った行数を随時報告します。Stop はその ID の KILL QUERY を送り、接続のクエリタイムアウトもサーバーに伝わります。

Explain メニュー は Plan、Pipeline、AST、Syntax、Estimate を提供します。字下げされた出力を図やツリーにし、Estimate ではクエリが読む予定の行、マークとパーツを示します。

グリッドの編集は Preview SQL を確認後、INSERT、ALTER TABLE … UPDATE と ALTER TABLE … DELETE で送ります。ClickHouse は更新と削除をバックグラウンドミューテーションとして実行するため、保存は受付済みであり適用済みではありません。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 は実行中クエリ、マージ、パーツのミューテーションとディスク使用量を表示し、他のセッションを Terminate Session とともに一覧表示します。遅いクエリは system.query_log の、直近で終了して一秒以上かかったクエリから取得します。

インポート で CSV、TSV、JSON、JSONL、XLSXとSQL ファイルを読み込み、テーブルやクエリ結果を CSV、JSON、SQL、XLSX、Markdown、HTMLとXML にエクスポートします。一つでも無効な UTF-8 値を含むカラムはグリッドで 16 進表示します。テキストで読むには toValidUTF8(column) を SELECT してください。

iPhone と iPad アプリには ClickHouse ドライバーがありません。Mac から同期した ClickHouse 接続は一覧に表示しますが、開けません。