SB-Messaging 어댑터

아티클
07/21/2023

Service Bus(SB-Messaging) 어댑터는 큐, 토픽 및 릴레이와 같은 Service Bus 엔터티를 받고 보내는 데 사용됩니다. SB 메시징 어댑터를 사용하여 온-프레미스 BizTalk Server Azure에 연결할 수 있습니다.

BizTalk Server 2016 기능 팩 2부터 Service Bus Premium이 지원됩니다. 이 어댑터를 사용하여 송신 포트를 구성할 때 분할된 큐에 메시지를 보내고 topics 수 있습니다.

중요

BizTalk SB-Messaging 어댑터는 최대 1mb 크기의 메시지를 지원하는 SBMP 프로토콜을 사용합니다. BizTalk 어댑터는 더 큰 메시지를 처리할 수 있는 AMQP 프로토콜을 지원하지 않습니다.

Service Bus를 사용하여 인증

Service Bus는 인증하는 두 가지 방법을 제공합니다.

ACS(액세스 제어 서비스)
공유 액세스 서명(SAS)

SAS(공유 액세스 서명)를 사용하여 Service Bus로 인증하는 것이 좋습니다. 공유 액세스 키 값은 Azure Portal 나열됩니다.

Service Bus 네임스페이스를 만들 때 ACS(Access Control) 네임스페이스는 자동으로 만들어지지 않습니다. Access Control 사용하려면 이 네임스페이스의 발급자 이름 및 발급자 키 값이 필요합니다. 이러한 값은 Windows PowerShell 사용하여 새 ACS 네임스페이스를 만들 때 사용할 수 있습니다. 이러한 값은 Azure Portal 나열되지 않습니다.

인증을 위해 ACS를 사용하고 발급자 이름 및 발급자 키 값을 가져오는 전체 단계는 다음과 같습니다.

Azure PowerShell cmdlet을 설치합니다.
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 그룹을 확장하고 애플리케이션을 확장한 다음 애플리케이션을 확장합니다.
수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 단방향 수신 포트를 선택합니다.
이름을 지정하고 수신 위치를 선택합니다.
새로 만들기를 선택하고 이름을 지정합니다. 전송 섹션의 유형 드롭다운 목록에서 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 세션을 사용하여 큐나 구독의 메시지를 받을 수 있습니다.

인증 속성을 구성합니다.

사용 항목 원하는 작업

Access Control 서비스 ACS를 사용하여 인증하려면 이를 선택하고 다음 값을 제공합니다.

- Service Bus Access Control Service STS URI를 입력합니다. 일반적으로 URI에는 다음과 같은 형식이 사용됩니다.

https://<namespace>-sb.accesscontrol.windows.net/

- Service Bus 네임스페이스의 발급자 이름을 입력합니다.

- Service Bus 네임스페이스의 발급자 키를 입력합니다.

공유 액세스 서명(BizTalk Server 2013 R2부터 새로운 기능) SAS(공유 액세스 서명)를 사용하여 인증하려면 이를 선택하고 SAS 키 이름 및 키 값을 제공합니다.

속성 탭의 조정된 메시지 속성에 대한 네임스페이스에서 어댑터가 조정된 메시지 속성을 BizTalk Server 받은 메시지의 메시지 컨텍스트 속성으로 작성하는 데 사용하는 네임스페이스를 입력합니다. 조정된 메시지 속성을 승격하려면 조정된 메시지 속성 승격 검사 상자를 선택합니다.
확인을 선택합니다.
수신 처리기와 수신파이프라인을 선택합니다. 확인을 선택하여 변경 내용을 저장합니다. 수신 위치 만들기는 몇 가지 지침을 제공합니다.

사용 항목	원하는 작업
Access Control 서비스	ACS를 사용하여 인증하려면 이를 선택하고 다음 값을 제공합니다. - Service Bus Access Control Service STS URI를 입력합니다. 일반적으로 URI에는 다음과 같은 형식이 사용됩니다. `https://<namespace>-sb.accesscontrol.windows.net/` - Service Bus 네임스페이스의 발급자 이름을 입력합니다. - Service Bus 네임스페이스의 발급자 키를 입력합니다.
공유 액세스 서명(BizTalk Server 2013 R2부터 새로운 기능)	SAS(공유 액세스 서명)를 사용하여 인증하려면 이를 선택하고 SAS 키 이름 및 키 값을 제공합니다.

Service Bus에 메시지 보내기

BizTalk Server 관리 콘솔에서 포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 정적 단방향 송신 포트를 선택합니다.

송신 포트 만들기는 몇 가지 지침을 제공합니다.
이름을 입력합니다. 전송에서 형식을 SB 메시징으로 설정하고 구성을 선택합니다.