/play パス (たとえば http://localhost:8123/play) から利用できます。これにより、クエリを作成して実行し、結果をテーブルまたはチャートとして表示したり、URL をコピーしてクエリを共有したりできます。
インターフェイス全体は programs/server/play.html に収められており、フレームワークやビルドステップなしで ClickHouse バイナリから直接配信される、単一の自己完結型ページです。唯一の例外はチャートのレンダリングです。uPlot チャートライブラリは、結果を初めてチャートとして表示する際にサードパーティの CDN から遅延読み込みされるため、オフライン環境または egress が制限されたデプロイ環境ではチャートを利用できません。
クエリタブ
タブバーが表示されるタイミング
タブの作成、閉じる、名前の変更
- タブの右側にある
[+]ボタンをクリックして、新しいタブを作成します。 - タブ上の
xアイコンでタブを閉じます。 - 新しいタブには、デフォルトで
Query A、Query Bなどの名前が付きます。 - アクティブなタブのタイトルをクリックするとその場で編集でき、編集欄はテキストの長さに合わせて広がります。
タブの切り替え
- 非アクティブなタブをクリックすると、そのタブに切り替わります。
- タブパネル上でマウスホイールをスクロールすると、タブを切り替えられます。上にスクロールすると左のタブに、下にスクロールすると右のタブに切り替わります (存在する場合) 。縦方向・横方向どちらのホイールスクロールでも動作します。
永続化とブラウザ履歴
- 履歴状態にはアクティブなタブが保持されるため、ブラウザの戻るボタンと進むボタンでタブを切り替えられます。
- URL には
tab=<name>パラメータが追加されます。読み込み時には、URL のクエリとtabパラメータが保存済みのタブとリコンサイルされます。つまり、その名前の既存タブがあればそれが再利用され (そのクエリで置き換えられます) 、名前が見つからない場合や名前未設定の場合は新しいタブが作成されます。これにより、自分で保存したタブを保持したまま、新しいクエリを含む URL を開けるようになります。