Adaptador del centro de eventos de BizTalkEvent Hub adapter in BizTalk

Información generalOverview

A partir de BizTalk Server 2016BizTalk Server 2016 Feature Pack 2, puede enviar y recibir mensajes entre BizTalk Server y Azure Event Hubs.Starting with BizTalk Server 2016BizTalk Server 2016 Feature Pack 2, you can send and receive messages between BizTalk Server and Azure Event Hubs.

Azure Event Hubs es una plataforma, de streaming de datos altamente escalables y puede recibir y procesar millones de eventos por segundo.Azure Event Hubs is a highly scalable data streaming platform, and can receive and process millions of events per second. ¿Qué es Event Hubs? proporciona más detalles.What is Event Hubs? provides more details.

Requisitos previosPrerequisites

Ya se ha creado el centro de eventos y tiene las cadenas de conexión que necesita para enviar y recibir eventos.Your event hub is now created, and you have the connection strings you need to send and receive events.

Enviar mensajes a Event HubsSend messages to Event Hubs

  1. En la consola de administración de BizTalk Server, haga clic en puertos de envío, seleccione Newy seleccione puerto de envío unidireccional estático.In the BizTalk Server Administration console, right-click Send Ports, select New, and select Static One-way send port.

    Crear un puerto de envío proporciona alguna orientación.Create a Send Port provides some guidance.

  2. Escriba un nombre.Enter a Name. En transporte, establezca el tipo a EventHuby seleccione configurar.In Transport, set the Type to EventHub, and select Configure.

  3. Configurar la cuenta de Azure propiedades:Configure the Azure Account properties:

    UseUse this ParaTo do this
    Inicio de sesiónSign-in Inicie sesión en su cuenta de AzureSign into your Azure account
    SuscripciónSubscription Seleccione la suscripción que tiene el espacio de nombres de Event hubsSelect the subscription that has your EventHubs namespace
    Grupo de recursosResource Group Seleccione el grupo de recursos que tiene el espacio de nombres de Event hubsSelect your resource group that has your EventHubs namespace
  4. Configurar la extremo propiedades:Configure the Endpoint properties:

    UseUse this ParaTo do this
    Espacio de nombresNamespace Seleccione el espacio de nombres de Event Hubs, que es algo parecido a sb: / /youreventhubnamespace.servicebus.windows.net/Select your Event Hubs namespace, which is something like sb://youreventhubnamespace.servicebus.windows.net/
    NombreName Seleccione el nombre del centro de eventos (que se creó en el espacio de nombres de Event Hubs)Select the name of your Event Hub (which was created within your Event Hubs namespace)
    Clave de partición predeterminadoDefault Partition Key Opcional.Optional. Guía de programación de Event Hubs proporciona más detalles sobre esta clave.Event Hubs programming guide provides more details on this key.
    AutenticaciónAuthentication Firma de acceso de Namespace es el valor predeterminado y usa automáticamente el RootManageSharedAccessKey que se crea cuando se crea un espacio de nombres de Event Hubs.Namespace Access Signature is the default, and automatically uses the RootManageSharedAccessKey that's created when you create an Event Hubs namespace.

    Firma de acceso de la entidad es la directiva SAS puede crear en el Event Hub-nivel (no los Event Hubs espacio de nombres-).Entity Access Signature is the SAS policy you can create at the Event Hub-level (not the Event Hubs namespace-level).

    Información general de las características de Event Hubs se explica más información.Event Hubs features overview explains more.

    Cuando termine, las propiedades de aspecto similares al siguiente:When finished, your properties look similar to the following:

    Propiedades de punto de conexión

  5. Opcional.Optional. Configurar la mensaje propiedades.Configure the Message properties. El Namespace para propiedades de mensaje definidas por el usuario valor representa un esquema de mensaje de BizTalk asignado a propiedades de mensajes de Event Hubs.The Namespace for User Defined Message Properties value represents a BizTalk message schema mapped to Event Hubs message properties.

  6. Seleccione Aceptar para guardar los cambios.Select Ok to save your changes.

Probar el puerto de envíoTest your send port

