本文へスキップ

ClickHouse クライアント

HTTP で分析クエリを実行し、プランとパイプラインを確認し、MergeTree のパーツとパーティションを管理できます。

概要

クエリ言語
SQL
ドライバー
Mac アプリに同梱
接続方法
ホストとポート, SSH トンネル, SSL/TLS
既定のポート
8123
最低バージョン
なし
ClickHouse に接続した Mac の TablePro。分析クエリとその結果を表示しています。

接続

ホスト、HTTP ポート、ユーザー、任意のデータベースを入力します。再接続せずにデータベースを切り替えられ、開いているタブは元のデータベースを維持します。

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

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

クエリと編集

Explain メニューは Plan、Pipeline、AST、Syntax、Estimate を提供します。字下げされた出力を図やツリーで表示し、Estimate はクエリが読む行、マーク、パーツを示します。実行中のクエリは読み取った行数を表示し、Stop は KILL QUERY を送ります。接続のクエリタイムアウトはサーバーに渡します。

挿入と UPDATE・DELETE のミューテーションはグリッドから実行できます。保存の成功は受理を意味し、適用済みとは限りません。進捗は 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 は実行中のクエリ、マージ、パーツのミューテーション、ディスク使用量を表示し、他のセッションを終了できます。system.query_log から、終了したクエリのうち一秒以上かかったものを一覧表示します。

このページでは ClickHouse 固有の内容を扱います。Safe Mode、AI アシスタント、MCP サーバーなど TablePro のその他の機能は機能ページで紹介しています。

その他

  • データの移動

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

  • 制限

    • ClickHouse の HTTP インターフェイスで接続します。ネイティブ TCP プロトコルは使いません。
    • TLS は初期設定ではオフです。HTTPS を使うには接続フォームで SSL モードを選んでください。
    • 外部キーとトランザクションはありません。
    • SET 文の設定は次のクエリに引き継がれません。
  • 一つのクエリだけ設定を変更するには?

    SELECT … SETTINGS max_threads = 4 のように、クエリに SETTINGS 句を付けます。各文は独立した HTTP リクエストなので、別に実行した SET は次の文では消えています。

  • ポート 9000 で接続できないのはなぜですか?

    9000 は ClickHouse のネイティブ TCP ポートで、TablePro は使いません。HTTP ポート、または ClickHouse Cloud の HTTPS 用 8443 に接続してください。HTTP インターフェイスが有効なら、そのポートの /ping へのリクエストは Ok. を返します。

TablePro を入手

このページの機能はすべて無料です。