Adaptador SB-Messaging

  • Artículo

El adaptador de Service Bus (SB-Messaging) se usa para recibir y enviar desde entidades de Service Bus, como colas, temas y retransmisiones. Puede usar el adaptador sb-messaging para conectar el BizTalk Server local a Azure.

A partir de BizTalk Server Feature Pack 2 de 2016, se admite Service Bus Premium. Al configurar un puerto de envío mediante este adaptador, puede enviar mensajes a colas y temas con particiones.

Importante

El adaptador de SB-Messaging de BizTalk usa el protocolo SBMP que admite mensajes de hasta un tamaño máximo de 1 mb. El adaptador de BizTalk no admite el protocolo AMQP que puede controlar mensajes más grandes.

Autenticación con Service Bus

Service Bus proporciona dos métodos para autenticarse:

  • Access Control Service (ACS)
  • Firma de acceso compartido (SAS)

Se recomienda usar la firma de acceso compartido (SAS) para autenticarse con Service Bus. El valor de clave de acceso compartido se muestra en el Azure Portal.

Al crear un espacio de nombres de Service Bus, el espacio de nombres Access Control (ACS) no se crea automáticamente. Para usar Access Control, necesita los valores Nombre del emisor y Clave del emisor de este espacio de nombres. Estos valores están disponibles al crear un nuevo espacio de nombres de ACS mediante Windows PowerShell. Estos valores no aparecen en el Azure Portal.

Para usar ACS para la autenticación y obtener los valores de Nombre de emisor y Clave de emisor, los pasos generales son:

  1. Instale los cmdlets de Azure PowerShell.

  2. Agregue su cuenta de Azure: Add-AzureAccount

  3. Devuelva el nombre de su suscripción: get-azuresubscription

  4. Seleccione su suscripción: select-azuresubscription <name of your subscription>

  5. Creación de un espacio de nombres nuevo: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

    Ejemplo: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

  6. Cuando se crea el nuevo espacio de nombres de ACS (que puede tardar varios minutos), los valores IssuerName y IssuerKey se enumeran en el cadena de conexión:

    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

Consulte New-AzureSBNamespace para obtener instrucciones.

Recepción de mensajes de Service Bus

  1. En la consola de administración de BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación.

  2. Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevo y seleccione Puerto de recepción unidireccional.

  3. Asígnele un nombre y seleccione Ubicaciones de recepción.

  4. Seleccione Nuevo, asígnele un nombre. En la sección Transporte , seleccione SB-Messaging en la lista desplegable Tipo y, a continuación, seleccione Configurar.

  5. Configure las propiedades Generales :

    Use Para hacer esto
    Dirección URL de la cola o la suscripción Especifique la dirección URL en la que se implementa la cola de Service Bus. Normalmente, la dirección URL tiene el siguiente formato:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Tiempo de espera de apertura Especifica un valor de marco temporal que indica el tiempo para que se complete una operación de apertura del canal.

    Valor predeterminado: 1 minuto
    Tiempo de espera de cierre Especifica un valor de marco temporal que indica el tiempo para que se complete una operación de cierre del canal.

    Valor predeterminado: 1 minuto
    Tiempo de espera de recepción Especifica un valor de marco temporal que indica el tiempo para que se complete una operación de recepción.

    Valor predeterminado: 10 minutos
    Recuento de capturas previas Especifica el número de mensajes que se reciben de forma simultánea de la cola o de un tema de Service Bus. La captura previa permite que el cliente de cola o suscripción cargue más mensajes desde el servicio cuando realice una operación de recepción. El cliente almacena estos mensajes en una memoria caché local. El tamaño de la caché está determinado por el valor de la propiedad de recuento de captura previa que especifique aquí.

    Para obtener más información, consulte la sección "Prefetching" (Captura previa) en . https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/

    Valor predeterminado: -1
    Usar sesión Active esta casilla para usar una sesión de Service Bus para recibir mensajes de una cola o una suscripción.

  6. Configure las propiedades de autenticación :

    Use Para hacer esto
    servicio de Access Control Seleccione esta opción para usar ACS para la autenticación y proporcione los valores siguientes:

    : escriba el URI de STS de service Access Control Service. Normalmente, el URI tiene el siguiente formato:

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

    : escriba el nombre del emisor para el espacio de nombres de Service Bus.

    : escriba la clave del emisor para el espacio de nombres de Service Bus.
    Firma de acceso compartido (nueva a partir de BizTalk Server 2013 R2) Seleccione esta opción para usar la autenticación con Firma de acceso compartido (SAS) y proporcione el nombre y el valor de la clave SAS.

  7. En la pestaña Propiedades, en el espacio de nombres de propiedades de mensaje asincrónico, escriba el espacio de nombres que usa el adaptador para escribir las propiedades de mensaje asincrónicas como propiedades de contexto de mensaje en el mensaje recibido por BizTalk Server. Si desea promover las propiedades del mensaje asincrónica, active la casilla Promover propiedades de mensaje asincrónicas .

  8. Seleccione Aceptar.

  9. Seleccione el controlador de recepción y la canalización De recepción. Seleccione Aceptar para guardar los cambios. Crear una ubicación de recepción proporciona algunas instrucciones.

