SQLコンソール

SQLコンソールは、ClickHouse Cloud内のデータベースを探索し、クエリを実行するための最も迅速かつ簡単な方法です。SQLコンソールを使用すると、次のことができます。

• ClickHouse Cloud Servicesに接続する
• テーブルデータを表示、フィルタリング、ソートする
• クエリを実行し、結果データを数回のクリックで視覚化する
• クエリをチームメンバーと共有し、より効果的にコラボレーションする。

テーブルの探索

テーブルリストとスキーマ情報の表示

ClickHouseインスタンスに含まれるテーブルの概要は、左のサイドバーに表示されます。左のバーの上部にあるデータベースセレクターを使用して、特定のデータベース内のテーブルを表示できます。

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

テーブルデータの探索

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

セルデータの検査

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

テーブルのフィルタリングとソート

テーブルのソート

SQLコンソールでテーブルをソートするには、テーブルを開いてツールバーの「ソート」ボタンを選択します。このボタンをクリックすると、ソートの設定を行うためのメニューが開きます。ソートしたいカラムを選択し、ソートの順序（昇順または降順）を設定できます。 「適用」を選択するか、Enterを押してテーブルをソートします。

SQLコンソールでは、テーブルに複数のソートを追加することもできます。もう一度「ソート」ボタンをクリックして別のソートを追加します。

注記

ソートは、ソートペインに表示されている順序（上から下）で適用されます。ソートを削除するには、単にソートの隣にある「x」ボタンをクリックします。

テーブルのフィルタリング

SQLコンソールでテーブルをフィルタリングするには、テーブルを開いて「フィルタ」ボタンを選択します。ソートと同様に、このボタンをクリックするとフィルタ設定のためのメニューが開きます。フィルタリングするカラムを選択し、必要な基準を選びます。SQLコンソールは、カラムに含まれるデータタイプに対応するフィルタオプションをインテリジェントに表示します。

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

ソート機能と同様に、フィルタの隣にある「x」ボタンをクリックして削除できます。

フィルタリングとソートの併用

SQLコンソールでは、テーブルを同時にフィルタリングおよびソートすることができます。これを行うには、上記で説明した手順を使用して希望するすべてのフィルタとソートを追加し、「適用」ボタンをクリックします。

フィルタとソートからクエリを作成

SQLコンソールでは、フィルタとソートを1クリックでクエリに変換できます。「クエリを作成」ボタンをツールバーのフィルタとソートのパラメータで選択してください。 「クエリを作成」をクリックすると、新しいクエリタブが開き、テーブルビューに含まれるデータに対応する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&param_end_date=2016-01-01。

高度なクエリ機能

クエリ結果の検索

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

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

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

デフォルトでは、クエリ結果ペインはすべての結果レコードを1つのページに表示します。大きな結果セットの場合、結果をページネートすることで、より簡単に表示できることもあります。これは、結果ペインの右下隅にあるページネーションセレクターを使用して行うことができます：

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

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

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

クエリデータの視覚化

一部のデータは、グラフ形式でより簡単に解釈できます。SQLコンソールからクエリ結果データから視覚化をすばやく作成できます。たとえば、NYCタクシーの週間統計を計算するクエリを使用します。

視覚化なしでは、これらの結果は解釈が難しいです。これらをグラフに変換しましょう。

グラフの作成

視覚化を構築するには、クエリ結果ペインツールバーから「グラフ」オプションを選択します。グラフ設定ペインが表示されます：

trip_total を week 別に追跡する単純な棒グラフを作成します。これを達成するために、week フィールドをx軸に、trip_total フィールドをy軸にドラッグします。

ほとんどのグラフタイプは数値軸に対して複数のフィールドをサポートしています。例として、fare_total フィールドをy軸にドラッグします。

グラフのカスタマイズ

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

グラフのタイトルは、データを提供するクエリの名前と一致します。クエリの名前を更新すると、グラフタイトルも更新されます。

多くのより高度なグラフ特性も、グラフ設定ペインの「高度な」セクションで調整できます。まず、次の設定を調整します：

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

それに応じて、グラフが更新されます。

状況によっては、各フィールドの軸スケールを独立して調整する必要がある場合があります。これは、軸の範囲に対して最小値と最大値を指定することで、「高度な」セクションで実現できます。例として、上のグラフは見た目が良いですが、trip_total と fare_total フィールド間の相関関係をデモするために、軸範囲を調整する必要があります：