Compartir a través de

Adaptador de Azure Blob Storage en BizTalk Server

A partir de BizTalk Server 2020 y versiones posteriores, puede enviar y recibir mensajes entre BizTalk Server y Azure Blob Storage.

Azure Blob Storage es la solución de almacenamiento de objetos de Microsoft para la nube, que está optimizada para almacenar grandes cantidades de datos no estructurados. Para más información, consulte ¿Qué es Azure Blob Storage?.

Prerrequisitos

Cree una cuenta de Azure Blob Storage con un contenedor.

Envío de mensajes a Azure Blob Storage

  1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos de envío>Nuevo>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 AzureBlobStorage y seleccione Configurar.

  3. Configure las propiedades de la cuenta de Azure .

    Sugerencia

    La ventana de configuración del adaptador puede rellenar automáticamente los recursos de Azure después de iniciar sesión en la suscripción de Azure. Esto facilita la configuración. Iniciar sesión en la suscripción de Azure es óptimo.

    • Inicio de sesión: inicie sesión en su cuenta de Azure.
    • Suscripción: seleccione la suscripción que tiene la cuenta de Azure Storage.
    • Grupo de recursos: seleccione el grupo de recursos que tiene la cuenta de Azure Storage.

  4. Configure las propiedades Generales :

    • Autenticación de almacenamiento: seleccione un método de autenticación:

      • La firma de acceso compartido está seleccionada de forma predeterminada. Debe escribir la cadena de conexión de Firma de Acceso Compartido en el campo Cadena de conexión.
      • Si usa claves de acceso, se rellena una colección de cuentas de almacenamiento en la lista desplegable Cuenta . Una vez que seleccione la cuenta de almacenamiento, el campo Cadena de conexión se rellena automáticamente con la clave de acceso principal, también conocida como key1.

      Los vínculos siguientes son buenos recursos para ayudarle a decidir qué método de autenticación es adecuado para su escenario:

    • Nombre del contenedor de blobs: seleccione el nombre del contenedor de blobs en la lista desplegable. La lista se rellena automáticamente después de escribir la cadena de conexión .

    • Nombre del blob: escriba el nombre del blob que usará el adaptador. Las macros se pueden usar en el nombre del blob. Para obtener macros disponibles, consulte Uso de macros en nombres de archivo.

    • Espacio de nombres para metadatos de blobs: Introduzca el espacio de nombres como filtro. Las propiedades de contexto del mensaje se escriben en los metadatos del blob si el espacio de nombres de la propiedad coincide con este campo.

    Cuando termine, las propiedades tienen un aspecto similar al siguiente:

    Propiedades generales del adaptador de envío de Azure Blob Storage en BizTalk Server

  5. Configure las propiedades avanzadas :

    • Tipo de blob: escriba el tipo de blob que se va a usar. Para más información, consulte Tipos de blobs.
    • Modo de escritura: use esta configuración para especificar el comportamiento del adaptador cuando ya exista un nombre de blob determinado.
      • Crear nuevo: el adaptador siempre intenta crear un nuevo blob. Si ya existe un blob con el mismo nombre, se suspende el mensaje de BizTalk.
      • Sobrescribir: el adaptador sobrescribe si el nombre del bloque ya existe. Los metadatos también se sobrescriben.
      • Anexar: el adaptador anexa el cuerpo del mensaje a un blob existente si ya existe un blob. Los metadatos no cambian.

  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 a Azure Blob Storage.

  1. Con el adaptador de archivo, cree un puerto de recepción denominado FileReceivePort. Dentro de la ubicación de recepción, establezca la carpeta de recepción en C:\Temp\In\\ y configure la máscara de archivo en \*.xml.

  2. En las propiedades de puerto de envío de Azure Blob Storage, establezca Filtros en BTS.ReceivePortName == FileReceivePort.

  3. Pegue lo siguiente en un editor de texto y guarde el archivo como AzureBlobStorageMessage.xml. Este archivo 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 de Azure Blob Storage.

  5. Copie el mensaje de ejemploAzureBlobStorageMessage.xml en la carpeta receive, como C:\Temp\In\. El puerto de envío envía el archivo XML al almacenamiento de blobs de Azure. Para confirmarlo, examine el contenedor de Azure Storage y vea el archivo recién creado o actualizado.

