Condividi tramite

Adapter SB-Messaging

  • Articolo

L'adattatore del bus di servizio (SB-Messaging) viene usato per ricevere e inviare da entità del bus di servizio, ad esempio code, argomenti e inoltri. È possibile usare l'adattatore SB-Messaging per connettere l'BizTalk Server locale ad Azure.

A partire da BizTalk Server 2016 Feature Pack 2, è supportato Il bus di servizio Premium. Quando si configura una porta di trasmissione tramite questa scheda, è possibile inviare messaggi a code e argomenti partizionati.

Importante

L'adapter di SB-Messaging BizTalk usa il protocollo SBMP che supporta i messaggi fino a una dimensione massima di 1 mb. L'adapter BizTalk non supporta il protocollo AMQP che può gestire messaggi di dimensioni maggiori.

Autenticazione con il bus di servizio

Il bus di servizio fornisce due metodi per l'autenticazione:

  • Servizio di controllo di accesso (ACS)
  • Firma di accesso condiviso

È consigliabile usare la firma di accesso condiviso per l'autenticazione con il bus di servizio. Il valore chiave di accesso condiviso è elencato nel portale di Azure.

Quando si crea uno spazio dei nomi del bus di servizio, lo spazio dei nomi Controllo di accesso (ACS) non viene creato automaticamente. Per usare Controllo di accesso, sono necessari i valori Issuer Name e Issuer Key di questo spazio dei nomi. Questi valori sono disponibili quando si crea un nuovo spazio dei nomi ACS usando Windows PowerShell. Questi valori non sono elencati nella portale di Azure.

Per usare il servizio contenitore di Azure per l'autenticazione e ottenere i valori di Nome e chiave dell'autorità emittente, la procedura generale include:

  1. Installare i cmdlet di Azure PowerShell.

  2. Aggiungere il proprio Account Azure: Add-AzureAccount

  3. Restituire il nome della sottoscrizione: get-azuresubscription

  4. Selezionare la propria sottoscrizione: select-azuresubscription <name of your subscription>

  5. Creare un nuovo spazio dei nomi: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

    Esempio: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

  6. Quando viene creato il nuovo spazio dei nomi ACS (che può richiedere alcuni minuti), i valori IssuerName e IssuerKey sono elencati nel stringa di connessione:

    Name                  : biztalksbnamespace
Region                : South Central US
DefaultKey            : abcdefghijklmnopqrstuvwxyz
Status                : Active
CreatedAt             : 10/18/2016 9:36:30 PM
AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/
ServiceBusEndpoint    : https://biztalksbnamespace.servicebus.windows.net/
ConnectionString      : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz
NamespaceType         : Messaging

Per indicazioni, vedere New-AzureSBNamespace .

Ricevere messaggi dal bus di servizio

  1. Nella console di amministrazione di BizTalk Server espandere Gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione.

  2. Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e selezionare Porta di ricezione unidirezionale.

  3. Assegnare un nome e selezionare Località di ricezione.

  4. Selezionare Nuovo, assegnargli un nome. Nella sezione Trasporto selezionare SB-Messaging dall'elenco a discesa Tipo e quindi selezionare Configura.

  5. Configurare le proprietà Generale :

    Usare Per
    Coda o URL sottoscrizione Specificare l'URL in cui viene distribuita la coda di Service Bus. Il formato dell'URL in genere è il seguente:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Timeout di apertura Specifica un valore che indica l'intervallo di tempo per il completamento di un’operazione di apertura di un canale.

    Valore predefinito: 1 minuto
    Timeout di chiusura Specifica un valore che indica l'intervallo di tempo per il completamento di un'operazione di chiusura di un canale.

    Valore predefinito: 1 minuto
    Timeout di ricezione Specifica un valore che indica l'intervallo di tempo per il completamento di un'operazione di ricezione.

    Valore predefinito: 10 minuti
    Conteggio prelettura Specifica il numero di messaggi ricevuti simultaneamente dalla coda di Service Bus o da un argomento. La prelettura consente al client di coda o sottoscrizione di caricare messaggi aggiuntivi dal servizio durante l'esecuzione di un'operazione di ricezione. Il client archivia i messaggi in una cache locale. Le dimensioni della cache sono determinate dal valore della proprietà Numero preletture specificato.

    Per altre informazioni, vedere la sezione "Prefetching" all'indirizzo https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/

    Valore predefinito: -1
    Usa sessione Selezionare questa casella di controllo per usare una sessione di Service Bus per la ricezione di messaggi da una coda o da una sottoscrizione.

  6. Configurare le proprietà di autenticazione :

    Usare Per
    servizio Controllo di accesso Selezionarlo per usare ACS per l'autenticazione e fornire i seguenti valori:

    - Immettere l'URI del servizio Controllo di accesso servizio token di sicurezza del bus di servizio. Il formato dell'URI in genere è il seguente:

    https://<namespace>-sb.accesscontrol.windows.net/

    - Immettere il nome dell'autorità di certificazione per lo spazio dei nomi del bus di servizio.

    - Immettere la chiave dell'autorità di certificazione per lo spazio dei nomi del bus di servizio.
    Firma di accesso condiviso (novità a partire da BizTalk Server 2013 R2) Selezionarla per usare la firma di accesso condiviso per l'autenticazione e fornire il nome della chiave e il valore della chiave della firma di accesso condiviso.

  7. Nella scheda Proprietà, in Namespace for Brokered Message Properties (Spazio dei nomi per proprietà messaggio negoziate) immettere lo spazio dei nomi utilizzato dall'adapter per scrivere le proprietà del messaggio negoziate come proprietà del contesto del messaggio ricevuto da BizTalk Server. Se si desidera alzare di livello le proprietà dei messaggi negoziati, selezionare la casella di controllo Alza di livello proprietà messaggio negoziata .

  8. Selezionare OK.

  9. Selezionare il gestore di ricezione e la pipeline di ricezione. Selezionare OK per salvare le modifiche. La creazione di un percorso di ricezione fornisce alcune indicazioni.