Puede usar un simple archivo de puerto de recepción y ubicación para enviar mensajes al centro de eventos de Azure.You can use a simple File receive port and location to send messages to your Azure Event Hub.

  1. Crear un puerto de recepción mediante el adaptador de archivo.Create a receive port using the File adapter. Dentro de la ubicación de recepción, establezca la carpeta recepción a C:\Temp\In\ y establece la máscara de archivo en *.xml.Within your receive location, set the Receive folder to C:\Temp\In\, and set the file mask to *.xml.

  2. En el centro de eventos propiedades de puerto de envío, establezca el filtros a BTS.ReceivePortName == FileReceivePort.In your Event Hub send port properties, set the Filters to BTS.ReceivePortName == FileReceivePort.

  3. Pegue lo siguiente en un editor de texto y guarde el archivo como EventHubMessage.xml.Paste the following into a text editor, and save the file as EventHubMessage.xml. Este es el mensaje de ejemplo.This is your sample message.

    <Data>
      <DataID>DataID_0</DataID>
      <DataDetails>DataDetails_0</DataDetails>
    </Data>
    
  4. Iniciar el archivo de ubicación de recepción y el puerto de envío del centro de eventos.Start the File receive location and the Event Hub send port.

  5. Copia EventHubMessage.xml mensaje de ejemplo en la carpeta de recepción (C:\Temp\In).Copy EventHubMessage.xml sample message into the receive folder (C:\Temp\In). El puerto de envío envía el archivo XML al centro de eventos.The send port sends the XML file to the event hub.

Recibir mensajes desde Event HubsReceive messages from Event Hubs

  1. En la consola de administración de BizTalk Server, haga clic en puertos de recepción, seleccione Newy seleccione unidireccional puerto de recepción.In the BizTalk Server Administration console, right-click Receive Ports, select New, and select One-Way receive port.

    Crear un puerto de recepción proporciona alguna orientación.Create a receive port provides some guidance.

  2. Escriba un nombre y seleccione ubicaciones de recepción.Enter a name, and select Receive Locations.

  3. Seleccione New, y nombre la ubicación de recepción.Select New, and Name the receive location. En transporte, seleccione EventHub desde el tipo lista desplegable y, a continuación, seleccione configurar.In Transport, select EventHub from the Type drop-down list, and then select Configure.

  4. Configurar la cuenta de Azure propiedades:Configure the Azure Account properties:

    UseUse this ParaTo do this
    Inicio de sesiónSign-in Inicie sesión en su cuenta de AzureSign into your Azure account
    SuscripciónSubscription Seleccione la suscripción que tiene el espacio de nombres de Event hubsSelect the subscription that has your EventHubs namespace
    Grupo de recursosResource Group Seleccione el grupo de recursos que tiene el espacio de nombres de Event hubsSelect your resource group that has your EventHubs namespace
  5. Configurar la extremo propiedades:Configure the Endpoint properties:

    UseUse this ParaTo do this
    Espacio de nombresNamespace Seleccione el espacio de nombres de Event Hubs, que es algo parecido a sb: / /youreventhubnamespace.servicebus.windows.net/Select your Event Hubs namespace, which is something like sb://youreventhubnamespace.servicebus.windows.net/
    NombreName Seleccione el nombre del centro de eventos (que se creó en el espacio de nombres de Event Hubs)Select the name of your Event Hub (which was created within your Event Hubs namespace)
    Grupo de consumidoresConsumer Group Seleccione el grupo de consumidores dentro de su centro de eventos.Select the Consumer group within your Event Hub. Se crea automáticamente un grupo de forma predeterminada.A default group is created automatically.

    Información general de las características de Event Hubs proporciona más detalles.Event Hubs features overview provides more details.
    AutenticaciónAuthentication Firma de acceso de Namespace es el valor predeterminado y usa automáticamente el RootManageSharedAccessKey que se crea cuando se crea un espacio de nombres de Event Hubs.Namespace Access Signature is the default, and automatically uses the RootManageSharedAccessKey that's created when you create an Event Hubs namespace.

    Firma de acceso de la entidad es la directiva SAS puede crear en el Event Hub-nivel (no los Event Hubs espacio de nombres-).Entity Access Signature is the SAS policy you can create at the Event Hub-level (not the Event Hubs namespace-level).

    Información general de las características de Event Hubs se explica más información.Event Hubs features overview explains more.

    Cuando termine, las propiedades de aspecto similares al siguiente:When finished, your properties look similar to the following:

    Propiedades de punto de conexión

  6. Configurar la Checkpoint propiedades.Configure the Checkpoint properties. Este adaptador usa una cuenta de almacenamiento de blobs de Azure para leer con un punto de control de eventos confiable y reanudar a partir de un reinicio.This adapter uses an Azure blob storage account to reliably read events using a checkpoint, and resume from a restart.

    Autenticación de almacenamiento Storage Authentication
    Seleccione un método de autenticación.Select an authentication method. Normalmente, se recomienda para usar una firma de acceso compartido.Typically, it's recommended to use a Shared Access Signature. Los siguientes vínculos son buenos recursos para ayudarle a decidir cuál es la adecuada para su escenario:The following links are good resources to help you decide which is right for your scenario:

    Acerca de las cuentas de almacenamiento de AzureAbout Azure storage accounts
    Uso de firmas de acceso compartido (SAS)Using shared access signatures (SAS)

    Cuando termine, las propiedades de aspecto similares al siguiente:When finished, your properties look similar to the following:

    Propiedades de punto de control

  7. Configurar la mensaje propiedades:Configure the Message properties:

    UseUse this ParaTo do this
    Namespace para el usuario define las propiedades de mensajeNamespace for User Defined Message Properties http://schemas.microsoft.com/BizTalk/EventHubAdapter/EventData/User es el esquema predeterminado, pero puede escribir otro esquema.http://schemas.microsoft.com/BizTalk/EventHubAdapter/EventData/User is the default schema, but you can enter another schema. Este valor representa un esquema de mensaje de BizTalk asignado a propiedades de mensajes de Event Hubs.This value represents a BizTalk message schema mapped to Event Hubs message properties.
    Promocionar propiedades definidas por el usuarioPromote user defined properties Opcional.Optional. Si lo prefiere puede promocionar estas propiedades.You can promote these properties if you prefer.

    NOTANOTE
    Las propiedades que deben promocionarse deben tener un esquema porperty implementado antes recibir eventos.The properties that need to be promoted should have a porperty schema deployed before receiving events.
  8. Seleccione Aceptar para guardar los cambios.Select Ok to save your changes.

