次の方法で共有

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

  • [アーティクル]

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

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

前提条件

データベースを選択する

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

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

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

  2. [データベース] で [V] を選択し、データベース接続 メニューを展開します。

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

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

  4. 表示された OneLake データ ハブ ウィンドウで、KQL データベースを選択し、[選択] を選択します。

    選択された KQL データベースを示す OneLake データ ハブ ウィンドウのスクリーンショット。

このデータベースに関連付けられたリストがデータベース名の下に表示されます。

クエリを記述する

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

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

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

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

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

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

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

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

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

  • タブの名前を変更する: タブ名の横にある鉛筆アイコンを選択します。
  • 新しいタブを追加する: 既存のタブの右側にあるプラス + 記号を選択します。 異なるタブを異なるデータベースに接続できます。
  • 既存のデータベース接続を変更する: [データベース] で、既存のデータベース接続を選択してデータ ハブを開きます。

クエリのコピー

作成したクエリをコピーまたは共有することもできます。

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

  2. [クエリのコピー] を選択 します。

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

    次の表は、クエリを共有する方法の多くのオプションの概要を示しています。

    重要

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

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

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

  4. この情報を Microsoft Word などの任意のエディターに貼り付けます。

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

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

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

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

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

  2. [結果を CSV にエクスポートする] を選択します。

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

KQL クエリセットの削除

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

  1. KQL クエリセットが関連付けられているワークスペースを選択します。

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

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

次のステップ

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