Adaptateur de stockage Blob Azure dans BizTalk Server

Article
10/14/2023

À compter de BizTalk Server 2020 et versions ultérieures, vous pouvez envoyer et recevoir des messages entre BizTalk Server et stockage Blob Azure.

Stockage Blob Azure est la solution de stockage d’objets de Microsoft pour le cloud, qui est optimisée pour le stockage de quantités massives de données non structurées. Pour plus d’informations, consultez Qu’est-ce que le stockage Blob Azure ?.

Prérequis

Créez un compte de stockage d’objets blob Azure avec un conteneur.

Envoyer des messages au Stockage Blob Azure

Dans la console Administration BizTalk Server, cliquez avec le bouton droit sur Envoyerles nouveaux>ports>statiques port d’envoi unidirectionnel.

Créer un port d’envoi fournit des conseils.
Saisissez un Nom. Dans Transport, définissez type sur AzureBlobStorage, puis sélectionnez Configurer.
Configurez les propriétés du compte Azure .

Conseil

La fenêtre de configuration de l’adaptateur peut remplir automatiquement vos ressources Azure après la connexion à votre abonnement Azure. Cela facilite la configuration. La connexion à l’abonnement Azure est optimale.
- Connexion : connectez-vous à votre compte Azure.
- Abonnement : sélectionnez l’abonnement qui contient votre compte de stockage Azure.
- Groupe de ressources : sélectionnez le groupe de ressources qui contient votre compte de stockage Azure.
Configurez les propriétés General :
- Authentification du stockage : sélectionnez une méthode d’authentification :
  - La signature d’accès partagé est sélectionnée par défaut. Vous devez entrer le chaîne de connexion Signature d’accès partagé dans le champ Chaîne de connexion.
  - Si vous utilisez des clés d’accès, une collection de comptes de stockage est renseignée dans la liste déroulante Compte . Une fois que vous avez sélectionné le compte de stockage, le champ Chaîne de connexion est automatiquement renseigné avec la clé d’accès primaire, également appelée key1.
  Les liens suivants sont de bonnes ressources pour vous aider à déterminer la méthode d’authentification la mieux adaptée à votre scénario :
  - Autorisation de l’accès aux données dans Stockage Azure
  - Utilisation des signatures d’accès partagé (SAP)
- Nom du conteneur d’objets blob : sélectionnez le nom de votre conteneur d’objets blob dans la liste déroulante. La liste est renseignée automatiquement après l’entrée de la chaîne de connexion .
- Nom de l’objet blob : entrez le nom de l’objet blob à utiliser par l’adaptateur. Les macros peuvent être utilisées dans le nom de l’objet blob. Pour connaître les macros disponibles, consultez Utilisation de macros dans les noms de fichiers.
- Espace de noms pour les métadonnées d’objets blob : entrez l’espace de noms en tant que filtre. Les propriétés de contexte du message sont écrites dans les métadonnées d’objet blob si l’espace de noms de la propriété correspond à ce champ.
Lorsque vous avez terminé, vos propriétés ressemblent à ce qui suit :
Configurez les propriétés avancées :
- Type d’objet blob : entrez le type d’objet blob à utiliser. Pour plus d’informations, consultez Types d’objets blob.
- Mode d’écriture : utilisez ce paramètre pour spécifier le comportement de l’adaptateur lorsque le nom d’objet blob donné existe déjà.
  - Créer : l’adaptateur tente toujours de créer un objet blob. Si un objet blob portant le même nom existe déjà, le message BizTalk est suspendu.
  - Remplacement : l’adaptateur remplace si le nom de l’objet blob existe déjà. Les métadonnées sont également remplacées.
  - Append : l’adaptateur ajoute le corps du message à un objet blob existant si un objet blob existe déjà. Les métadonnées ne changent pas.
Sélectionnez OK pour enregistrer vos modifications.

Tester votre port d’envoi

Vous pouvez utiliser un port et un emplacement de réception de fichiers simples pour envoyer des messages à votre stockage Blob Azure.

À l’aide de l’adaptateur de fichier, créez un port de réception nommé FileReceivePort. Dans votre emplacement de réception, définissez le dossier Réception sur C:\Temp\In\\et définissez le masque de fichier sur \*.xml.
Dans les propriétés de port d’envoi de votre stockage Blob Azure, définissez Filtres sur BTS.ReceivePortName == FileReceivePort.
Collez ce qui suit dans un éditeur de texte, puis enregistrez le fichier en tant que AzureBlobStorageMessage.xml. Ce fichier est votre exemple de message.
```
<Data>
  <DataID>DataID_0</DataID>
  <DataDetails>DataDetails_0</DataDetails>
</Data>
```
Démarrez l’emplacement de réception des fichiers et le port d’envoi du stockage blob Azure.
Copiez le AzureBlobStorageMessage.xml exemple de message dans le dossier de réception, par C:\Temp\In\exemple . Le port d’envoi envoie le fichier XML au stockage blob Azure. Confirmez en examinant votre conteneur de stockage Azure et en affichant le fichier nouvellement créé ou mis à jour.

Recevoir des messages à partir du Stockage Blob Azure

Dans la console Administration BizTalk Server, cliquez avec le bouton droit surNouveaux>ports>de réception unidirectionnel.

