ダッシュボード
SQLコンソールのダッシュボード機能を使うことで、保存したクエリからビジュアライゼーションを収集して共有できます。クエリを保存して可視化し、ダッシュボードにクエリのビジュアライゼーションを追加し、クエリパラメータを使ってダッシュボードをインタラクティブにすることから始めましょう。
コア概念
クエリの共有
同僚とダッシュボードを共有するには、基本となる保存したクエリも共有することを確認してください。ビジュアライゼーションを表示するには、ユーザーは基本となる保存したクエリに対して、最低限読み取り専用アクセスを持っている必要があります。
インタラクティブ性
クエリパラメータを使用してダッシュボードをインタラクティブにします。例えば、WHERE句にクエリパラメータを追加してフィルタとして機能させることができます。
ビジュアライゼーション設定で「フィルタ」タイプを選択することにより、グローバルフィルタのサイドペインを介してクエリパラメータ入力を切り替えることができます。また、ダッシュボード上の別のオブジェクト（例えばテーブル）にリンクすることによってクエリパラメータ入力を切り替えることも可能です。以下のクイックスタートガイドの「フィルタの設定」セクションを参照してください。
クイックスタート
query_logシステムテーブルを使用して、ClickHouseサービスを監視するダッシュボードを作成してみましょう。
クイックスタート
保存されたクエリを作成
既に可視化するための保存されたクエリがある場合は、このステップをスキップできます。
新しいクエリタブを開きましょう。ClickHouseのシステムテーブルを使用して、日付ごとのクエリボリュームをカウントするクエリを書きます。
クエリの結果をテーブル形式で表示するか、チャートビューからビジュアライゼーションを開始できます。次のステップでは、クエリをqueries over timeとして保存します。
保存されたクエリに関するさらなるドキュメントは、クエリの保存セクションで確認できます。
クエリの種類ごとにクエリの数をカウントするために、もう1つのクエリquery count by query kindを作成して保存します。以下は、SQLコンソールでのデータの棒グラフビジュアライゼーションです。
2つのクエリがあるので、これらのクエリを可視化して集めるダッシュボードを作成しましょう。
ダッシュボードを作成
ダッシュボードパネルに移動し、「新しいダッシュボード」をクリックします。名前を指定すると、初めてのダッシュボードが作成されます！
ビジュアライゼーションを追加
保存されたクエリはqueries over timeとquery count by query kindの2つです。最初のクエリを折れ線グラフとして可視化しましょう。ビジュアライゼーションにタイトルとサブタイトルを付け、可視化するクエリを選択します。次に、「ライン」チャートタイプを選択し、x軸とy軸を指定します。
ここで、数値フォーマット、凡例のレイアウト、軸ラベルなどのスタイルの変更も行えます。
次に、2つ目のクエリをテーブルとして可視化し、折れ線グラフの下に配置しましょう。
これで、2つの保存されたクエリを可視化して、初めてのダッシュボードを作成しました！
フィルタを設定する
クエリの種類にフィルタを追加して、このダッシュボードをインタラクティブにしましょう。これにより、Insertクエリに関連するトレンドのみを表示できるようになります。このタスクはクエリパラメータを使って達成します。
折れ線グラフの横にある3つのドットをクリックし、クエリの横にある鉛筆ボタンをクリックしてインラインクエリエディタを開きます。ここで、ダッシュボードから直接基になる保存クエリを編集できます。
今、黄色の実行クエリボタンを押すと、前と同じクエリがInsertクエリのみにフィルタされて表示されます。クエリを更新するために保存ボタンをクリックします。チャート設定に戻ると、折れ線グラフをフィルタできます。
次に、上部リボンのグローバルフィルタを使用して入力を変更することでフィルタを切り替えられるようになります。
折れ線グラフのフィルタをテーブルにリンクさせたい場合には、ビジュアライゼーション設定に戻って、query_kindクエリパラメータの値ソースをテーブルに変更し、リンクするフィールドとしてquery_kindカラムを選択します。
これで、クエリの種類テーブルから折れ線グラフのフィルタを直接制御でき、ダッシュボードがインタラクティブになります。
