ダッシュボード
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つの保存されたクエリを視覚化することにより、最初のダッシュボードを作成しました!
フィルターを設定する
クエリの種類に基づくフィルターを追加して、Insertクエリに関連するトレンドのみを表示できるように、このダッシュボードをインタラクティブにしましょう。この作業は、クエリパラメータを使用して実現します。
折れ線グラフの隣にある3つのドットをクリックし、クエリの横にあるペンのボタンをクリックしてインラインクエリエディタを開きます。ここで、ダッシュボードから直接基盤となる保存されたクエリを編集できます。

今、黄色の実行クエリボタンを押すと、先ほどのクエリがInsertクエリのみにフィルタリングされて表示されます。クエリを更新するために保存ボタンをクリックしてください。チャート設定に戻ると、折れ線グラフをフィルタリングできるようになります。
今、上部のリボンにあるGlobal Filtersを使用して、入力を変更することでフィルターを切り替えることができます。

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

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