Prueba la configuración de recepciónTest your receive settings

Puede usar un puerto de envío de archivos simple para recibir mensajes desde el centro de eventos de Azure.You can use a simple File send port to receive messages from your Azure Event Hub.

  1. Crear un puerto de envío mediante el adaptador de archivo.Create a send port using the File adapter. Dentro de las propiedades de puerto de envío, establezca el carpeta de destino a C:\Temp\Out\ y establezca el y nombre de archivo a %MessageID%.xml .Within your send port properties, set the Destination folder to C:\Temp\Out\, and set the and File name to %MessageID%.xml.
  2. En el archivo de propiedades de puerto de envío, establezca el filtros a BTS.ReceivePortName == EHReceivePort.In your File send port properties, set the Filters to BTS.ReceivePortName == EHReceivePort.
  3. El centro de eventos de inicio ubicación de recepción y el puerto de envío de archivo.Start the Event Hub receive location and the File send port.
  4. Buscar mensajes en la carpeta de destino (c:\temp\out).Look for messages in the destination folder (c:\temp\out).

Hacer más cosasDo more

Event Hubs se considera la "puerta principal" para muchos otros servicios de Azure, incluido Azure Data Lake, HD Insight y mucho más.Event Hubs is considered the "front door" to a lot of other Azure services, including Azure Data Lake, HD Insight, and more. Se ha diseñado para procesar un lote de mensajes y procesarlos rápida.It's designed to process a lot of messages, and process them fast. Más información acerca de Event Hubs y sus características:Read more about Event Hubs, and its features:

Información general de las características de Event HubsEvent Hubs features overview
¿Qué es Event Hubs?What is Event Hubs?