Envío de mensajes a Service Bus

  1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos de envío, seleccione Nuevo y seleccione Puerto de envío unidireccional estático.

    Crear un puerto de envío proporciona algunas instrucciones.

  2. Escriba un nombre. En Transporte, establezca El tipo en SB-Messaging y seleccione Configurar.

  3. Configure las propiedades Generales :

    Use Para hacer esto
    Dirección URL de destino Escriba la dirección URL donde se implementa la cola de Service Bus. Normalmente, la dirección URL tiene el siguiente formato:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Intervalo de vaciado de lote Especifica un valor de intervalo de tiempo que indica el intervalo en el que se vacían los lotes de mensajes que se envían a una cola o tema. El valor predeterminado es 20 milisegundos.

    Para obtener más información sobre el procesamiento por lotes con respecto a las colas y los temas de Service Bus, consulte la sección Procesamiento por lotes del lado cliente en https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
    Tiempo de espera de apertura Especifica un valor de marco temporal que indica el tiempo para que se complete una operación de apertura del canal.

    Valor predeterminado: 1 minuto
    Tiempo de espera de envío Especifica un valor de marco temporal que indica el tiempo para que se complete una operación de envío.

    Valor predeterminado: 1 minuto
    Tiempo de espera de cierre Especifica un valor de marco temporal que indica el tiempo para que se complete una operación de cierre del canal.

    Valor predeterminado: 1 minuto

  4. Configure las propiedades de autenticación :

    Use Para hacer esto
    servicio Access Control Seleccione esta opción para usar ACS para la autenticación y proporcione los valores siguientes:

    : escriba el URI de STS del servicio Access Control Service. Normalmente, el URI tiene el siguiente formato:

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

    : escriba el nombre del emisor para el espacio de nombres de Service Bus.

    : escriba la clave del emisor para el espacio de nombres de Service Bus.
    Firma de acceso compartido (nueva a partir de BizTalk Server 2013 R2) Seleccione esta opción para usar la autenticación con Firma de acceso compartido (SAS) y proporcione el nombre y el valor de la clave SAS.

  5. En la pestaña Propiedades , escriba el espacio de nombres para las propiedades de mensaje asincrónicas definidas por el usuario que contiene las propiedades de contexto del mensaje de BizTalk que desea escribir en el mensaje saliente en Service Bus. Todas las propiedades del espacio de nombres se escriben en el mensaje como propiedades de mensaje asincrónicas definidas por el usuario. El adaptador ignora el espacio de nombres al escribir las propiedades como propiedades de mensajes desacoplados. Usa el espacio de nombres solo para confirmar qué propiedades escribir.

    También puede escribir los valores de las propiedades BrokeredMessage. Estas propiedades se describen en Propiedades de BrokeredMessage, incluida la clave de partición.

  6. Seleccione Aceptar para guardar los cambios.

Consulte también

Uso de adaptadores