Inviare messaggi al bus di servizio

  1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e selezionare Porta di trasmissione statica unidirezionale.

    La creazione di una porta di trasmissione fornisce alcune indicazioni.

  2. Immettere un Nome. In Trasporto impostare Tipo su SB-Messaging e selezionare Configura.

  3. Configurare le proprietà Generale :

    Usare Per
    URL di destinazione Immettere l'URL in cui viene distribuita la coda del bus di servizio. Il formato dell'URL in genere è il seguente:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    BatchFlushInterval Specifica un valore temporale che indica l'intervallo in cui i batch di messaggi inviati a una coda o a un argomento vengono scaricati. Il valore predefinito è 20 millisecondi.

    Per altre informazioni sull'invio in batch rispetto alle code e agli argomenti del bus di servizio, vedere la sezione Batch sul lato client all'indirizzo https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
    Timeout di apertura Specifica un valore che indica l'intervallo di tempo per il completamento di un’operazione di apertura di un canale.

    Valore predefinito: 1 minuto
    Timeout di invio Specifica un valore che indica l'intervallo di tempo per il completamento di un'operazione di invio.

    Valore predefinito: 1 minuto
    Timeout di chiusura Specifica un valore che indica l'intervallo di tempo per il completamento di un'operazione di chiusura di un canale.

    Valore predefinito: 1 minuto

  4. Configurare le proprietà di autenticazione :

    Usare Per
    servizio Controllo di accesso Selezionarlo per usare ACS per l'autenticazione e fornire i seguenti valori:

    - Immettere l'URI del servizio Controllo di accesso servizio token di sicurezza del bus di servizio. Il formato dell'URI in genere è il seguente:

    https://<namespace>-sb.accesscontrol.windows.net/

    - Immettere il nome dell'autorità di certificazione per lo spazio dei nomi del bus di servizio.

    - Immettere la chiave dell'autorità di certificazione per lo spazio dei nomi del bus di servizio.
    Firma di accesso condiviso (novità a partire da BizTalk Server 2013 R2) Selezionarla per usare la firma di accesso condiviso per l'autenticazione e fornire il nome della chiave e il valore della chiave della firma di accesso condiviso.

  5. Nella scheda Proprietà immettere spazio dei nomi per le proprietà del messaggio negoziate definite dall'utente che contiene le proprietà del contesto del messaggio BizTalk che si desidera scrivere nel messaggio in uscita nel bus di servizio. Tutte le proprietà dello spazio dei nomi vengono scritte nel messaggio come proprietà del messaggio negoziate definite dall'utente. L'adapter ignora lo spazio dei nomi durante la scrittura delle proprietà come proprietà del messaggio negoziato. Usa lo spazio dei nomi solo per verificare le proprietà da scrivere.

    È anche possibile immettere i valori per le proprietà BrokeredMessage. Queste proprietà sono descritte in Proprietà BrokeredMessage, inclusa la chiave di partizione.

  6. Selezionare OK per salvare le modifiche.

Vedi anche

Uso degli adattatori