SQLコンソール
SQLコンソールは、ClickHouse Cloudでデータベースを探索し、クエリを実行するための最も迅速かつ簡単な方法です。SQLコンソールを使用して、以下のことができます:
- ClickHouse Cloud Servicesに接続する
- テーブルデータを表示、フィルタリング、並べ替える
- クエリを実行し、結果データを数回のクリックで視覚化する
- チームメンバーとクエリを共有し、より効果的にコラボレーションする。
テーブルの探索
テーブルリストとスキーマ情報の表示
ClickHouseインスタンスに含まれるテーブルの概要は、左側のサイドバーエリアに表示されます。左バーの上部にあるデータベースセレクタを使用して、特定のデータベース内のテーブルを表示します。

リスト内のテーブルは展開して、カラムとタイプを表示することもできます。

テーブルデータの探索
リスト内のテーブルをクリックすると、新しいタブで開きます。テーブルビューでは、データを簡単に表示、選択、コピーできます。Microsoft ExcelやGoogle Sheetsなどのスプレッドシートアプリケーションにコピー&ペーストする際に、構造とフォーマットは保持されることに注意してください。フッターのナビゲーションを使用して、テーブルデータのページを切り替えることができます(30行単位でページ付け)。

セルデータの検査
セルインスペクターツールを使用して、単一のセルに含まれる大量のデータを表示できます。開くにはセルを右クリックし、「セルを検査」を選択します。セルインスペクターの内容は、インスペクターコンテンツの右上隅にあるコピーアイコンをクリックすることでコピーできます。

テーブルのフィルタリングと並べ替え
テーブルの並べ替え
SQLコンソールでテーブルを並べ替えるには、テーブルを開いてツールバーの「並べ替え」ボタンを選択します。このボタンをクリックすると、並べ替えを構成できるメニューが表示されます。並べ替えを希望するカラムと、並べ替えの順序(昇順または降順)を選択できます。「適用」を選択するか、Enterを押してテーブルを並べ替えます。

SQLコンソールでは、テーブルに複数の並べ替えを追加することもできます。再度「並べ替え」ボタンをクリックして、別の並べ替えを追加します。
並べ替えは、並べ替えペインに表示される順序(上から下)で適用されます。並べ替えを削除するには、並べ替えの隣にある「x」ボタンをクリックしてください。
テーブルのフィルタリング
SQLコンソールでテーブルをフィルタリングするには、テーブルを開いて「フィルター」ボタンを選択します。並べ替えと同様に、このボタンをクリックすると、フィルタを構成できるメニューが表示されます。フィルタリングするカラムを選択し、必要な基準を選択できます。SQLコンソールは、カラムに含まれるデータのタイプに対応するフィルタオプションを賢く表示します。

フィルタに満足したら、「適用」を選択してデータをフィルタリングできます。また、下記のように追加のフィルタを追加することもできます。

並べ替え機能と同様に、フィルタの隣にある「x」ボタンをクリックして削除できます。
フィルタリングと並べ替えを同時に行う
SQLコンソールでは、テーブルをフィルタリングして並べ替えを同時に行うことができます。これを行うには、上記の手順を使用してすべての希望するフィルタと並べ替えを追加し、「適用」ボタンをクリックします。

フィルタと並べ替えからクエリを作成する
SQLコンソールでは、フィルタと並べ替えをワンクリックでクエリに変換できます。希望するフィルタと並べ替えのパラメータを選択したら、ツールバーの「クエリを作成」ボタンを選択します。「クエリを作成」をクリックすると、テーブルビューに含まれるデータに対応するSQLコマンドで事前に入力された新しいクエリタブが開きます。

「クエリを作成」機能を使用する際、フィルタと並べ替えは必須ではありません。
SQLコンソールでのクエリの詳細については、(link) クエリのドキュメントを読むことができます。
クエリの作成と実行
クエリの作成
SQLコンソールで新しいクエリを作成する方法は2つあります。
- タブバーの「+」ボタンをクリックする
- 左側のサイドバーのクエリリストから「新しいクエリ」ボタンを選択する

クエリの実行
クエリを実行するには、SQLエディタにSQLコマンドを入力し、「実行」ボタンをクリックするか、ショートカットcmd / ctrl + enter
を使用します。複数のコマンドを連続して記述して実行する場合は、各コマンドの後にセミコロンを追加することを忘れないでください。
クエリ実行オプション デフォルトでは、実行ボタンをクリックするとSQLエディタ内のすべてのコマンドが実行されます。SQLコンソールは、他の2つのクエリ実行オプションをサポートします:
- 選択したコマンドを実行
- カーソルの位置でコマンドを実行
選択したコマンドを実行するには、望ましいコマンドまたはコマンドのシーケンスをハイライトし、「実行」ボタンをクリックします(またはcmd / ctrl + enter
ショートカットを使用)。選択がある場合は、SQLエディタのコンテキストメニュー(エディタ内の任意の場所を右クリックして開く)から「選択した実行」を選択することもできます。

現在のカーソル位置でコマンドを実行する方法は2つあります:
- 拡張実行オプションメニューから「カーソルで実行」を選択します(または対応するショートカット
cmd / ctrl + shift + enter
を使用)

- SQLエディタのコンテキストメニューから「カーソルで実行」を選択します。

カーソル位置にあるコマンドは実行時に黄色に点滅します。
クエリのキャンセル
クエリが実行中は、クエリエディタのツールバーにある「実行」ボタンが「キャンセル」ボタンに置き換わります。このボタンをクリックするか、Esc
を押すとクエリがキャンセルされます。注:キャンセル後に既に返された結果はそのまま表示されます。

