Service Connector を使用して Azure Functions をサービスに接続する方法
Azure Functions は、Service Connector でサポートされているコンピューティング サービスの 1 つです。 バインドを使用して Azure Functions を他のサービスと接続することをお勧めしますが、クライアント SDK を使用することもできます。 この記事は、次の内容を理解するのに役立ちます。
- Service Connector と Functions のバインド間の関係。
- バインドまたは SDK を使用して Functions を他の Azure サービスに接続するために Service Connector によって使用されるプロセス。
- 各シナリオで Service Connector とユーザーがそれぞれ担う責任。
前提条件
- このガイドでは、Service Connector の基本的な概念を既に理解していることを前提としています。
- このガイドでは、Azure Functions 開発者ガイドに記載されている概念と、関数を Azure サービスに接続する方法を理解していることを前提としています。
Service Connector と Azure Functions のバインド
Azure Functions のバインド
バインドは Azure Functions で使用される概念であり、関数コードでクライアント SDK を操作することなく、サービスに関数を接続する簡単な方法を提供することを目的としています。
バインドでは、入力、出力、トリガーをサポートできます。 バインディングを使うと、Functions ホストがデータ アクセスを自動処理できるようにサービスへの接続を構成できます。 詳細については、「Azure Functions でのトリガーとバインドの概念」を参照してください。
関数バインドでは、シークレット/接続文字列認証の種類と ID ベースの認証の種類の両方がサポートされます。
Service Connector
Service Connector は、開発者がコンピューティング サービスをターゲット バッキング サービスに簡単に接続するのに役立つ Azure サービスです。 Azure Functions は、Service Connector でサポートされているコンピューティング サービスの 1 つです。
Service Connector は、論理的に抽象化された概念に似た関数バインドと比較して、直接操作できる Azure サービスです。 これは、接続のライフサイクル全体に API を提供します 。たとえばcreate
delete
validate
、正常性と list configurations
.
Service Connector では、シークレット/接続文字列認証の種類と ID ベースの認証の種類の両方もサポートされます。
Azure Functions バインドでの接続
Functions バインドでは、 connection
関数フォルダー内のバインド ファイル (通常はファイル) で定義されている function.json
プロパティです。 これは、ターゲット サービスに対する認証にバインド ランタイムによって使用されるアプリ設定の名前またはプレフィックスを定義します。
Service Connector での接続
connection
In Service Connector は、Service Connector に属する特定の Azure リソースを指します。
Azure Functions バインドによって使用されるバインドは connection
、Service Connector で使用されるバインドに configuration name
対応します。 構成名は、Service Connect がコンピューティング サービスの構成に保存するアプリ設定キー名を指します。
Service Connector を使用して Azure Functions を他のクラウド サービスに接続する
Service Connector を使用すると、バインドまたは SDK を使用して Azure Functions をクラウド サービスに接続するために必要な作業量が削減されます。 アプリ 設定、ネットワーク、ID、アクセス許可の割り当てなどのクラウド リソース構成を引き継ぎ、ユーザーが機能ビジネス ロジックに集中できるようにします。 次のセクションでは、Service Connector を使用して、さまざまな接続メカニズムと認証方法を使用して関数接続を簡略化する方法について説明します。
バインド
- シークレット/接続文字列
シナリオ | 操作 | 説明 | サービス コネクタなし | Service Connector を使用する |
---|---|---|---|---|
ローカル プロジェクト | バインドの追加 | ターゲット サービスの種類とバインドの種類 (in/out/trigger) に従って、関数にバインドを追加します。 | User | User |
バインドを使用する | 認証の接続文字列を設定し、バインドでlocal.settings.json 定義されている変数を使用するように関数コードを変更します。 |
User | User | |
クラウド リソース | アプリケーションの設定の構成 | 関数リソースの構成でアプリ設定として接続文字列を構成します。 | User | Service Connector |
ネットワークを構成する | ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 | User | Service Connector |
- ID ベースの認証
シナリオ | 操作 | 説明 | サービス コネクタなし | Service Connector を使用する |
---|---|---|---|---|
ローカル プロジェクト | バインドの追加 | ターゲット サービスの種類とバインドの種類 (in/out/trigger) に従って、関数にバインドを追加します。 | User | User |
バインドを使用する | 認証の接続文字列を設定し、バインドでlocal.settings.json 定義されている変数を使用するように関数コードを変更します。 |
User | User | |
クラウド リソース | アプリケーションの設定の構成 | サービス エンドポイントなど、Azure 関数の ID 設定を構成します。 | User | Service Connector |
ネットワークを構成する | ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 | User | Service Connector | |
ID の構成 | システム ID を使用して認証する場合は、システム ID が有効になっていることを確認します。 | User | Service Connector | |
アクセス許可の割り当て | ターゲット サービスにアクセスできるように、ID に必要なロールを割り当てます。 | User | Service Connector |
関数バインドで Service Connector を使用する場合は、Service Connector によって構成された関数のキー名に特に注意してください。 バインド ファイルのプロパティで connection
定義されているキー名と同じキー名であることを確認します。 異なる場合は、バインド ファイルの名前を変更するか、Service Connector の customize keys
機能を使用して Service Connector の既定の構成名をカスタマイズ します。
SDK
- シークレット/接続文字列
シナリオ | 操作 | 説明 | サービス コネクタなし | Service Connector を使用する |
---|---|---|---|---|
ローカル プロジェクト | 依存関係を追加する | ターゲット サービスとランタイムに従って依存関係パッケージを追加します。 | User | User |
SDK クライアントの開始 | で認証local.settings.json の接続文字列を設定します。 接続文字列を使用してターゲット サービス SDK を開始します。 |
User | User | |
クラウド リソース | アプリケーションの設定の構成 | 関数の構成でアプリ設定として接続文字列を構成します。 | User | Service Connector |
ネットワークを構成する | ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 | User | Service Connector |
- ID ベースの認証
シナリオ | 操作 | 説明 | サービス コネクタなし | Service Connector を使用する |
---|---|---|---|---|
ローカル プロジェクト | 依存関係を追加する | ターゲット サービスとランタイムに従って依存関係パッケージを追加します。 | User | User |
SDK クライアントの開始 | で認証local.settings.json の接続文字列を設定します。 接続文字列を使用してターゲット サービス SDK を開始します。 |
User | User | |
クラウド リソース | アプリケーションの設定の構成 | 関数の構成でアプリ設定として接続文字列を構成します。 | User | Service Connector |
ネットワークを構成する | ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 | User | Service Connector | |
ID の構成 | システム ID を使用して認証する場合は、システム ID が有効になっていることを確認します。 | User | Service Connector | |
アクセス許可の割り当て | ターゲット サービスにアクセスできるように、ID に必要なロールを割り当てます。 | User | Service Connector |
次のステップ
さまざまなターゲット サービスを統合し、その構成設定と認証方法について確認する方法について説明します。