Leggere in inglese

Condividi tramite


Scheda di archiviazione BLOB di Azure in BizTalk Server

A partire da BizTalk Server 2020 e versioni successive, è possibile inviare e ricevere messaggi tra BizTalk Server e archiviazione BLOB di Azure.

Archiviazione BLOB di Azure è la soluzione di archiviazione oggetti di Microsoft per il cloud, ottimizzata per l'archiviazione di grandi quantità di dati non strutturati. Per altre informazioni, vedere Informazioni sull'archiviazione BLOB di Azure?

Prerequisiti

Creare un account di archiviazione BLOB di Azure con un contenitore.

Inviare messaggi all'archiviazione BLOB di Azure

  1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse su Invia porte>nuova>porta di invio statica unidirezionale.

    Creare una porta di trasmissione fornisce alcune indicazioni.

  2. Immettere un Nome. In Trasporto impostare Tipo su AzureBlobStorage e selezionare Configura.

  3. Configurare le proprietà dell'account di Azure .

    Suggerimento

    La finestra di configurazione della scheda può popolare automaticamente le risorse di Azure dopo l'accesso alla sottoscrizione di Azure. Ciò semplifica la configurazione. L'accesso alla sottoscrizione di Azure è optinal.

    • Accesso: accedere all'account Azure.
    • Sottoscrizione: selezionare la sottoscrizione con l'account di archiviazione di Azure.
    • Gruppo di risorse: selezionare il gruppo di risorse con l'account di archiviazione di Azure.
  4. Configurare le proprietà Generale :

    • Autenticazione archiviazione: selezionare un metodo di autenticazione:

      • La firma di accesso condiviso è selezionata per impostazione predefinita. È necessario immettere la firma di accesso condiviso stringa di connessione nel campo Stringa di connessione.
      • Se si usano chiavi di accesso, viene popolata una raccolta di account di archiviazione nell'elenco a discesa Account . Dopo aver selezionato l'account di archiviazione, il campo Stringa di connessione viene popolato automaticamente con la chiave di accesso primaria, nota anche come key1.

      I collegamenti seguenti sono risorse valide per decidere quale metodo di autenticazione è adatto per lo scenario:

    • Nome contenitore BLOB: selezionare il nome del contenitore BLOB dall'elenco a discesa. L'elenco viene popolato automaticamente dopo l'immissione della stringa di connessione .

    • Nome BLOB: immettere il nome del BLOB da usare dall'adapter. Le macro possono essere usate nel nome del BLOB. Per le macro disponibili, vedere Uso di macro nei nomi di file.

    • Spazio dei nomi per i metadati BLOB: immettere lo spazio dei nomi come filtro. Le proprietà del contesto del messaggio vengono scritte nei metadati del BLOB se lo spazio dei nomi della proprietà corrisponde a questo campo.

    Al termine, le proprietà sono simili alle seguenti:

    Proprietà generali dell'adapter di invio dell'archiviazione BLOB di Azure in BizTalk Server

  5. Configurare le proprietà Avanzate :

    • Tipo DI BLOB: immettere il tipo DI BLOB da usare. Per altre informazioni, vedere Tipi di BLOB.
    • Modalità di scrittura: usare questa impostazione per specificare il comportamento dell'adattatore quando esiste già il nome BLOB specificato.
      • Crea nuovo: l'adapter tenta sempre di creare un nuovo BLOB. Se esiste già un BLOB con lo stesso nome, il messaggio BizTalk viene sospeso.
      • Sovrascrivi: l'adapter sovrascrive se il nome del BLOB esiste già. I metadati vengono sovrascritti.
      • Accodamento: l'adapter aggiunge il corpo del messaggio a un BLOB esistente se esiste già un BLOB. I metadati non cambiano.
  6. Selezionare OK per salvare le modifiche.

Testare la porta di invio

È possibile usare una semplice porta di ricezione file e un percorso per inviare messaggi all'archiviazione BLOB di Azure.

  1. Usando l'adapter File, creare una porta di ricezione denominata FileReceivePort. All'interno del percorso di ricezione impostare la cartella Ricezione su C:\Temp\In\\e impostare la maschera file su \*.xml.

  2. Nelle proprietà della porta di invio dell'archiviazione BLOB di Azure impostare Filtri su BTS.ReceivePortName == FileReceivePort.

  3. Incollare il codice seguente in un editor di testo e salvare il file come AzureBlobStorageMessage.xml. Questo file è il messaggio di esempio.

    <Data>
      <DataID>DataID_0</DataID>
      <DataDetails>DataDetails_0</DataDetails>
    </Data>
    
  4. Avviare il percorso di ricezione file e la porta di invio dell'archiviazione BLOB di Azure.

  5. Copiare il messaggio di esempioAzureBlobStorageMessage.xml nella cartella di ricezione, ad esempio C:\Temp\In\. La porta di invio invia il file XML all'archiviazione BLOB di Azure. Verificare esaminando il contenitore di archiviazione di Azure e visualizzando il file appena creato o aggiornato.

