// HTTP インターフェイス・分析

Mac、Windows、Linux用のClickHouseクライアント

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 そして各インデックスが除外したパートとグラニュールの数を表示します。これは、プライマリキーとデータスキッピングインデックスが役に立っているかを示す数値です。

クエリプラン →

ライブクエリ(Kill 付き)

アクティビティモニターは実行中のものを一覧表示して強制終了でき、クエリタブの「キャンセル」はサーバー上のクエリを停止し、クエリインサイトはクエリログから上位のクエリと最近の失敗を読み取ります。

アクティビティモニター →

MergeTree を考慮した構造編集

テーブル構造エディターは、次の操作に対応しています: ADD, DROP, RENAME そして MODIFY COLUMN データスキッピングインデックスにも対応し、キーの変更には手動での確認を促すフラグを立てます。ClickHouseへのデータ転送では、MergeTreeテーブルが作成されます。

データ転送 →

BACKUP、RESTORE、および OPTIMIZE

バックアップ/復元用ドライブ BACKUP そして RESTORE DATABASE サーバーのバックアップディスクへ。メンテナンスメニューが実行するのは OPTIMIZE TABLE … FINAL テーブルのパートをマージするには。

バックアップ/復元 →

ユーザーと権限をスクリプトで管理

読み取り専用のセキュリティビューで、ClickHouse のユーザー、ロール、権限(GRANT)を表示してスクリプト化できます 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。パスワードは OS のキーチェーンに保存されます。
  4. TLSモードを選択 そして、プライベートサーバーの場合は、SSHトンネル、プロキシ、Kubernetesのポートフォワードも、PostgreSQLやMySQLとまったく同じように使えます。
  5. テスト、保存、接続、その後ツリーでデータベースを参照し、エクスプローラーの「ツール」サブメニューまたはコマンドパレットからツールを使います。

ClickHouse のすべての SQLly ツール

これは、アプリがメニューの有効/無効を切り替えるのに使っているものと同じエンジン別の対応表です。そのため、ここに書かれていることがそのままアプリの動作です。ClickHouse に当てはまらないツールについては、アプリがその理由を示しており、このサイトでも同じです。

SQLly のツールと、ClickHouse で動作するかどうか
ツール ClickHouse
エクスプローラー、IntelliSense、ホバーカード はい
推定実行プラン はい EXPLAIN json = 1, indexes = 1: 各インデックスで除外されたパートとグラニュールを表示します。
アクティビティモニター はい クエリの実行(Kill付き)。
クエリインサイト はい クエリログ: 上位のクエリと最近の失敗。
サーバーダッシュボード はい
ディスク使用量とオブジェクトブラウザ はい
メンテナンスメニュー はい OPTIMIZE TABLE … FINAL。
スキーマ比較とスキーマ履歴 はい
データ比較 はい
データ転送 はい テーブルは MergeTree として作成されます。
テストデータジェネレーター はい
テーブル構造エディター はい 列とデータスキッピングインデックス。キーの変更には手動レビューのフラグが付きます。
セキュリティエディター (ユーザー、ロール、権限) 部分的 CREATE USER 文と GRANT 文をスクリプト化する読み取り専用ビュー。
バックアップ/復元 はい BACKUP / RESTORE DATABASE をサーバーのバックアップ ディスクに対して実行します。
SSH トンネル、プロキシ、Kubernetes ポートフォワード はい
読み取り専用接続 はい
結果グリッドで行を編集 いいえ ClickHouse には行レベルの UPDATE や DELETE はありません。クエリタブで ALTER TABLE … UPDATE / DELETE を使います。
実際の(実行された)プラン いいえ ClickHouse には EXPLAIN ANALYZE がありません。Query Insights で実行の行数、バイト数、メモリを確認してください。
インデックスアナライザー いいえ インデックス使用状況カウンターはありません。インデックスの枝刈りは推定実行プランで確認してください。
データベースの作成・削除ダイアログ いいえ クエリタブで CREATE DATABASE / DROP DATABASE を使用します。
プロシージャモード いいえ 対応は SQL Server と PostgreSQL のみ。
SQL Agent、拡張イベント、ガイド付きデザイナー いいえ SQL ServerとAzure SQLのみ。
自動ロールバックの安全ラップ いいえ ClickHouse にはトランザクションがないため、SQLly はラップ内での実行を拒否します。

SQLly での ClickHouse に関する質問

SQLly は ClickHouse のどのポートに接続しますか?

SQLly は ClickHouse の HTTP インターフェイスで通信します。ポートは既定で 8123 (TLS では 8443) です。SSH トンネル、SOCKS と HTTP プロキシ、Kubernetes のポートフォワード、4 つの TLS モードは、PostgreSQL や MySQL の場合と同じように動作します。

結果グリッドで ClickHouse の行を編集できますか?

いいえ。ClickHouse には行レベルの UPDATE や DELETE がないため、グリッド内での行編集は提供されません。クエリタブで ALTER TABLE … UPDATE または DELETE を使って行を変更してください。テーブル構造エディターは ADD、DROP、RENAME、MODIFY COLUMN とデータスキッピングインデックスに対応しています。

実行中の ClickHouse のクエリを確認して停止できますか?

はい。Activity Monitorは実行中のクエリを一覧表示して強制終了でき、クエリタブでCancelするとサーバー上のクエリが停止し、Query Insightsはクエリログから上位のクエリと最近の失敗を読み取ります。

自動ロールバックの設定が ClickHouse で動作しないのはなぜですか?

ClickHouse にはトランザクションがないため、ロールバックするラップでは何も取り消せず、すべての変更がそのまま確定してしまいます。この設定が有効な場合、SQLly は誤った安全感を与える代わりに、ClickHouse 接続でのステートメント実行を拒否し、その理由を示します。

// 自分の ClickHouse で試してみる

ClickHouse を豚のもとへ持ち帰ろう

SQLly は macOS、Windows、Linux で無料で始められ、アカウントは不要です。