ベース クエリは再利用可能なクエリ スニペットであり、パラメーター、タイル、その他の基本クエリなど、すべてのダッシュボード クエリ コンポーネントの構成要素として使用できます。 1 つの基本クエリは、特定のダッシュボードのコンテキストで管理されます。 各ダッシュボードには、1 つ以上の基本クエリを含めることができます。 ベース クエリを使用すると、一元的な場所でクエリを管理できるため、ダッシュボードでのクエリのメンテナンスが容易になります。
サンプル ダッシュボードを対話形式で探索するには、「クイック スタート: サンプル データ ダッシュボードを視覚化する」を参照してください。
Note
基本クエリの作成と管理は、ダッシュボード エディター 編集 モードで使用できます。
重要
ベース クエリを使用する場合、特定のタイルまたはパラメーターで既に使用されているデータ ソースとは異なるデータ ソースを参照することはできません。
前提条件
- Microsoft アカウントまたは Microsoft Entra ユーザー ID。 Azure サブスクリプションは不要です。
- Azure Data Explorer ダッシュボードでのダッシュボード編集のアクセス許可
ベース クエリを作成する
ダッシュボード モードを Viewing から Editing に切り替えます。
ダッシュボードの上部にある [ Base クエリを選択します。
右側にベース クエリ ペインが開きます。
[+ 追加] を選択します。
この基本クエリの参照として使用する Variable 名 を入力します。
Note
後で簡単に使用できるように、また Kusto で定義された名前と競合しないように、各ベース クエリ名をアンダースコア (_) で開始することをお勧めします。 詳細については、エンティティの を参照してください。
ドロップダウンからデータ Source を選択します。
ベース クエリとして使用する KQL クエリを入力します。 このクエリには、必要に応じて他の基本クエリを含めることができます。
完了 を選択します。
ベース クエリの管理
ベース クエリ ペイン内で、既存のベース クエリの一覧を表示できます。 各ベース クエリ カードで、ベース クエリを編集する鉛筆ウィジェットを選択するか、ベース クエリを複製、削除、または移動する [...] メニューを選択します。 カードをドラッグ アンド ドロップすることで、ベース クエリの順序を変更することもできます。
基本クエリ カードでは、次のインジケーターを表示できます。
- ベース クエリ変数名
- ベース クエリが使用されたタイルの数
- ベース クエリが使用されたパラメーターの数
- ベース クエリが使用されたベース クエリの数
基本クエリを使用する
基本クエリは、ダッシュボード タイル、パラメーター、およびその他の基本クエリで使用できます。 クエリ エディターで「'variablename'」と入力して、基本クエリを使用します。
