ダッシュボード

SQLコンソールのダッシュボード機能では、保存されたクエリから視覚化を収集し、共有することができます。まずは、クエリを保存して視覚化し、視覚化をダッシュボードに追加し、クエリパラメータを使ってダッシュボードをインタラクティブにしましょう。

コア概念

クエリ共有

同僚とダッシュボードを共有するには、基礎となる保存されたクエリも共有する必要があります。視覚化を表示するためには、ユーザーは基礎となる保存されたクエリに対して、少なくとも読み取り専用のアクセス権を持っている必要があります。

インタラクティビティ

クエリパラメータを使用して、ダッシュボードをインタラクティブにします。例えば、WHERE句にクエリパラメータを追加してフィルターとして機能させることができます。

Globalフィルターのサイドペインを通じて、視覚化設定において「フィルター」タイプを選択することで、クエリパラメータ入力を切り替えることができます。また、ダッシュボード上の別のオブジェクト（テーブルなど）にリンクすることでクエリパラメータの入力を切り替えることもできます。以下のクイックスタートガイドの「フィルターの設定」セクションをご覧ください。

クイックスタート

query_logシステムテーブルを使用して、ClickHouseサービスを監視するダッシュボードを作成しましょう。

クイックスタート

保存クエリを作成する

視覚化するための保存クエリが既にある場合は、このステップをスキップできます。

新しいクエリタブを開きましょう。ClickHouseシステムテーブルを使用して、サービスごとのクエリ量を日別にカウントするクエリを書きます：

クエリの結果をテーブル形式で表示したり、チャートビューから視覚化の構築を開始したりできます。次のステップとして、クエリをqueries over timeとして保存しましょう：

保存クエリに関する詳しいドキュメントは、クエリの保存セクションでご覧になれます。

query count by query kindという別のクエリを作成し、クエリ種別ごとのクエリ数をカウントします。以下はSQLコンソールでのデータの棒グラフ視覚化です。

2つのクエリが存在するので、これらのクエリを視覚化し、収集するダッシュボードを作成しましょう。

ダッシュボードを作成する

ダッシュボードパネルに移動し、「新しいダッシュボード」をクリックします。名前を割り当てれば、初めてのダッシュボードが成功裏に作成されます！

視覚化を追加する

2つの保存クエリ、queries over timeとquery count by query kindがあります。最初のクエリを折れ線グラフとして視覚化してみましょう。視覚化にタイトルとサブタイトルを付け、視覚化するクエリを選択します。次に、「ライン」チャートタイプを選択し、x軸とy軸を設定します。

ここで、数値のフォーマット、凡例の配置、軸ラベルなどの追加的なスタイル変更も行えます。

次に、2つ目のクエリをテーブルとして視覚化し、折れ線グラフの下に配置します。

2つの保存クエリを視覚化することで、最初のダッシュボードを作成しました！

フィルターを設定する

クエリ種別に関するトレンドだけを表示できるように、クエリ種別のフィルターを追加して、このダッシュボードをインタラクティブにしましょう。このタスクは、クエリパラメータを使用して実行します。

折れ線グラフの横にある3つのドットをクリックし、クエリの横にある鉛筆ボタンをクリックしてインラインクエリエディタを開きます。ここで、ダッシュボードから直接基礎となる保存クエリを編集できます。

これで、黄色の実行クエリボタンを押すと、以前と同じクエリが挿入クエリに絞り込まれた結果が表示されます。クエリを更新するために保存ボタンをクリックしてください。チャート設定に戻ると、折れ線グラフをフィルタリングできるようになります。

次に、上部リボンのGlobal Filtersを使用して、入力を変更することでフィルターを切り替えできます。

折れ線グラフのフィルターをテーブルにリンクしたい場合は、視覚化設定に戻り、query_kindクエリパラメータの値ソースをテーブルに変更し、リンクするフィールドとしてquery_kindカラムを選択します。

これで、種別によるクエリから直接折れ線グラフのフィルターを制御し、ダッシュボードをインタラクティブにすることができます。