BizTalk でCosmos DB にストアドプロシージャを実行する
CData BizTalk Adapter が提供するストアドプロシージャを使用して、BizTalk のCosmos DB を自動化できます。ストアドプロシージャは、基盤となるAPI で使用できるアクションを実装しています。
加藤龍彦
デジタルマーケティング
最終更新日:2021-07-17
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ストアドプロシージャは、SELECT 、INSERT 、UPDATE 、DELETE としては表すことができないCosmos DB アクションを実装します。この記事では、ストアドプロシージャ用のスキーマを作成する方法を説明します。このスキーマを使用して、送信ポートからストアドプロシージャを実行できます。
プロジェクトにアダプターを追加する
[Add Adapter] ウィザードから、アダプターをVisual Studio のBizTalk サーバープロジェクトに追加します。このアダプターは、ストアドプロシージャへの入力とその結果に関するメタデータを返します。このメタデータを使用してスキーマを作成します。
- [Solution Explorer] の[project] で右クリックし、[Add] -> [Add Generated Items] と進みます。
- [resulting dialog box] の[Add Adapter Metadata] を選択します。
- 表示される[Add Adapter] ウィザードで、リストからアダプターを選択します。
- [Port menu] では、選択を空白のままにします。もしくは、Cosmos DB アダプターを使用するように構成されている受信場所や送信ポートを選択します。
送信ポートまたは受信場所に、認証資格情報と他の接続プロパティが構成されていない場合、[Connection String] ページで、それらを入力します。下は一般的な接続文字列です。
AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;
CosmosDB 接続プロパティの取得・設定方法
SQL API を使ってCosmos DB アカウントに接続するために必要な接続文字列を取得するには、Azure Portal にログインして「Azure Cosmos
DB」を選択し、自分のアカウントを選択します。「Settings」セクションで、「Connection String」をクリックして次の値を設定します。
- AccountEndpoint:この値は、Cosmos DB アカウントの「Keys」ブレードからのCosmos DB アカウントURL に設定してください。
- AccountKey:Azure ポータルで、Cosmos DB サービスに移動してAzure Cosmos DB アカウントを選択します。リソースメニューから、
「Keys」ページに移動します。「PRIMARY KEY」値を見つけ、Token をこの値に設定します。
スキーマを作成する
[Add Adapter] ウィザードで接続プロパティを入力すると、[Schema] ウィザードが表示されます。
- 次の[Schema Information] のページでは、Cosmos DB アダプターを使用するために構成した送信ポートを選択します。
- CData Cosmos DB アダプターが要請応答送信ポートで構成されている場合、[One-Way] オプションを無効にします。
- [Command Type] メニューで、ストアドプロシージャを選択します。
- メニューからストアドプロシージャを選択し、インプットパラメータの値を入力します。
- ウィザードで表示される概要の設定を確認して[Finish] をクリックし、schema.xsd ファイルを作成します。
スキーマを処理する
BizTalk アプリでスキーマを使用する際は、こちらのチュートリアルをご覧ください。