Service Bus (SB-Messaging) アダプターは、キュー、トピック、リレーなどの Service Bus エンティティの受信と送信に使用されます。 SB メッセージング アダプターを使用して、オンプレミスの BizTalk Server を Azure に接続できます。
BizTalk Server 2016 Feature Pack 2 以降では、Service Bus Premium がサポートされています。 このアダプターを使用して送信ポートを構成する場合は、パーティション分割されたキューとトピックにメッセージを送信できます。
Von Bedeutung
BizTalk SB-Messaging アダプターは、最大サイズ 1 mb までのメッセージをサポートする SBMP プロトコルを使用します。 BizTalk アダプターは、大きなメッセージを処理できる AMQP プロトコルをサポートしていません。
Service Bus を使用した認証
Service Bus には、次の 2 つの認証方法があります。
- Access Control Service (ACS)
- Shared Access Signature (SAS)
Shared Access Signature (SAS) を使用して Service Bus で認証することをお勧めします。 共有アクセス キーの値は、 Azure portal に一覧表示されます。
Service Bus 名前空間を作成すると、アクセス制御 (ACS) 名前空間は自動的には作成されません。 アクセス制御を使用するには、この名前空間の発行者名と発行者キーの値が必要です。 これらの値は、Windows PowerShell を使用して新しい ACS 名前空間を作成するときに使用できます。 これらの値は、Azure portal には表示されません。
認証に ACS を使用し、発行者名と発行者キーの値を取得するには、全体的な手順を次に示します。
Azure アカウントを追加します。
Add-AzureAccountサブスクリプション名を返します。
get-azuresubscriptionサブスクリプションを選択します。
select-azuresubscription <name of your subscription>新しい名前空間を作成します。
new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging例:
new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging新しい ACS 名前空間が作成されると (数分かかる場合があります)、IssuerName と IssuerKey の値が接続文字列に一覧表示されます。
注意事項
この例またはガイダンスでは、接続文字列やユーザー名とパスワードなどの機密情報を参照します。 これらの値をコードにハードコーディングしないでください。また、使用可能な最も安全な認証を使用して機密データを保護してください。 詳しくは、次のドキュメントをご覧ください。
Name : biztalksbnamespace Region : South Central US DefaultKey : abcdefghijklmnopqrstuvwxyz Status : Active CreatedAt : 10/18/2016 9:36:30 PM AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/ ServiceBusEndpoint : https://biztalksbnamespace.servicebus.windows.net/ ConnectionString : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz NamespaceType : Messaging
ガイダンスについては 、New-AzureSBNamespace を参照してください。
Service Bus からメッセージを受信する
BizTalk Server 管理コンソールで、 BizTalk グループを展開し、[ アプリケーション] を展開して、アプリケーションを展開します。
[ 受信ポート] を右クリックし、[ 新規] を選択し、[ 受信ポートOne-Way 選択します。
名前を付け、[ 受信場所] を選択します。
[ 新規] を選択し、[ 名前] を付けます。 [トランスポート] セクションで、[種類] ドロップダウン リストから [SB-Messaging] を選択し、[構成] を選択します。
[全般] プロパティを構成します。
これを使用する 目的 キューまたはサブスクリプションの URL Service Bus キューをデプロイする URL を指定します。 通常、URL の形式は次のとおりです。
sb://<namespace>.servicebus.windows.net/<queue_name>オープン タイムアウト チャネルを開く操作が完了するまでの時間を示す期間値を指定します。
既定値: 1 分タイムアウトを閉じる チャネル閉じる操作が完了するまでの時間を示す期間値を指定します。
既定値: 1 分受信タイムアウト 受信操作が完了するまでの時間を示す期間値を指定します。
既定値: 10 分プリフェッチ数 Service Bus キューまたはトピックから同時に受信するメッセージの数を指定します。 プリフェッチを使用すると、キューまたはサブスクリプション クライアントが受信操作を実行するときに、サービスから追加のメッセージを読み込むことができます。 クライアントはこれらのメッセージをローカル キャッシュに格納します。 キャッシュのサイズは、ここで指定するプリフェッチカウントプロパティの値によって決まります。
詳細については、以下の「プリフェッチ」セクションを参照してください。 https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/
既定値: -1セッションの使用 Service Bus セッションを使用してキューまたはサブスクリプションからメッセージを受信するには、このチェック ボックスをオンにします。 認証プロパティを構成します。
これを使用する 目的 アクセス制御サービス 認証に ACS を使用し、次の値を指定するには、これを選択します。
- Service Bus アクセス制御サービス STS URI を入力します。 通常、URI の形式は次のとおりです。
https://<namespace>-sb.accesscontrol.windows.net/
- Service Bus 名前空間の発行者名を入力します。
- Service Bus 名前空間の発行者キーを入力します。Shared Access Signature (BizTalk Server 2013 R2 以降の新機能) 認証に Shared Access Signature (SAS) を使用し、SAS キー名とキー値を指定するには、これを選択します。 [ プロパティ ] タブの [ 仲介型メッセージのプロパティの名前空間] に、BizTalk Server で受信したメッセージのメッセージ コンテキスト プロパティとしてブローカー メッセージプロパティを書き込む際にアダプターが使用する名前空間を入力します。 ブローカー メッセージのプロパティを昇格する場合は、[ ブローカー メッセージのプロパティの昇格 ] チェック ボックスをオンにします。
[OK] を選択.
受信ハンドラーと受信パイプラインを選択します。 [OK] を選択して変更を保存します。 受信場所を作成すると、 いくつかのガイダンスが提供されます。
Service Bus にメッセージを送信する
BizTalk Server 管理コンソールで、[ 送信ポート] を右クリックし、[ 新規] を選択して、[ 静的一方向送信ポート] を選択します。
送信ポートを作成すると、 いくつかのガイダンスが提供されます。
名前を入力します。 [トランスポート] で、[種類] を [SB-Messaging] に設定し、[構成] を選択します。
[全般] プロパティを構成します。
これを使用する 目的 宛先 URL Service Bus キューがデプロイされる URL を入力します。 通常、URL の形式は次のとおりです。
sb://<namespace>.servicebus.windows.net/<queue_name>バッチ フラッシュ間隔 キューまたはトピックに送信されるメッセージ バッチがフラッシュされる間隔を示す期間値を指定します。 既定値は 20 ミリ秒です。
Service Bus キューとトピックに関するバッチ処理の詳細については、https://azure.microsoft.com/documentation/articles/service-bus-performance-improvementsの「クライアント側のバッチ処理」セクションを参照してください。オープン タイムアウト チャネルを開く操作が完了するまでの時間を示す期間値を指定します。
既定値: 1 分送信タイムアウト 送信操作が完了するまでの時間を示す期間値を指定します。
既定値: 1 分タイムアウトを閉じる チャネル閉じる操作が完了するまでの時間を示す期間値を指定します。
既定値: 1 分認証プロパティを構成します。
これを使用する 目的 アクセス制御サービス 認証に ACS を使用し、次の値を指定するには、これを選択します。
- Service Bus アクセス制御サービス STS URI を入力します。 通常、URI の形式は次のとおりです。
https://<namespace>-sb.accesscontrol.windows.net/
- Service Bus 名前空間の発行者名を入力します。
- Service Bus 名前空間の発行者キーを入力します。Shared Access Signature (BizTalk Server 2013 R2 以降の新機能) 認証に Shared Access Signature (SAS) を使用し、SAS キー名とキー値を指定するには、これを選択します。 [ プロパティ ] タブで、Service Bus への送信メッセージに書き込む BizTalk メッセージ コンテキスト プロパティを含む 、ユーザー定義のブローカー メッセージ プロパティの名前空間 を入力します。 すべての名前空間プロパティは、ユーザー定義のブローカー メッセージ プロパティとしてメッセージに書き込まれます。 アダプターは、ブローカー メッセージのプロパティとしてプロパティを書き込むときに名前空間を無視します。 名前空間は、書き込むプロパティを確認するためにのみ使用されます。
BrokeredMessage プロパティの値を入力することもできます。 これらのプロパティは、パーティション キーを含む BrokeredMessage プロパティで説明されています。
[OK] を選択して変更を保存します。