> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ダッシュボード

> SQL Console のダッシュボード機能を使用すると、保存クエリから可視化をまとめて共有できます。

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

SQL Console のダッシュボード機能では、保存クエリから可視化を集約し、共有できます。まずはクエリを保存して可視化し、その可視化をダッシュボードに追加して、クエリパラメータを使ってダッシュボードをインタラクティブにしましょう。

<div id="core-concepts">
  ## 基本概念
</div>

<div id="query-sharing">
  ### クエリの共有
</div>

ダッシュボードを同僚と共有する際は、基になる保存クエリも必ず共有してください。可視化を表示するには、少なくとも基になる保存クエリへの読み取り専用のアクセス権が必要です。

<div id="interactivity">
  ### インタラクティブ性
</div>

ダッシュボードをインタラクティブにするには、[クエリパラメータ](/ja/reference/syntax#defining-and-using-query-parameters)を使用します。たとえば、`WHERE` 句にクエリパラメータを追加して、フィルタとして機能させることができます。

可視化設定で “フィルタ” タイプを選択すると、**Global** フィルタのサイドペインからクエリパラメータ入力の表示を切り替えられます。また、ダッシュボード上の別のオブジェクト (テーブルなど) にリンクして、クエリパラメータ入力の表示を切り替えることもできます。詳しくは、以下のクイックスタートガイドの「[フィルタを設定する](/ja/products/cloud/features/sql-console-features/dashboards#configure-a-filter)」セクションを参照してください。

<div id="quick-start">
  ## クイックスタート
</div>

[query\_log](/ja/reference/system-tables/query_log) システムテーブルを使って、ClickHouseサービスを監視するためのダッシュボードを作成しましょう。

<div id="quick-start">
  ## クイックスタート
</div>

<div id="create-a-saved-query">
  ### 保存クエリを作成する
</div>

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

新しいクエリタブを開きます。ClickHouseのシステムテーブルを使って、あるサービスの日別のクエリ数を集計するクエリを書いてみましょう。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/2_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=6e3cc2bfb603a3a949521f3caef4dc33" size="md" alt="保存クエリを作成する" border width="1600" height="1372" data-path="images/cloud/dashboards/2_dashboards.png" />

クエリの結果はテーブル形式で表示することも、チャートビューから可視化の作成を始めることもできます。次の手順に進むため、このクエリを `queries over time` として保存します。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/3_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=ce40ebf9af562752646c9d1ea43f7265" size="md" alt="クエリを保存" border width="1274" height="484" data-path="images/cloud/dashboards/3_dashboards.png" />

保存クエリの詳細については、[Saving a Query セクション](/ja/products/cloud/features/sql-console-features/sql-console#saving-a-query)を参照してください。

別のクエリ `query count by query kind` を作成して保存し、query kindごとのクエリ数を集計することもできます。以下は、SQL Consoleでこのデータを棒グラフとして可視化したものです。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/4_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=7803ff57f27b2f17f428f105a21f4c76" size="md" alt="クエリ結果の棒グラフによる可視化" border width="1438" height="1600" data-path="images/cloud/dashboards/4_dashboards.png" />

これでクエリが2つそろったので、これらを可視化してまとめるためのダッシュボードを作成しましょう。

<div id="create-a-dashboard">
  ### ダッシュボードを作成する
</div>

「Dashboards」パネルに移動し、「New Dashboard」をクリックします。名前を付けると、最初のダッシュボードが作成されます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/5_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=25a523e3a6c600c6b6d48fefb0c17c71" size="md" alt="新しいダッシュボードを作成する" border width="1466" height="778" data-path="images/cloud/dashboards/5_dashboards.png" />

<div id="add-a-visualization">
  ### 可視化を追加する
</div>

`queries over time` と `query count by query kind` という 2 つの保存クエリがあります。まずは 1 つ目を折れ線チャートとして可視化しましょう。可視化にタイトルとサブタイトルを付け、可視化するクエリを選択します。次に、「Line」チャートタイプを選択し、x 軸と y 軸を指定します。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/6_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=4a7fdc9236416635a0e7c028467ef8cd" size="md" alt="可視化を追加する" border width="1600" height="1097" data-path="images/cloud/dashboards/6_dashboards.png" />

ここでは、数値のフォーマット、凡例のレイアウト、軸ラベルなど、スタイルに関する追加の調整も行えます。

次に、2 つ目のクエリをテーブルとして可視化し、折れ線チャートの下に配置しましょう。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/7_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=02ed09475a15dbc1ee94f4fcec7c497d" size="md" alt="クエリ結果をテーブルとして可視化する" border width="1600" height="1048" data-path="images/cloud/dashboards/7_dashboards.png" />

これで、2 つの保存クエリを可視化した最初のダッシュボードが完成しました！

<div id="configure-a-filter">
  ### フィルタを設定する
</div>

`query kind` にフィルタを追加して、このダッシュボードをインタラクティブにしましょう。これにより、Insert クエリに関連する傾向だけを表示できます。この作業は、[クエリパラメータ](/ja/reference/syntax#defining-and-using-query-parameters) を使って行います。

折れ線チャートの横にある 3 点メニューをクリックし、クエリの横にある鉛筆ボタンをクリックしてインラインのクエリエディタを開きます。ここでは、ダッシュボードから直接、元の保存クエリを編集できます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/8_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=2d088a3725f98a18d0def203c7ecabc5" size="md" alt="元のクエリを編集する" border width="1115" height="1600" data-path="images/cloud/dashboards/8_dashboards.png" />

ここで黄色のクエリ実行ボタンを押すと、先ほどと同じクエリが Insert クエリのみに絞り込まれて表示されます。保存ボタンをクリックしてクエリを更新します。グラフ設定に戻ると、折れ線チャートにフィルタを適用できるようになります。

これで、上部リボンの Global Filters を使って、入力を変更することでフィルタを切り替えられます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/9_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=78fcf57875e7b4b3625890617338662b" size="md" alt="グローバルフィルタを調整する" border width="1600" height="1045" data-path="images/cloud/dashboards/9_dashboards.png" />

折れ線チャートのフィルタをテーブルに連動させたいとします。これを行うには、可視化設定に戻って `query_kind` クエリパラメータの value source をテーブルに変更し、連動させるフィールドとして `query_kind` カラムを選択します。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/10_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=c89343736adf85cfa963cb2e9c6b8b2e" size="md" alt="クエリパラメータを変更する" border width="1600" height="1045" data-path="images/cloud/dashboards/10_dashboards.png" />

これで、queries by kind テーブルから直接、折れ線チャートのフィルタを操作できるようになり、ダッシュボードをインタラクティブにできます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/Q67DpMkcKgzQJkGD/images/cloud/dashboards/11_dashboards.png?fit=max&auto=format&n=Q67DpMkcKgzQJkGD&q=85&s=08d328185e1be52555b9773b70691de6" size="md" alt="折れ線グラフのフィルタを制御する" border width="1600" height="1012" data-path="images/cloud/dashboards/11_dashboards.png" />
