Richiamare funzioni di Table-Valued in SQL Server usando BizTalk Server

Articolo
07/21/2023

È possibile usare l'adattatore SQL con BizTalk Server per richiamare funzioni con valori di tabella in SQL Server. L'adattatore espone le funzioni con valori di tabella come operazioni che possono essere richiamate direttamente in SQL Server. Per altre informazioni su come l'adattatore supporta le funzioni con valori di tabella, vedere Esecuzione di funzioni Table-Valued in SQL Server tramite l'adapter SQL. Per informazioni sulla struttura del messaggio SOAP per richiamare funzioni con valori di tabella, vedere Message Schemas for Procedures and Functions.

Prerequisiti

Creare un file di chiave con nome sicuro e apprendere gli strumenti
Configurare MSDTC nei computer che eseguono l'adapter SQL e SQL Server.

Richiamare funzioni con valori di tabella in un database SQL Server

L'esecuzione di un'operazione su un database SQL Server tramite l'adapter SQL con BizTalk Server comporta attività procedurali descritte in Blocchi predefiniti per sviluppare applicazioni BizTalk con l'adapter SQL. Per richiamare funzioni con valori di tabella in SQL Server, queste attività sono:

Creare un progetto BizTalk e generare lo schema per la funzione con valori di tabella che si desidera richiamare in SQL Server.
Creare messaggi nel progetto BizTalk per l'invio e la ricezione di messaggi da SQL Server.
Creare un'orchestrazione per richiamare l'operazione su SQL Server.
Compilare e distribuire il progetto BizTalk.
Configurare l'applicazione BizTalk creando porte di invio e ricezione fisiche.
Avviare l'applicazione BizTalk.

In questo argomento vengono fornite istruzioni per eseguire queste attività.

Genera schema

Questo argomento illustra come richiamare funzioni con valori di tabella in SQL Server usando l'adapter SQL con BizTalk Server. Per illustrare questa operazione, in questo argomento si esegue la funzione TVF_EMPLOYEE. Questa funzione accetta la designazione di un dipendente come parametro e restituisce tutti i record dei dipendenti con tale designazione, come tipo di tabella. La tabella Employee e la funzione vengono create eseguendo gli script forniti con gli esempi. Per altre informazioni sullo script, vedere Esempi per l'adapter SQL.

Per illustrare come richiamare funzioni con valori di tabella, lo schema viene generato per la funzione con valori di tabella TVF_EMPLOYEE. È necessario creare un progetto BizTalk e usare il componente aggiuntivo Consume Adapter Service per generare lo schema. Per altre informazioni su come generare schemi, vedere Recupero di metadati per SQL Server operazioni in Visual Studio tramite l'adapter SQL.

Definire messaggi e tipi di messaggio

Lo schema generato in precedenza descrive i "tipi" necessari per i messaggi nell'orchestrazione. Un messaggio in genere è una variabile, il cui tipo è definito dallo schema corrispondente. A questo punto, creare messaggi per l'orchestrazione e collegarli agli schemi generati nel passaggio precedente.

Aggiungere un'orchestrazione al progetto BizTalk. Da Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto BizTalk, scegliere Aggiungi e quindi fare clic su Nuovo elemento. Digitare un nome per l'orchestrazione BizTalk e quindi fare clic su Aggiungi.
Aprire la finestra Visualizzazione orchestrazione del progetto BizTalk, se non è già aperta. A tale scopo, fare clic su Visualizza, scegliere Altre finestre e quindi fare clic su Visualizzazione orchestrazione.
In Visualizzazione orchestrazione fare clic con il pulsante destro del mouse su Messaggi e quindi scegliere Nuovo messaggio.
Fare clic con il pulsante destro del mouse sul messaggio appena creato e quindi scegliere Finestra Proprietà.

Nel riquadro Proprietà per il Message_1 eseguire le operazioni seguenti:

Usare	Per
Identificatore	Digitare `Request`
Tipo di messaggio	Nell'elenco a discesa espandere Schemi e quindi selezionare TableFunctions.TableValuedFunction_dbo. TVF_EMPLOYEE, dove TableFunctions è il nome del progetto BizTalk. TableValuedFunction_dbo è lo schema generato per la funzione TVF_EMPLOYEE.

Ripetere il passaggio 2 per creare un nuovo messaggio. Nel riquadro Proprietà per il nuovo messaggio eseguire le operazioni seguenti:

Usare Per

Identificatore Digitare Response

Tipo di messaggio Nell'elenco a discesa espandere Schemi e quindi selezionare TableFunctions.TableValuedFunction_dbo. TVF_EMPLOYEEResponse.

