KQL クエリセット内のデータのクエリを実行する

この記事では、KQL クエリセットを使用する方法について説明します。 KQL クエリセットを使用すると、クエリの実行、結果の表示、イベントハウスや KQL データベースなどのさまざまなソースからのデータに対するクエリ結果のカスタマイズを行うことができます。

KQL クエリセットを使用して、Azure Monitor Log Analytics ワークスペースまたは Application Insights リソースに対してクロスサービス クエリを実行することもできます。

KQL クエリセットでは、Kusto クエリ言語 (KQL) を使用してクエリを作成し、多くの SQL 関数もサポートしています。 クエリ言語について詳しくは、Kusto 照会言語の概要に関する記事をご覧ください。

前提条件

• Microsoft Fabric 対応の 容量を持つ ワークスペース。
• 編集権限とデータを持つKQL データベース、または AllDatabaseAdmin 権限を持つAzure Data Explorer クラスターとデータベース。

データ ソースを選択する

クエリはデータ ソースのコンテキストで実行されます。 関連付けられているデータ ソースはいつでも変更でき、クエリエディターに保存されたクエリを保持できます。 KQL クエリセットは、KQL データベース、Azure Data Explorer クラスター、Azure Monitorなど、複数のデータ ソースの種類に関連付けることができます。

データ ソースの種類のタブを選択します。

このデータ ソースに関連付けられているテーブルの一覧がデータ ソース名の下に表示されます。

クエリを記述する

データ ソースに接続したら、それに対してクエリを実行できます。 KQL クエリセットでは、Kusto クエリ言語 (KQL) を使用して、アクセスできる接続されているデータ ソースのデータに対してクエリを実行します。 KQL の詳細については、「Kusto クエリ言語の概要」を参照してください。

次の例では、パブリック StormEvents.csv サンプル ファイルを使用します。

1. KQL クエリセットの上部ペインでクエリを作成またはコピーします。

2. [実行] ボタンを選択するか、Shift+Enter を押してクエリを実行します。

   クエリ結果は、クエリ ペインの下の結果グリッドに表示されます。 クエリが正常に終了したことを示す緑色のチェックと、クエリ結果の計算にかかった時間に注目してください。

   

データ ソースを操作する

データ ソース エクスプローラーを使用すると、現在のクエリセット タブに接続されているデータ ソースを切り替えることができます。

データ ソース エクスプローラー ウィンドウの上部にある [エクスプローラー] で、検索バーを使用して特定のデータ ソースを検索できます。 検索バーの下にあるデータベース スイッチャーを使用し、データ ソース接続メニューを展開することもできます。 使用するデータ ソースを選択します。 前にタブの名前を変更しなかった場合は、データ ソースの名前が自動的に付けられます。

データ ソース エクスプローラー ウィンドウには、2 つのセクションがあります。 上部のセクションにはデータ ソース内のすべての項目が一覧表示され、下部のセクションにはクエリ セットで使用可能なすべてのデータ ソースが表示されます。

データ ソース内の項目を表示する

データ ソース エクスプローラーの上部セクションには、使用しているデータ ソース内のすべての項目が表示されます。

• テーブル
• 具体化されたビュー
• 簡略化された手順
• Functions

展開する項目の左側にある矢印 > を選択します。 ドリルダウンして詳細を表示するには、後続のリスト レベルの項目の左側にある矢印 > を選択します。 たとえば、[ テーブル] で、テーブルの左側に > 矢印を選択すると、そのテーブル内の列の一覧が表示されます。

アクション メニューを開くには、展開されたリスト内の項目にカーソルを合わせ、[ その他] メニュー [...] を選択します。メニューには、次のオプションがあります。

• データベースの更新
• データ プロファイルの表示
• データの探索
• 挿入: スクリプトを作成してコピーする
• データの取得: 新しいデータ ソースを追加するには
• ダッシュボードの作成
• テーブルの削除

利用できるアクションは項目の種類によって異なります。

エクスプローラー ウィンドウを示すスクリーンショット

使用可能なデータ ソースを参照する

データ ソース エクスプローラーの下のセクションには、クエリセットに追加する使用可能なすべてのデータ ソースが表示されます。

アクション メニューを開くには、データ ソース名をポイントし、[ その他] メニュー [...] を選択します。メニューには、次のオプションがあります。

• データベースの更新
• このデータベースを使用する: 現在のタブでこのデータ ソースを使用するように切り替える
• 新しいタブでクエリを実行する: クエリセットの新しいタブでこのデータ ソースを開く
• ソースの削除: そのデータ ソース内のすべてのデータベースを削除する
• データベースの削除: 選択したデータベースのみを削除する
• KQL データベースで開く: このデータ ソースを KQL データベースで開きます。

クエリセット タブを管理する

KQL クエリセット内で、複数のタブを作成できます。 各タブは、異なる KQL データベースに関連付けることができます。 この設定により、後で使用するためにクエリを保存したり、他のユーザーと共有してデータ探索で共同作業したりできます。 任意のタブに関連付けられている KQL データベースを変更することもできます。これにより、異なるデータベース内のデータに対して同じクエリを実行できます。

タブは次の方法で管理できます。

• 既存のデータ ソース接続を変更する: エクスプローラーと検索バーの下で、データベース スイッチャーを使用してデータ ソース接続メニューを展開します。
• タブの名前を変更する: タブ名の横にある鉛筆アイコンを選択します。
• 新しいタブを追加する: コマンド バーの既存のタブの右側でプラス + を選択します。 異なるタブをさまざまなデータ ソースに接続できます。
• その他のアクション: コマンド バーの右側で、タブ メニューを使用してクエリ セット内の複数のタブを管理します。
• タブの位置を変更する: ドラッグ アンド ドロップ ジェスチャを使用します。

KQL クエリセットを削除する

KQL クエリセットを削除するには:

1. KQL クエリセットを含むワークスペースを選択します。

2. 削除する KQL クエリセットにカーソルを合わせます。 その他 [...] を選択し、次に 削除 を選択します。

   

次のステップ