Créer un port de réception fournit des conseils.
Entrez un nom, puis sélectionnez Emplacements de réception.
Sélectionnez Nouveau, puis Nommez l’emplacement de réception. Dans Transport, sélectionnez AzureBlobStorage dans la liste déroulante Type . Sélectionnez Configurer.
Configurez les propriétés du compte Azure :

Conseil

Similiar à l’adaptateur d’envoi, c’est facultatif.
- Connexion : connectez-vous à votre compte Azure.
- Abonnement : sélectionnez l’abonnement qui contient votre compte de stockage Azure.
- Groupe de ressources : sélectionnez le groupe de ressources qui contient votre compte de stockage Azure.
Configurez les propriétés General :
- Authentification du stockage : sélectionnez une méthode d’authentification :
  - La signature d’accès partagé est sélectionnée par défaut. Vous devez entrer le chaîne de connexion Signature d’accès partagé dans le champ Chaîne de connexion.
  - Si vous utilisez des clés d’accès, une collection de comptes de stockage est renseignée dans la liste déroulante Compte . Une fois que vous avez sélectionné le compte de stockage, le champ Chaîne de connexion est automatiquement renseigné avec la clé d’accès primaire, également appelée key1.
  Les liens suivants sont de bonnes ressources pour vous aider à décider qui convient à votre scénario :
  - Autorisation de l’accès aux données dans Stockage Azure
  - Utilisation des signatures d’accès partagé (SAP)
- Nom du conteneur d’objets blob : sélectionnez le nom de votre conteneur d’objets blob dans la liste déroulante. La liste est renseignée automatiquement après l’entrée de la chaîne de connexion .
- Préfixe de nom d’objet blob : entrez un préfixe le cas échéant. Par exemple, si « order/ » est utilisé pour le préfixe de nom d’objet blob, l’emplacement de réception récupère uniquement les fichiers dans le dossier « order ».
- Espace de noms pour les métadonnées d’objets blob : entrez un espace de noms pour l’adaptateur afin de créer des propriétés de contexte à partir de métadonnées d’objets blob personnalisées.
- Promouvoir les propriétés des métadonnées : indiquez si les métadonnées d’objets blob personnalisées sont promues ou non.
Notes

Par défaut, toutes les propriétés d’objet blob standard, telles que l’URI d’objet blob, name et BlobType, sont définies en tant que propriétés de contexte du message BizTalk avec l’espace http://schemas.microsoft.com/BizTalk/Adapter/AzureStorage-properties de noms.

Lorsque vous avez terminé, vos propriétés ressemblent à ce qui suit :
Configurez les propriétés avancées :
- Intervalle d’interrogation : entrez l’intervalle d’interrogation.
- Nombre maximal de messages par lot : entrez le nombre de messages que l’adaptateur traite par lots lors de l’envoi à BizTalk.
- Téléchargements parallèles : entrez le nombre maximal d’objets blob autorisés à être téléchargés en parallèle.
- Seuil d’erreur : entrez le seuil d’erreur. Lorsque l’emplacement de réception atteint ce nombre d’erreurs, l’emplacement de réception est désactivé.
Sélectionnez OK pour enregistrer vos modifications.

Tester vos paramètres de réception

Vous pouvez utiliser un port d’envoi de fichier simple pour recevoir des messages à partir de votre stockage Blob Azure.

Créez un port d’envoi à l’aide de l’adaptateur de fichier. Dans vos propriétés de port d’envoi, définissez le dossier Destination sur C:\Temp\Out\\, puis définissez et nom de fichier sur %MessageID%.xml.
Dans vos propriétés de port d’envoi de fichier, définissez Filtres sur BTS.ReceivePortName == BlobReceivePort.
Créez un port de réception nommé BlobReceivePort et créez un emplacement de réception stockage Blob Azure. Démarrez-le.
Chargez un fichier dans le conteneur d’objets blob dans le Portail Azure. Faites attention au préfixe correspondant que vous avez configuré dans l’adaptateur. Recherchez les messages dans le dossier de destination (c :\temp\out).

Important

L’adaptateur de réception stockage Blob Azure supprime l’objet blob après son envoi à la base de données BizTalk MessageBox.

Haute disponibilité de l’adaptateur de stockage Blob Azure

L’adaptateur de réception stockage Blob Azure prend en charge la haute disponibilité. Vous pouvez ajouter plusieurs instances d’hôte dans le même gestionnaire de réception de l’adaptateur de stockage Blob Azure pour recevoir simultanément à partir du même conteneur d’objets blob. La location d’objets blob est utilisée comme verrou pour éviter que le même objet blob ne soit reçu par plusieurs instances d’hôte. Par conséquent:

Les objets blob loués par d’autres processus ne seront pas reçus par l’adaptateur de stockage Blob Azure.
Les objets blob reçus par l’adaptateur de stockage Blob Azure ne peuvent pas être mis à jour dans un état loué.

Pour plus d’informations sur la location d’objets blob Azure, consultez Concurrence pessimiste pour les objets blob.

L’adaptateur d’envoi du stockage Blob Azure, comme la plupart des adaptateurs d’envoi, fournit une haute disponibilité pour l’hôte d’envoi en ayant plusieurs instances d’hôte dans le même hôte d’envoi.

Étapes suivantes

Adaptateurs dans BizTalk Server