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 への接続が必要です。 入力バインドの場合、ユーザーにはビューアーのアクセス許可が必要です。 出力バインドの場合、ユーザーにはインジェスターのアクセス許可が必要です。 アクセス許可の詳細については「ロールベースのアクセスの制御」を参照してください。