次の方法で共有


KQL アクティビティを使用してクエリを実行する

Data Factory for Microsoft Fabric の KQL アクティビティを使用すると、Azure Data Explorer インスタンスに対して Kusto 照会言語 (KQL) でクエリを実行できます。

前提条件

開始するには、次の前提条件を満たしている必要があります。

UI を使用したパイプラインへの KQL アクティビティの追加

パイプライン内で KQL アクティビティを使用するには、次の手順を実行します:

アクティビティの作成

  1. ワークスペースに新しいパイプラインを作成します。

  2. パイプラインの [アクティビティ] ペイン内で [KQL] を探し、それを選択してパイプライン キャンバスに追加します。

    Note

    次のスクリーンショットで強調表示されているように、KQL アクティビティを表示するには、メニューを展開し、下にスクロールする必要がある場合があります。

    [アクティビティ] ペインと KQL アクティビティが強調表示されている Fabric UI のスクリーンショット。

  3. まだ選択されていない場合は、パイプライン エディターのキャンバスで新しい KQL アクティビティを選択します。

    KQL アクティビティの [全般] 設定タブを示すスクリーンショット。

[全般設定] タブを構成するには、全般設定のガイダンスを参照してください。

KQL アクティビティの設定

  1. [設定] タブを選択して、ドロップダウンから KQL データベース接続を選択するか、新しい接続を作成します。 ワークスペース データ ストアを選択した場合は、ドロップダウンに表示される [動的コンテンツの追加] オプションを選択して、動的コンテンツを使用してデータベースの選択をパラメーター化できます。

  2. 次に、Command プロパティに対して選択したデータベースに対して実行する KQL クエリを指定します。 テキスト ボックスが選択されたときに表示される [動的コンテンツの追加] リンクを選択すると、クエリで動的コンテンツを使用できます。

    Command プロパティを強調表示している KQL アクティビティの [設定] タブ、および [動的なコンテンツの追加] リンクが表示される場所を示すスクリーンショット。

  3. 最後に、コマンド タイムアウトを指定するか、既定のタイムアウトを 20 分のままにします。 このプロパティにも動的コンテンツを使用できます。

パイプラインを保存して実行またはスケジュールする

通常、KQL アクティビティは他のアクティビティと共に使用できます。 パイプラインに必要なその他のアクティビティを構成したら、パイプライン エディターの上部にある [ホーム] タブに切り替え、[保存] ボタンを選択してパイプラインを保存します。 [実行] を選択して直接実行するか、[スケジュール] を選択してスケジュールを設定します。 ここで実行履歴を表示したり、他の設定を構成したりすることもできます。

タブ名、[保存]、[実行]、[スケジュール] ボタンが強調されている、パイプライン エディターの [ホーム] タブのスクリーンショット。