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コンソールで新しいクエリを作成する方法は二つあります。

• タブバーの「＋」ボタンをクリックする
• 左側のサイドバーのクエリリストから「新しいクエリ」ボタンを選択する

クエリの実行

クエリを実行するには、SQLエディタにSQLコマンドを入力し、「実行」ボタンをクリックするか、ショートカットの cmd / ctrl + enter を使用します。複数のコマンドを連続して書いて実行する場合は、それぞれのコマンドの後にセミコロンを追加してください。

クエリ実行オプション デフォルトでは、実行ボタンをクリックすると、SQLエディタに含まれるすべてのコマンドが実行されます。SQLコンソールでは、他に二つのクエリ実行オプションがサポートされています：

• 選択したコマンドを実行
• カーソルでコマンドを実行

選択したコマンドを実行するには、希望するコマンドまたはコマンドのシーケンスをハイライトし、「実行」ボタンをクリックします（または cmd / ctrl + enter ショートカットを使用します）。選択が存在する場合、SQLエディタのコンテキストメニュー（エディタ内の任意の位置を右クリックして開く）から「選択したコマンドを実行」を選択することもできます。

現在のカーソル位置でコマンドを実行するには、二つの方法があります：

• 拡張実行オプションメニューから「カーソルで実行」を選択する（または対応する cmd / ctrl + shift + enter キーボードショートカットを使用します）

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

注記

カーソル位置にあるコマンドは、実行時に黄色に点滅します。

クエリのキャンセル

クエリが実行中は、クエリエディタツールバーの「実行」ボタンが「キャンセル」ボタンに置き換えられます。このボタンをクリックするか Esc を押すことでクエリをキャンセルできます。注意：キャンセル後も、すでに返された結果は保持されます。

クエリの保存

まだ名前が付けられていない場合、クエリは「タイトル未設定のクエリ」と呼ばれるべきです。クエリ名をクリックして変更します。クエリの名前を変更すると、そのクエリは保存されます。

保存ボタンや cmd / ctrl + s ショートカットを使用してクエリを保存することもできます。

GenAIを使用したクエリの管理

この機能を使用すると、ユーザーは自然言語の質問としてクエリを書くことができ、クエリコンソールは利用可能なテーブルのコンテキストに基づいてSQLクエリを生成します。GenAIは、ユーザーがクエリをデバッグするのを助けることもできます。

GenAIについての詳細は、ClickHouse CloudにおけるGenAIによるクエリの提案を発表しますをチェックしてください。

テーブルの設定

UK Price Paidの例のデータセットをインポートし、そのデータを使用してGenAIクエリを作成します。

1. ClickHouse Cloudサービスを開きます。

2. + アイコンをクリックして新しいクエリを作成します。

3. 以下のコードを貼り付けて実行します：

   このクエリの完了には約1秒かかります。完了すると、uk_price_paid という空のテーブルが作成されます。

4. 新しいクエリを作成し、以下のクエリを貼り付けます：

このクエリは、gov.uk ウェブサイトからデータセットを取得します。このファイルは約4GBのサイズなので、このクエリの完了には数分かかります。ClickHouseがクエリを処理すると、uk_price_paid テーブル内にデータセット全体が格納されます。

クエリの作成

自然言語を使用してクエリを作成してみましょう。

1. uk_price_paid テーブルを選択し、クエリを作成をクリックします。

2. SQLを生成をクリックします。する必要があるかもしれません、あなたのクエリがChat-GPTに送信されることを受け入れることを。続行するには了承しますを選択する必要があります。

3. これで、自然言語のクエリを入力してChatGPTがそれをSQLクエリに変換するプロンプトが使用可能になります。この例では、次のように入力します：

   年ごとのすべてのuk_price_paidトランザクションの合計価格と合計数を示してください。

4. コンソールは、必要なクエリを生成し、新しいタブに表示します。私たちの例では、GenAIは以下のクエリを作成しました：

5. クエリが正しいことを確認したら、実行をクリックして実行します。

デバッグ

次に、GenAIのクエリデバッグ機能をテストしてみましょう。

1. + アイコンをクリックして新しいクエリを作成し、以下のコードを貼り付けます：

2. 実行をクリックします。 pricee から値を取得しようとしているため、クエリは失敗します。

3. クエリを修正をクリックします。

4. GenAIはクエリを修正しようとします。この場合、pricee を price に変更しました。また、このシナリオではtoYearがより適切な関数であることに気付きました。

5. 適用を選択して、提案された変更をクエリに追加し、実行をクリックします。

GenAIは実験的な機能であることに注意してください。GenAIによって生成されたクエリを任意のデータセットで実行する際は注意を払ってください。

高度なクエリ機能

クエリ結果の検索

クエリが実行された後、結果ペインで検索入力を使用して返された結果セットを迅速に検索できます。この機能は、追加の WHERE 条項の結果をプレビューしたり、特定のデータが結果セットに含まれているかを確認したりするのに役立ちます。検索入力に値を入力すると、結果ペインが更新され、入力した値に一致するエントリを含むレコードが返されます。以下の例では、hackernews テーブルのコメントに ClickHouse を含むすべての breakfast のインスタンスを探します：

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

ページネーション設定の調整

デフォルトでは、クエリ結果ペインは、すべての結果レコードを単一のページに表示します。大きな結果セットでは、視認性を向上させるために結果をページネートする方が好ましい場合があります。これには、結果ペインの右下隅にあるページネーションセレクタを使用します：

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

クエリ結果データのエクスポート

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

クエリデータの視覚化

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

視覚化がないと、これらの結果は解釈するのが難しいです。それでは、これらをチャートに変換しましょう。

チャートの作成

視覚化の構築を開始するには、結果ペインツールバーから「チャート」オプションを選択します。チャート構成ペインが表示されます：

trip_total を week ごとに追跡するシンプルな棒グラフを作成することから始めます。これを達成するために、week フィールドをx軸に、trip_total フィールドをy軸にドラッグします：

ほとんどのチャートタイプは、数値軸に複数のフィールドをサポートしています。証明するために、fare_total フィールドをy軸にドラッグします：

チャートのカスタマイズ

SQLコンソールでは、チャートタイプセレクタから選択できる10種類のチャートタイプがサポートされています。たとえば、前のチャートタイプを棒グラフからエリアグラフに簡単に変更できます：

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

チャート構成ペインの「高度な」セクションでは、いくつかのより高度なチャートの特性も調整可能です。まず、次の設定を調整します：

• サブタイトル
• 軸タイトル
• x軸のラベルの向き

チャートはそれに応じて更新されます：

いくつかのシナリオでは、各フィールドの軸スケールを独立して調整する必要がある場合があります。これもまた、チャート構成ペインの「高度な」セクションで軸範囲の最小値と最大値を指定することで達成できます。例えば、上のチャートは良好ですが、trip_total と fare_total フィールド間の相関関係を示すためには、軸範囲に調整が必要です：