クエリの保存
クエリを保存することで、後で簡単に見つけられるようになり、チームメンバーと共有することができます。SQLコンソールでは、クエリをフォルダに整理することもできます。
クエリを保存するには、ツールバーの「実行」ボタンのすぐ隣にある「保存」ボタンをクリックします。希望する名前を入力し、「クエリを保存」をクリックします。
ショートカットcmd / ctrl + s
を使用すると、現在のクエリタブでの作業を保存することもできます。

また、「無題のクエリ」をツールバーでクリックして名前を変更し、Enterキーを押すことで、同時にクエリの名前を付けて保存することもできます:

クエリの共有
SQLコンソールでは、クエリをチームメンバーと簡単に共有することができます。SQLコンソールは、全体およびユーザーごとに調整可能な4つのアクセスレベルをサポートしています:
- 所有者(共有オプションを調整可能)
- 書き込みアクセス
- 読み取り専用アクセス
- アクセスなし
クエリを保存した後、ツールバーの「共有」ボタンをクリックします。共有オプションが表示されるモーダルが表示されます:

サービスにアクセスできるすべての組織メンバーのクエリアクセスを調整するには、上部のアクセスレベルセレクタを調整します:

上記を適用した後、クエリはSQLコンソールにアクセスできるすべてのチームメンバーによって表示(および実行)できるようになります。
特定のメンバーのクエリアクセスを調整するには、「チームメンバーを追加」セレクタから希望するチームメンバーを選択します:

チームメンバーを選択すると、アクセスレベルセレクタを持つ新しい行項目が表示されます:

共有クエリへのアクセス
クエリが共有されている場合、「クエリ」タブのSQLコンソール左サイドバーに表示されます:

クエリへのリンク(パーマリンク)
保存されたクエリはパーマリンクされており、共有クエリへのリンクを送受信し、直接開くことができます。
クエリに存在する可能性のあるパラメータの値は、保存されたクエリのURLに自動的にクエリパラメータとして追加されます。たとえば、クエリに{start_date: Date}
および{end_date: Date}
パラメータが含まれている場合、パーマリンクは次のようになります:https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01¶m_end_date=2016-01-01
。
高度なクエリ機能
クエリ結果の検索
クエリが実行されると、結果ペイン内の検索入力を使用して取得された結果セットを迅速に検索できます。この機能は、追加のWHERE
句の結果をプレビューしたり、特定のデータが結果セットに含まれていることを確認したりするのに役立ちます。検索入力に値を入力すると、結果ペインが更新され、入力した値と一致するレコードが返されます。この例では、hackernews
テーブル内のClickHouse
を含むコメントのすべてのbreakfast
のインスタンスを探します(大文字と小文字は区別しません):

注:入力した値と一致する任意のフィールドが返されます。たとえば、上のスクリーンショットの3番目のレコードは、by
フィールドの'breakfast'には一致しませんが、text
フィールドには一致しています:

ページネーション設定の調整
デフォルトでは、クエリ結果ペインはすべての結果レコードを1ページに表示します。大きな結果セットの場合、結果をページングして表示しやすくする方が好ましいことがあります。これは、結果ペインの右下隅にあるページネーションセレクタを使用して実行できます:

ページサイズを選択すると、結果セットに直ちにページネーションが適用され、結果ペインのフッターの中央にナビゲーションオプションが表示されます。

クエリ結果データのエクスポート
クエリ結果セットは、SQLコンソールから直接CSV形式に簡単にエクスポートできます。そのためには、結果ペインツールバーの右側にある•••
メニューを開き、「CSVとしてダウンロード」を選択します。

クエリデータの視覚化
一部のデータは、チャート形式でより容易に解釈できます。SQLコンソールからクエリ結果データから視覚化を数回のクリックで迅速に作成できます。例として、NYCタクシーの週次統計を計算するクエリを使います:

視覚化なしでは、これらの結果は解釈するのが難しいです。これをチャートに変換しましょう。
チャートの作成
視覚化を構築するには、クエリ結果ペインツールバーから「チャート」オプションを選択します。チャート設定パネルが表示されます:

まずは、week
ごとのtrip_total
を追跡するシンプルな棒グラフを作成します。これを実行するには、week
フィールドをx軸に、trip_total
フィールドをy軸にドラッグします:

ほとんどのグラフタイプは数値軸上に複数のフィールドをサポートしています。デモンストレーションとして、fare_totalフィールドをy軸にドラッグします:

チャートのカスタマイズ
SQLコンソールでは、チャートタイプセレクタグラフ設定パネルで選択できる10種類のチャートタイプをサポートしています。たとえば、前のチャートタイプを棒グラフからエリアに簡単に変更できます:

チャートのタイトルは、データを供給するクエリの名前と一致します。クエリの名前を更新すると、チャートのタイトルも更新されます:

多くの高度なチャートの特性も、チャート設定パネルの「高度な」セクションで調整できます。最初に以下の設定を調整します:
- サブタイトル
- 軸タイトル
- x軸のラベル方向
それに応じてチャートが更新されます:

特定のシナリオでは、各フィールドの軸スケールを独立して調整する必要があります。これも、軸範囲の最小値と最大値を指定することによって、チャート設定パネルの「高度な」セクションで実行できます。たとえば、上記のチャートは見た目が良いですが、trip_total
とfare_total
フィールド間の相関関係を示すためには、軸の範囲を調整する必要があります:
