次の方法で共有

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

  • [アーティクル]

この記事では、KQL クエリセットを使用する方法について説明します。 KQL クエリセットは、Eventhouse、KQL データベースなどのさまざまなデータ ソースのデータに対するクエリの実行、クエリ結果の表示とカスタマイズを行うために使用される項目です。

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

前提条件

データベースを選択する

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

目的のデータベースの種類に対応するタブを選択します。

  1. KQL クエリセットを開きます。

  2. クエリ ページの左側にある接続ペインの [エクスプローラー]で、[V] を選択して、データベース接続メニューを展開します。

    接続されているデータベースのリストを示すデータベース メニューのスクリーンショット。

  3. [ソースの接続] で、OneLake データ ハブを選択します。

  4. 表示された [OneLake データ ハブ] ウィンドウで、KQL クエリセットに接続する KQL データベースを選択した後、[接続] を選択します。 または、[OneLake データ ハブ] ウィンドウを閉じ、[+ データ ソースの追加] メニューを使用して別のデータ ソースに接続します。

このデータベースに関連付けられたテーブルのリストが、接続ペイン内のデータベース名の下に表示されます。

接続ペインを使用してデータベースを操作する

接続ペインを使用すると、クエリセットに接続されているデータベースの閲覧と切り替えを行うことができます。 接続ペインの [データベース] で、[V] を選択し、データベース接続メニューを展開します。 確認したいデータベースを選択します。 接続ペインには、選択したデータベースに含まれる以下の項目の内訳が表示されます。

  • テーブル
  • 具体化されたビュー
  • ショートカット
  • 関数

接続ペインでは、各セクションにどんなアイテムが含まれているかを確認できます。 アクション メニューを開くには、項目の上にマウス ポインターを置き、[その他のメニュー] [...] を選択します。メニューには、以下のオプションがあります。

  • データを更新する
  • データ プロファイルの表示
  • 挿入 スクリプトを作成し、それをクエリ エディターに貼り付けます
  • 削除

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

クエリを記述する

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

次の例では、https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv で公開されているデータを使用します。

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

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

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

    クエリの結果を示す KQL クエリセットのスクリーンショット。クエリと結果ペインの両方が強調表示されます。

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

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

KQL クエリセットのタブを編集するためのオプションのスクリーンショット。

  • 新しいタブを追加する: 既存のタブの右側にあるプラス + 記号を選択します。 異なるタブを異なるデータベースに接続できます。
  • タブの名前を変更する: タブ名の横にある鉛筆アイコンを選択します。
  • タブ位置の変更: ドラッグ アンド ドロップ ジェスチャを使用してタブ位置を変更します。
  • 既存のデータベース接続の変更: [エクスプローラー] で、既存のデータベース接続を選択してデータ ハブを開きます。

コマンド バーの右側には、クエリセット内の複数のタブを管理するための追加アクションを含むメニューがあります。

KQL クエリセット内の複数のタブを管理するための複数タブ メニューのスクリーンショット。

クエリのコピー

作成したクエリをコピーまたは共有したい場合があるかもしれません。

  1. クエリ ウィンドウの上部で、[ホーム] タブを選択します。

  2. クエリ ペインで、[クエリのコピー] を選択します。

    クエリまたはクエリ結果のコピー オプションのドロップダウンを示す、KQL クエリセットの [管理] タブのスクリーンショット。

    次の表は、クエリをコピーするための多数の選択肢をまとめたものです。

    アクション 説明
    クエリのコピー クエリテキストをコピーします。
    リンクをクリップボードに保存 クエリの実行に使用できるディープ リンクをコピーします。
    クリップボードへのリンクとクエリ クエリの実行に使用できるリンクと、クエリのテキストをコピーします。
    クリップボードへのリンク、クエリ、結果 クエリの実行に使用できるリンク、クエリのテキスト、およびクエリの結果をコピーします。
    結果をコピーする クエリの結果をコピーします。

  3. 上記の表から目的の共有アクションを選択します。

  4. この情報を貼り付けて、Microsoft Word、Microsoft Teams、Outlook などでそれを編集または共有します。

    重要

    クエリ リンクを受け取るユーザーは、クエリを実行して結果を表示するために、基になるデータに対する表示アクセス許可を持っている必要があります。

クエリデータを CSV としてエクスポートする

クエリ出力を単にコピーして貼り付けるだけでなく、クエリ結果をエクスポートすることもできます。

これは、クエリ結果を含む CSV ファイルをエクスポートする 1 回限りの方法です。

  1. クエリ ウィンドウの上部で、[ホーム] タブを選択します。

    結果を CSV にエクスポートするための強調表示されたオプションを示す、KQL クエリセットの [ホーム] タブのスクリーンショット。

  2. クエリ ペインで、[CSV にエクスポート] を選択します。

  3. CSV ファイルをローカルに保存します。

KQL クエリセットの削除

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

  1. KQL クエリセットが配置されているワークスペースを選択します。

  2. 削除する KQL クエリセットの上にマウス ポインターを合わせます。 [その他] [...] を選択し、[削除] を選択します。

    KQL クエリセットを削除する方法を示す Microsoft Fabric ワークスペースのスクリーンショット。

次のステップ

KQL クエリセットの結果グリッドで結果をカスタマイズする