Recepción de mensajes de Azure Blob Storage

  1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos> de recepciónNuevos>One-Way puerto de recepción.

    La creación de 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 AzureBlobStorage en la lista desplegable Tipo . Seleccione Configurar.

  4. Configure las propiedades de la cuenta de Azure :

    Sugerencia

    Similar al adaptador de envío, esto es opcional.

    • Inicio de sesión: inicie sesión en su cuenta de Azure.
    • Suscripción: seleccione la suscripción que tiene la cuenta de Azure Storage.
    • Grupo de recursos: seleccione el grupo de recursos que tiene la cuenta de Azure Storage.

  5. Configure las propiedades Generales :

    • Autenticación de almacenamiento: seleccione un método de autenticación:

      • La firma de acceso compartido está seleccionada de forma predeterminada. Debe escribir la cadena de conexión de Firma de Acceso Compartido en el campo Cadena de conexión.
      • Si usa claves de acceso, se rellena una colección de cuentas de almacenamiento en la lista desplegable Cuenta . Una vez que seleccione la cuenta de almacenamiento, el campo Cadena de conexión se rellena automáticamente con la clave de acceso principal, también conocida como key1.

      Los vínculos siguientes son buenos recursos para ayudarle a decidir cuál es el adecuado para su escenario:

    • Nombre del contenedor de blobs: seleccione el nombre del contenedor de blobs en la lista desplegable. La lista se rellena automáticamente después de escribir la cadena de conexión .

    • Prefijo de nombre de blob: introduzca un prefijo cuando corresponda. Por ejemplo, si se usa "order/" como prefijo del nombre del blob, la ubicación de recepción solo procesa los archivos en la carpeta "order".

    • Espacio de nombres para metadatos de blobs: escriba un espacio de nombres para que el adaptador cree propiedades de contexto a partir de metadatos de blobs personalizados.

    • Promover propiedades de metadatos: elija si se promueven o no metadatos de blobs personalizados.

    Nota:

    De forma predeterminada, todas las propiedades estándar de Blob, como Uri, Nombre y TipoDeBlob, se establecen como propiedades de contexto del mensaje de BizTalk con el espacio de nombres http://schemas.microsoft.com/BizTalk/Adapter/AzureStorage-properties.

    Cuando termine, las propiedades tienen un aspecto similar al siguiente:

    Azure Blob Storage recibe propiedades generales del adaptador en BizTalk Server

  6. Configure las propiedades avanzadas :

    • Intervalo de sondeo: escriba el intervalo de sondeo.
    • Número máximo de mensajes por lote: escriba el número de mensajes que el adaptador agrupa al presentar a BizTalk.
    • Descargas paralelas: escriba el número máximo de blobs que se pueden descargar en paralelo.
    • Umbral de error: escriba el umbral de error. Cuando la ubicación de recepción alcanza este número de errores, la ubicación de recepción está deshabilitada.

  7. 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 Azure Blob Storage.

  1. Cree un puerto de envío mediante el adaptador de archivo. En las propiedades del puerto de envío, establezca la carpetaC:\Temp\Out\\Destino en y establezca el nombre%MessageID%.xmlde archivo y en .
  2. En las propiedades del puerto de envío de archivos, establezca Filtros en BTS.ReceivePortName == BlobReceivePort.
  3. Cree un puerto de recepción denominado BlobReceivePort y cree una ubicación de recepción de Azure Blob Storage. Inícialo.
  4. Cargue un archivo en el contenedor de blobs en Azure Portal. Preste atención al prefijo coincidente que configuró en el adaptador. Busque mensajes en la carpeta de destino (c:\temp\out).

Importante

El adaptador de recepción de Azure Blob Storage elimina el blob después de enviarlo a la base de datos de Cuadro de mensajes de BizTalk.

Alta disponibilidad del adaptador de Azure Blob Storage

El adaptador de recepción de Azure Blob Storage permite alta disponibilidad. Puede agregar varias instancias de host en el mismo controlador de recepción del adaptador de Azure Blob Storage para recibir desde el mismo contenedor de blobs simultáneamente. El arrendamiento de blobs se usa como bloqueo para evitar que varias instancias de host reciban el mismo blob. En consecuencia:

  • Los blobs arrendados por otros procesos no serán recibidos por el adaptador de Azure Blob Storage.
  • Los blobs recibidos por el adaptador de Azure Blob Storage no se pueden actualizar cuando están arrendados.

Para obtener más información sobre el alquiler de blobs de Azure, consulte simultaneidad pesimista para blobs.

El adaptador de envío de Azure Blob Storage, como la mayoría de los adaptadores de envío, proporciona alta disponibilidad para el host de envío al tener varias instancias de host en el mismo host de envío.

Pasos siguientes

Adaptadores en BizTalk Server