Ricevere messaggi dall'archiviazione BLOB di Azure

  1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse su Porte di> ricezioneNuova>porta di ricezione unidirezionale.

    Creare una porta di ricezione fornisce alcune indicazioni.

  2. Immettere un nome e selezionare Posizioni di ricezione.

  3. Selezionare Nuovo e Assegnare un nome alla posizione di ricezione. In Trasporto selezionare AzureBlobStorage nell'elenco a discesa Tipo . Selezionare Configura.

  4. Configurare le proprietà dell'account di Azure :

    Suggerimento

    Analogamente all'adattatore di invio, è facoltativo.

    • Accesso: accedere all'account Azure.
    • Sottoscrizione: selezionare la sottoscrizione con l'account di archiviazione di Azure.
    • Gruppo di risorse: selezionare il gruppo di risorse con l'account di archiviazione di Azure.
  5. Configurare le proprietà Generale :

    • Autenticazione archiviazione: selezionare un metodo di autenticazione:

      • La firma di accesso condiviso è selezionata per impostazione predefinita. È necessario immettere la firma di accesso condiviso stringa di connessione nel campo Stringa di connessione.
      • Se si usano chiavi di accesso, viene popolata una raccolta di account di archiviazione nell'elenco a discesa Account . Dopo aver selezionato l'account di archiviazione, il campo Stringa di connessione viene popolato automaticamente con la chiave di accesso primaria, nota anche come key1.

      I collegamenti seguenti sono risorse valide che consentono di decidere quale è il modo giusto per lo scenario:

    • Nome contenitore BLOB: selezionare il nome del contenitore BLOB dall'elenco a discesa. L'elenco viene popolato automaticamente dopo l'immissione della stringa di connessione .

    • Prefisso del nome BLOB: immettere un prefisso se applicabile. Ad esempio, se "order/" viene usato per il prefisso del nome BLOB, il percorso di ricezione seleziona solo i file nella cartella "order".

    • Spazio dei nomi per i metadati BLOB: immettere uno spazio dei nomi per l'adapter per creare proprietà di contesto da metadati BLOB personalizzati.

    • Promuovere le proprietà dei metadati: scegliere se i metadati BLOB personalizzati vengono promossi o meno.

    Nota

    Per impostazione predefinita, tutte le proprietà BLOB standard, ad esempio Uri BLOB, Nome e BLOBType, vengono impostate come proprietà di contesto del messaggio BizTalk con lo http://schemas.microsoft.com/BizTalk/Adapter/AzureStorage-properties spazio dei nomi.

    Al termine, le proprietà sono simili alle seguenti:

    Proprietà generali dell'adattatore di archiviazione BLOB di Azure in BizTalk Server

  6. Configurare le proprietà Avanzate :

    • Intervallo di polling: immettere l'intervallo di polling.
    • Numero massimo di messaggi per batch: immettere il numero di messaggi in batch dell'adattatore durante l'invio a BizTalk.
    • Download paralleli: immettere il numero massimo di BLOB consentiti da scaricare in parallelo.
    • Soglia di errore: immettere la soglia di errore. Quando la posizione di ricezione raggiunge questo numero di errori, la posizione di ricezione è disabilitata.
  7. Selezionare OK per salvare le modifiche.

Testare le impostazioni di ricezione

È possibile usare una semplice porta di trasmissione file per ricevere messaggi dall'archivio BLOB di Azure.

  1. Creare una porta di trasmissione usando l'adapter File. All'interno delle proprietà della porta di trasmissione impostare la cartella Destination su C:\Temp\Out\\e impostare il valore e Nome file su %MessageID%.xml.
  2. Nelle proprietà della porta di trasmissione file impostare Filtri su BTS.ReceivePortName == BlobReceivePort.
  3. Creare una porta di ricezione denominata BlobReceivePort e creare un percorso di ricezione dell'archiviazione BLOB di Azure. Avvialo.
  4. Caricare un file nel contenitore BLOB nel portale di Azure. Prestare attenzione al prefisso corrispondente configurato nell'adattatore. Cercare i messaggi nella cartella di destinazione (c:\temp\out).

Importante

L'adattatore di ricezione dell'archiviazione BLOB di Azure elimina il BLOB dopo l'invio al database MessageBox BizTalk.

Disponibilità elevata della scheda di archiviazione BLOB di Azure

L'adattatore di ricezione dell'archiviazione BLOB di Azure supporta la disponibilità elevata. È possibile aggiungere più istanze host nella stessa scheda di ricezione dell'archiviazione BLOB di Azure per ricevere contemporaneamente dallo stesso contenitore BLOB. Il leasing dei BLOB viene usato come blocco per evitare che lo stesso BLOB venga ricevuto da più istanze host. Secondo:

  • I BLOB in lease da altri processi non verranno ricevuti dalla scheda di archiviazione BLOB di Azure.
  • I BLOB ricevuti dall'adattatore di archiviazione BLOB di Azure non possono essere aggiornati in uno stato con lease.

Per altre informazioni sul leasing di BLOB di Azure, vedere Concorrenza pessimistica per i BLOB.

L'adattatore di trasmissione dell'archiviazione BLOB di Azure, come la maggior parte degli adattatori di trasmissione, offre disponibilità elevata per l'host di invio con più istanze host nello stesso host di invio.

Passaggi successivi

Adapter in BizTalk Server