Usare	Per
Identificatore	Digitare `Response`
Tipo di messaggio	Nell'elenco a discesa espandere Schemi e quindi selezionare TableFunctions.TableValuedFunction_dbo. TVF_EMPLOYEEResponse.

Configurare l'orchestrazione

Creare un'orchestrazione BizTalk per usare BizTalk Server per eseguire un'operazione in SQL Server. In questa orchestrazione si rilascia un messaggio di richiesta in una posizione di ricezione definita. L'adapter SQL utilizza questo messaggio e lo passa a SQL Server. La risposta da SQL Server viene salvata in un'altra posizione. È necessario includere le forme Invia e Ricevi per inviare messaggi a SQL Server e per ricevere le risposte, rispettivamente. Un'orchestrazione di esempio per richiamare una funzione con valori di tabella è simile alla seguente:

Orchestrazione per richiamare una funzione con valori di tabella

Aggiungere forme messaggio

Immettere le proprietà seguenti per ognuna delle forme del messaggio. I nomi elencati nella colonna Shape sono i nomi delle forme di messaggio visualizzate nell'orchestrazione appena menzionata.

Forma	Tipo di forma	Proprietà
ReceiveMessage	Ricevere	- Impostare Il nome su ReceiveMessage - Impostare Attiva su True
SendMessage	Send	- Impostare Il nome su SendMessage
ReceiveResponse	Ricevere	- Impostare il nome su ReceiveResponse - Impostare Attiva su False
SendResponse	Send	- Impostare il nome su SendResponse

Aggiungere porte

Immettere le proprietà seguenti per ognuna delle porte logiche. I nomi elencati nella colonna Porta sono i nomi delle porte visualizzate nell'orchestrazione.

Porta	Proprietà
MessageIn	- Impostare l'identificatore su MessageIn - Impostare il tipo su MessageInType - Impostare il modello di comunicazionesu unidirezionale - Impostare la direzione di comunicazione da ricevere
LOBPort	- Impostare l'identificatore su LOBPort - Impostare il tipo su LOBPortType - Impostare il modello di comunicazione su Request-Response - Impostare la direzione di comunicazione su Send-Receive
ResponseOut	- Impostare l'identificatore su ResponseOut - Impostare il tipo su ResponseOutType - Impostare il modello di comunicazionesu unidirezionale - Impostare la direzione di comunicazione su Invia

Immettere i messaggi per le forme azione e connetterli alle porte

Nella tabella seguente vengono specificate le proprietà e i relativi valori che è necessario impostare per specificare i messaggi per le forme azione e collegare i messaggi alle porte. I nomi elencati nella colonna Shape sono i nomi delle forme del messaggio visualizzate nell'orchestrazione menzionata in precedenza.

Forma	Proprietà
ReceiveMessage	- Impostare il messaggio su Richiesta - Impostare l'operazione su MessageIn.TVF.Request
SendMessage	- Impostare il messaggio su Richiesta - Impostare l'operazione su LOBPort.TVF.Request
ReceiveResponse	- Impostare il messaggio su Risposta - Impostare l'operazione su LOBPort.TVF.Response
SendResponse	- Impostare il messaggio su Risposta - Impostare l'operazione su ResponseOut.TVF.Request

Dopo aver specificato queste proprietà, le forme e le porte del messaggio sono connesse e l'orchestrazione è completata.

Compilare ora la soluzione BizTalk e distribuirla in BizTalk Server. Per altre informazioni, vedere Compilazione ed esecuzione di orchestrazioni.

Configurare l'applicazione BizTalk

Dopo aver distribuito il progetto BizTalk, l'orchestrazione creata in precedenza è elencata nel riquadro Orchestrazioni nella console di amministrazione di BizTalk Server. Per configurare l'applicazione, è necessario usare la console di amministrazione di BizTalk Server. Per una procedura dettagliata, vedere Procedura dettagliata: Distribuzione di un'applicazione BizTalk di base.

La configurazione di un'applicazione prevede:

