Azure Functions における Azure Data Explorer バインドの概要 (プレビュー)

  • [アーティクル]

この一連の記事では、Azure Functions で Azure Data Explorer バインドを操作する方法について説明します。 Azure Functions では、Azure Data Explorer クラスターの入力バインドと出力バインドがサポートされています。

アクション Type
データベースからデータを読み取る 入力バインド
データベースにデータを取り込む 出力バインド

拡張機能をインストールする

インストールする拡張機能 NuGet パッケージは、関数アプリで使用している C# モードによって異なります。

関数は分離された C# ワーカー プロセスで実行されます。 詳しくは、「分離ワーカー プロセスにおける C# Azure Functions の実行のガイド」をご覧ください。

この NuGet パッケージをインストールすることによって、プロジェクトに拡張機能を追加します。

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Kusto --prerelease

バンドルをインストールする

Azure Data Explorer バインド拡張機能は、host.json プロジェクト ファイルで指定されるプレビュー拡張機能バンドルの一部です。

プレビュー拡張機能バンドルは、host.json ファイルで次のコードを追加または置き換えることによって追加できます。

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Functions ランタイム

注意

Azure Data Explorer バインド拡張機能に対する Python 言語のサポートは、Functions ランタイムの v4.6.0 以降で利用できます。 ローカル開発用の Azure Functions Core Tools のインストールを更新する必要がある場合があります。

バンドルをインストールする

Azure Data Explorer バインド拡張機能は、host.json プロジェクト ファイルで指定されるプレビュー拡張機能バンドルの一部です。

プレビュー拡張機能バンドルは、host.json ファイルで次のコードを追加または置き換えることによって追加できます。

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

バンドルをインストールする

Azure Data Explorer バインド拡張機能は、host.json プロジェクト ファイルで指定されるプレビュー拡張機能バンドルの一部です。

プレビュー拡張機能バンドルは、host.json ファイルで次のコードを追加または置き換えることによって追加できます。

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

パッケージの更新

次のスニペットに示すように、Python Azure Functions プロジェクトの pom.xml ファイルを更新して、Azure Functions プロジェクトに Azure Data Explorer バインド用の Java ライブラリを追加します。

<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library-kusto</artifactId>
    <version>1.0.4-Preview</version>
</dependency>

Kusto の接続文字列

Azure Functions の Azure Data Explorer バインドには、すべてのバインドで接続文字列に必須のプロパティがあります。 接続文字列については、「Kusto 接続文字列」を参照してください。

考慮事項

  • Azure Data Explorer バインドでは、バージョン 4.x 以降の Functions ランタイムがサポートされます。
  • Azure Data Explorer バインドのソース コードは、こちらの GitHub リポジトリにあります。
  • このバインドでは、Azure Data Explorer への接続が必要です。 入力バインドの場合、ユーザーにはビューアーのアクセス許可が必要です。 出力バインドの場合、ユーザーにはインジェスターのアクセス許可が必要です。 アクセス許可の詳細については「ロールベースのアクセスの制御」を参照してください。

次の手順