Adaptador del centro de eventos en BizTalk

Información general

A partir de BizTalk Server Feature Pack 2 de 2016, puede enviar y recibir mensajes entre BizTalk Server y Azure Event Hubs.

Azure Event Hubs es una plataforma de streaming de datos altamente escalable y puede recibir y procesar millones de eventos por segundo. ¿Qué es Event Hubs? proporciona más detalles.

Requisitos previos

• Creación de un espacio de nombres de Azure Event Hubs y un centro de eventos
• Creación de una cuenta de Azure Blob Storage con un contenedor
• Instale Feature Pack 2 en el BizTalk Server

Ya se ha creado el centro de eventos y cuenta con las cadenas de conexión que necesita para enviar y recibir eventos.

Envío de mensajes a Event Hubs

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 EventHub y seleccione Configurar.

3. Configure las propiedades de la cuenta de Azure :

   Use	Para hacer esto
   Inicio de sesión	Inicio de sesión en su cuenta de Azure
   Suscripción	Seleccione la suscripción que tiene el espacio de nombres de EventHubs.
   Grupo de recursos	Seleccione el grupo de recursos que tiene el espacio de nombres de EventHubs.

4. Configure las propiedades del punto de conexión :

   Use	Para hacer esto
   Espacio de nombres	Seleccione el espacio de nombres de Event Hubs, que es algo parecido a sb:// sueventhubnamespace.servicebus.windows.net/
   Nombre	Seleccione el nombre del centro de eventos (que se creó en el espacio de nombres de Event Hubs).
   Clave de partición predeterminada	Opcional. La guía de programación de Event Hubs proporciona más detalles sobre esta clave.
   Autenticación	La firma de acceso al espacio de nombres es la predeterminada y usa automáticamente rootManageSharedAccessKey que se crea al crear un espacio de nombres de Event Hubs. La firma de acceso a entidades es la directiva SAS que puede crear en el nivel de centro de eventos (no en el nivel de espacio de nombres de Event Hubs). Información general sobre las características de Event Hubs explica más.

   Cuando haya terminado, las propiedades serán similares a las siguientes:

   

5. Opcional. Configure las propiedades del mensaje . El valor Namespace for User Defined Message Properties (Espacio de nombres para propiedades de mensaje definidas por el usuario) representa el espacio de nombres de las propiedades de contexto asignadas a las propiedades del mensaje de Event Hubs. Esto se puede lograr mediante un esquema de propiedades.

6. Seleccione Aceptar para guardar los cambios.

Prueba del puerto de envío

Puede usar un puerto de recepción de archivos simple y una ubicación para enviar mensajes al centro de eventos de Azure.

1. Cree un puerto de recepción mediante el adaptador de archivo. Dentro de la ubicación de recepción, establezca la carpeta Receive en C:\Temp\In\y establezca la máscara de archivo en *.xml.

2. En las propiedades del puerto de envío del centro de eventos, establezca filtrosBTS.ReceivePortName == FileReceivePorten .

3. Pegue lo siguiente en un editor de texto y guarde el archivo como EventHubMessage.xml. Este es el mensaje de ejemplo.

   <Data>
     <DataID>DataID_0</DataID>
     <DataDetails>DataDetails_0</DataDetails>
   </Data>
   

4. Inicie la ubicación de recepción del archivo y el puerto de envío del centro de eventos.

5. Copie EventHubMessage.xml mensaje de ejemplo en la carpeta receive (C:\Temp\In). El puerto de envío envía el archivo XML al centro de eventos.

Recepción de mensajes de Event Hubs

1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos de recepción, seleccione Nuevo y seleccione Puerto de recepción unidireccional.

   Crear un puerto de recepción proporciona algunas instrucciones.

2. Escriba un nombre y seleccione Ubicaciones de recepción.

3. Seleccione Nuevo y Asigne el nombre a la ubicación de recepción. En Transporte, seleccione EventHub en la lista desplegable Tipo y, a continuación, seleccione Configurar.

4. Configure las propiedades de la cuenta de Azure :

   Use	Para hacer esto
   Inicio de sesión	Inicio de sesión en su cuenta de Azure
   Suscripción	Seleccione la suscripción que tiene el espacio de nombres de EventHubs.
   Grupo de recursos	Seleccione el grupo de recursos que tiene el espacio de nombres de EventHubs.

5. Configure las propiedades del punto de conexión :

   Use	Para hacer esto
   Espacio de nombres	Seleccione el espacio de nombres de Event Hubs, que es algo parecido a sb:// sueventhubnamespace.servicebus.windows.net/
   Nombre	Seleccione el nombre del centro de eventos (que se creó en el espacio de nombres de Event Hubs).
   Grupo de consumidores	Seleccione el grupo Consumidor en el centro de eventos. Se crea automáticamente un grupo predeterminado. Información general sobre las características de Event Hubs proporciona más detalles.
   Autenticación	La firma de acceso al espacio de nombres es la predeterminada y usa automáticamente rootManageSharedAccessKey que se crea al crear un espacio de nombres de Event Hubs. La firma de acceso a entidades es la directiva SAS que puede crear en el nivel de centro de eventos (no en el nivel de espacio de nombres de Event Hubs). Información general sobre las características de Event Hubs explica más.

   Cuando haya terminado, las propiedades serán similares a las siguientes:

   

6. Configure las propiedades del punto de control . Este adaptador usa una cuenta de Azure Blob Storage para leer eventos de forma confiable mediante un punto de control y reanudar desde un reinicio.

   Autenticación de almacenamiento
   Seleccione un método de autenticación. Normalmente, se recomienda usar una firma de acceso compartido. Los vínculos siguientes son buenos recursos para ayudarle a decidir cuál es el adecuado para su escenario:
   
   Acerca de las cuentas de almacenamiento de Azure
   Uso de Firmas de acceso compartido (SAS)

   Cuando haya terminado, las propiedades serán similares a las siguientes:

   

7. Configure las propiedades del mensaje :

   Use	Para hacer esto
   Espacio de nombres para las propiedades de mensaje definidas por el usuario	http://schemas.microsoft.com/BizTalk/EventHubAdapter/EventData/User es el esquema predeterminado, pero puede escribir otro esquema. Este valor representa un esquema de mensajes de BizTalk asignado a las propiedades del mensaje de Event Hubs.
   Promoción de propiedades definidas por el usuario	Opcional. Si lo prefiere, puede promover estas propiedades. NOTA: Las propiedades que deben promoverse deben tener implementado un esquema de propiedades antes de recibir eventos.

8. Seleccione Aceptar para guardar los cambios.

Prueba de la configuración de recepción

Puede usar un puerto de envío de archivos simple para recibir mensajes de Su centro de eventos de Azure.

1. Cree un puerto de envío mediante el adaptador de archivo. Dentro de las propiedades del puerto de envío, establezca la carpeta Destino en C:\Temp\Out\y establezca el nombre de archivo y en %MessageID%.xml.
2. En las propiedades del puerto de envío de archivos, establezca filtrosBTS.ReceivePortName == EHReceivePorten .
3. Inicie la ubicación de recepción del centro de eventos y el puerto de envío de archivos.
4. Busque mensajes en la carpeta de destino (c:\temp\out).

Hacer más

Event Hubs se considera la "puerta principal" a muchos otros servicios de Azure, como Azure Data Lake, HD Insight, etc. Está diseñado para procesar una gran cantidad de mensajes y procesarlos rápidamente. Obtenga más información sobre Event Hubs y sus características:

Información general de las características de Event Hubs
¿Qué es Event Hubs?