Selezione di un host per l'applicazione.
Mapping delle porte create nell'orchestrazione alle porte fisiche nella console di amministrazione di BizTalk Server. Per questa orchestrazione è necessario:
- Definire un percorso sul disco rigido e una porta file corrispondente in cui si rilascia un messaggio di richiesta. L'orchestrazione BizTalk utilizzerà il messaggio di richiesta e lo invierà al database SQL Server.
- Definire un percorso sul disco rigido e una porta file corrispondente in cui l'orchestrazione BizTalk rilascia il messaggio di risposta contenente la risposta dal database SQL Server.
- Definire una porta di trasmissione fisica WCF-Custom o WCF-SQL per inviare messaggi al database SQL Server. È inoltre necessario specificare l'azione nella porta di trasmissione. Per informazioni su come creare porte, vedere Configurare manualmente un'associazione di porte fisiche all'adapter SQL.
  
  Nota
  
  La generazione dello schema tramite il componente aggiuntivo Del progetto BizTalk del servizio adapter di utilizzo crea anche un file di associazione contenente informazioni sulle porte e le azioni da impostare per tali porte. È possibile importare questo file di associazione dalla console di amministrazione di BizTalk Server per creare porte di trasmissione (per chiamate in uscita) o porte di ricezione (per le chiamate in ingresso). Per altre informazioni, vedere Configurare un'associazione di porte fisiche usando un file di associazione di porte per l'uso dell'adattatore SQL.

Avviare l'applicazione

Avviare l'applicazione BizTalk per richiamare le funzioni con valori di tabella nel database SQL Server. Per istruzioni sull'avvio di un'applicazione BizTalk, vedere Come avviare un'orchestrazione.

In questa fase, assicurarsi di:

La porta di ricezione FILE per ricevere messaggi di richiesta per l'orchestrazione è in esecuzione.
La porta di trasmissione FILE per ricevere i messaggi di risposta dall'orchestrazione è in esecuzione.
La porta di trasmissione WCF-Custom o WCF-SQL per inviare messaggi al database SQL Server è in esecuzione.
L'orchestrazione BizTalk per l'operazione è in esecuzione.

Eseguire l'operazione

Dopo aver eseguito l'applicazione, è necessario eliminare un messaggio di richiesta nel percorso di ricezione FILE. Lo schema per il messaggio di richiesta deve essere conforme allo schema per la funzione con valori di tabella TVF_EMPLOYEE generata in precedenza. Ad esempio, il messaggio di richiesta per richiamare la funzione TVF_EMPLOYEE è:

<TVF_EMPLOYEE xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/dbo">  
  <emp_desig>Tester</emp_desig>  
</TVF_EMPLOYEE>

Questo messaggio di richiesta richiama la funzione TVF_EMPLOYEE per recuperare i record dei dipendenti con la designazione "Tester". Per altre informazioni sullo schema dei messaggi per richiamare le funzioni con valori di tabella in SQL Server tramite l'adapter SQL, vedere Message Schemas for Procedures and Functions .See Message Schemas for Procedures and Functions for more information about the request message schema for invoking table-valued functions in SQL Server using the SQL adapter.

Nota

Se non si specifica un valore per il parametro , l'adattatore esegue internamente la funzione usando la parola chiave DEFAULT, il che significa che l'adattatore esegue la funzione passando il valore predefinito per il parametro, se disponibile come parte della definizione della funzione.

L'orchestrazione utilizza il messaggio e lo invia al database SQL Server. La risposta dal database SQL Server viene salvata nell'altro percorso FILE definito come parte dell'orchestrazione. Ad esempio, la risposta del database di SQL Server per il messaggio di richiesta precedente è:

<?xml version="1.0" encoding="utf-8" ?>   
<TVF_EMPLOYEEResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/dbo">  
  <TVF_EMPLOYEEResult>  
    <TVF_EMPLOYEE xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/TableFunctionReturnTables/dbo">  
      <Employee_ID>10499</Employee_ID>   
      <Name>John</Name>   
      <Designation>Tester</Designation>   
      <Salary>999999.00</Salary>   
      <Last_Modified>AAAAAAAAJBM=</Last_Modified>   
    </TVF_EMPLOYEE>  
    <TVF_EMPLOYEE xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/TableFunctionReturnTables/dbo">  
      ......  
      ......  
    </TVF_EMPLOYEE>  
    ......  
    ......  
  </TVF_EMPLOYEEResult>  
</TVF_EMPLOYEEResponse>

Procedure consigliate

Dopo aver distribuito e configurato il progetto BizTalk, è possibile esportare le impostazioni di configurazione in un file XML denominato file di associazione. Dopo aver generato un file di associazione, è possibile importare le impostazioni di configurazione dal file, in modo che non sia necessario creare elementi come le porte di trasmissione e le porte di ricezione per la stessa orchestrazione. Per altre informazioni sui file di associazione, vedere Riutilizzare le associazioni degli adattatori.

Vedere anche

Sviluppare applicazioni BizTalk tramite l'adapter SQL

Condividi tramite