Eseguire operazioni composite nel database Oracle usando BizTalk Server
L'adattatore Oracle Database consente ai client dell'adattatore di eseguire operazioni composite nel database Oracle. Un'operazione composita può includere:
Operazioni di inserimento, aggiornamento, eliminazione e selezione su tabelle e viste.
Stored procedure e funzioni, all'interno o all'esterno di un pacchetto.
Una singola operazione composita può avere un numero qualsiasi di queste operazioni, in qualsiasi ordine. Ad esempio, è possibile avere due inserimenti seguiti da un'eliminazione e infine un'esecuzione di stored procedure. Inoltre, è possibile avere operazioni diverse destinate a tabelle o viste di database diverse. Per altre informazioni su come l'adattatore supporta operazioni composite, vedere Esecuzione di operazioni composite in Oracle Database. Per informazioni sulla struttura del messaggio SOAP per le operazioni composite, vedere Schemi messaggio per l'operazione composita.
Come eseguire operazioni composite su Oracle Database?
L'esecuzione di un'operazione sul database Oracle tramite l'adapter Oracle Database con BizTalk Server comporta attività procedurali descritte in Blocchi predefiniti per sviluppare applicazioni BizTalk con Oracle Database. Per eseguire operazioni composite nel database Oracle, queste attività sono:
Creare un progetto BizTalk in Visual Studio e generare lo schema per tutte le operazioni che si desidera richiamare.
Creare manualmente un file di schema che include riferimenti a tutti gli schemi generati nel passaggio precedente.
Creare messaggi nel progetto BizTalk per l'invio e la ricezione di messaggi dal database Oracle. Questi messaggi devono essere conformi allo schema di richiesta e risposta creato nel passaggio precedente.
Creare un'orchestrazione per richiamare l'operazione composita nel database Oracle.
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 su come eseguire queste attività.
Generazione dello schema
In questo argomento, per illustrare come eseguire operazioni composite, verranno eseguite le attività seguenti nello stesso ordine:
Inserire il record nella tabella ACCOUNTACTIVITY.
Recuperare tutti i record nella tabella ACCOUNTACTIVITY richiamando la routine GET_ALL_ACTIVITY all'interno del pacchetto ACCOUNT_PKG.
Eliminare il record dalla tabella ACCOUNTACTIVITY.
Eseguire gli script forniti con gli esempi per creare la tabella ACCOUNTACTIVITY. Per altre informazioni sugli esempi, vedere Esempi di schemi.
È 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 Recuperare i metadati per le operazioni di Oracle Database in Visual Studio .
Creazione di una definizione di schema composito
È ora necessario creare uno schema composito nel progetto BizTalk di Visual Studio che fa riferimento agli schemi creati per le singole operazioni. Per creare una definizione di schema composito, seguire questa procedura.
Per aggiungere una definizione di schema composito
Aggiungere un file di schema al progetto BizTalk in Visual Studio. Fare clic con il pulsante destro del mouse sul nome della soluzione, scegliere Aggiungi e quindi fare clic su Nuovo elemento. Nella finestra di dialogo Aggiungi nuovo elemento , nella casella Categorie fare clic su File di schema. Nella casella Modelli fare clic su Schema. Specificare un nome per il file di schema e fare clic su OK.
Per questo esempio, specificare il nome del file di schema come
CompositeSchema.xsd.Aggiungere riferimenti allo schema generato per le diverse operazioni da eseguire. In questo esempio, i diversi schemi generati per le operazioni sono:
OracleDBBinding.xsd, per operazioni di inserimento ed eliminazione nella tabella ACCOUNTACTIVITY.
OracleDBBinding2.xsd, per la procedura di GET_ALL_ACTIVITY.
Per aggiungere riferimenti:
Fare clic con il pulsante destro del mouse sul nodo schema> radice< in CompositeSchema.xsd e scegliere Proprietà.
Nella casella Proprietà fare clic sul pulsante con i puntini di sospensione (...) sulla proprietà Imports .
Nella finestra di dialogo Importa nuovo schema come elenco della finestra di dialogo Importa nuovo schema selezionare Importazione XSD e quindi fare clic su Aggiungi.
Nella finestra di dialogo Selezione tipi BizTalk espandere il nodo del nome del progetto BizTalk, espandere Schemi e quindi selezionare lo schema da importare. Per questo esempio, selezionare <BizTalk_project_name>. OracleDBBinding.xsd. Fare clic su OK.
Ripetere questo passaggio per importare <BizTalk_project_name>. Anche OracleDBBinding2.xsd.
Nella finestra di dialogo Importazioni fare clic su OK.
Aggiungere due nodi figlio al nodo dello schema radice. Un nodo figlio corrisponde allo schema di richiesta per eseguire l'operazione composita. L'altro nodo figlio corrisponde allo schema di risposta. Il nodo che corrisponde allo schema di richiesta può avere qualsiasi nome. Il nodo che corrisponde allo schema di risposta deve essere chiamato <request_schema_node>Response. Per questo esempio si chiamerà il nodo dello schema della richiesta come Richiesta. Il nodo dello schema di risposta è quindi denominato RequestResponse.
Nota
Per impostazione predefinita, viene aggiunto anche un nodo Radice a un nuovo file di schema. È possibile rinominare il nodo Radice in Richiesta. Per rinominare un nodo, fare clic con il pulsante destro del mouse sul nome del nodo e scegliere Rinomina.
Per aggiungere un nodo nel <nodo Schema> :
Fare clic con il pulsante destro del mouse sul <nodo Schema> , scegliere Inserisci nodo schema e fare clic su Record figlio.
Rinominare il nuovo nodo in RequestResponse.
Aggiungere nodi figlio nel nodo Richiesta che corrispondono allo schema di richiesta per ogni operazione che verrà eseguita come parte dell'operazione composita. Per questo esempio, è necessario aggiungere nodi figlio corrispondenti ai seguenti:
Operazioni di inserimento ed eliminazione nella tabella ACCOUNTACTIVITY.
GET_ALL_ACTIVITY procedura.
Importante
È necessario aggiungere i nodi nello stesso ordine in cui si desidera eseguire le operazioni. Ad esempio, se si desidera inserire un record, eseguire una stored procedure e quindi eliminare un record, è necessario innanzitutto aggiungere un nodo per l'operazione Di inserimento, seguito da un nodo per la stored procedure e infine da un nodo per l'operazione Di eliminazione.
Per aggiungere nodi figlio al nodo Richiesta :
Fare clic con il pulsante destro del mouse sul nodo Richiesta , scegliere Inserisci nodo schema e quindi fare clic su Record figlio.
Rinominare il record in modo che corrisponda a uno schema di richiesta per un'operazione eseguita come parte dell'operazione composita. Ad esempio, rinominare il nodo in "Inserisci".
Eseguire il mapping del nodo Insert allo schema di richiesta per l'operazione Di inserimento nella tabella ACCOUNTACTIVITY. A tale scopo, fare clic con il pulsante destro del mouse sul nodo Inserisci e scegliere Proprietà. Nella casella Proprietà selezionare Inserisci (riferimento) nell'elenco Tipo struttura dati.
Eseguire il mapping dei Ripetere questi passaggi per aggiungere nodi per gli schemi di richiesta per GET_ALL_ACTIVITY stored procedure e l'operazione Delete. Specificare i nomi dei nodi ed eseguirne il mapping allo schema corrispondente, come indicato nella tabella seguente.
Nome nodo Mappato allo schema GET_ALL_ACTIVITY GET_ALL_ACTIVITY (riferimento) Delete Elimina (riferimento)
Aggiungere nodi figlio nel nodo RequestResponse che corrispondono allo schema di risposta per ogni operazione che verrà eseguita come parte dell'operazione composita. Per questo esempio, è necessario aggiungere nodi figlio corrispondenti ai seguenti:
Operazioni di inserimento ed eliminazione nella tabella ACCOUNTACTIVITY.
GET_ALL_ACTIVITY stored procedure.
Importante
È necessario aggiungere i nodi figlio nello stesso ordine dei nodi figlio nel nodo Richiesta .
Per aggiungere nodi figlio al nodo RequestResponse :
Fare clic con il pulsante destro del mouse sul nodo RequestResponse , scegliere Inserisci nodo schema e fare clic su Record figlio.
Rinominare il record in modo che corrisponda a uno schema di risposta per un'operazione eseguita come parte dell'operazione composita. Ad esempio, rinominare il nodo in "InsertResponse".
Eseguire il mapping del nodo InsertResponse allo schema di risposta per l'operazione Di inserimento nella tabella ACCOUNTACTIVITY. A tale scopo, fare clic con il pulsante destro del mouse sul nodo InsertResponse e scegliere Proprietà. Nella casella Proprietàselezionare InsertResponse (Riferimento) nell'elenco Tipo struttura dati.
Ripetere questi passaggi per aggiungere nodi per gli schemi di risposta per la stored procedure GET_ALL_ACTIVITY e l'operazione Delete. Specificare i nomi dei nodi ed eseguirne il mapping allo schema corrispondente, come indicato nella tabella seguente.
Nome nodo Mappato allo schema GET_ALL_ACTIVITYResponse GET_ALL_ACTIVITYResponse (riferimento) Deleteresponse DeleteResponse (riferimento)
Salvare il file CompositeSchema.xsd .
Definizione di messaggi e tipi di messaggio
Lo schema composito creato nell'ultimo passaggio descrive i "tipi" necessari per i messaggi in un'orchestrazione. Un messaggio è in genere una variabile, il tipo per il quale è definito dallo schema corrispondente. È ora necessario creare messaggi per l'orchestrazione e collegarli allo schema creato nel passaggio precedente.
Per creare messaggi e collegarsi allo schema
Aggiungere un'orchestrazione al progetto BizTalk in Visual Studio. 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 RequestTipo di messaggio Nell'elenco a discesa espandere Schemi e quindi selezionare Composite_Op.CompositeSchema.Request, dove Composite_Op è il nome del progetto BizTalk. CompositeSchema è lo schema creato manualmente per le operazioni composite. Ripetere il passaggio 2 per creare un nuovo messaggio. Nel riquadro Proprietà per il nuovo messaggio eseguire le operazioni seguenti:
Usare Per Identificatore Digitare ResponseTipo di messaggio Nell'elenco a discesa espandere Schemi e quindi selezionare Composite_Op.CompositeSchema.RequestResponse.
Configurazione dell'orchestrazione
È necessario creare un'orchestrazione BizTalk per usare BizTalk Server per eseguire operazioni composite nel database Oracle. In questa orchestrazione si rilascia un messaggio di richiesta in una posizione di ricezione definita. Il messaggio di richiesta deve essere conforme allo schema composito creato in precedenza. L'adapter Oracle Database utilizza questo messaggio e lo passa al database Oracle. La risposta dal database Oracle viene salvata in un'altra posizione. È necessario includere le forme Send and Receive per inviare messaggi al database Oracle e ricevere risposte, rispettivamente. Un'orchestrazione di base per l'esecuzione di operazioni composite è simile alla seguente:
Aggiunta di forme messaggio
Assicurarsi di specificare 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 |
Aggiunta di porte
Assicurarsi di specificare 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 |
Specificare 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.CompositeOp.Request |
| SendMessage | - Impostare il messaggio su Richiesta - Impostare l'operazione su LOBPort.CompositeOp.Request |
| ReceiveResponse | - Impostare il messaggio su Risposta - Impostare l'operazione su LOBPort.CompositeOp.Response |
| SendResponse | - Impostare il messaggio su Risposta - Impostare l'operazione su ResponseOut.CompositeOp.Request |
Dopo aver specificato queste proprietà, le forme e le porte del messaggio sono connesse e l'orchestrazione è completata.
È ora necessario compilare la soluzione BizTalk e distribuirla in un BizTalk Server. Per altre informazioni, vedere Compilazione ed esecuzione di orchestrazioni.
Configurazione dell'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 Oracle.
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 Oracle.
Definire un WCF-Custom fisico o WCF-OracleDB porta di trasmissione per inviare messaggi al database Oracle. Poiché le operazioni che fanno parte dell'operazione composita vengono eseguite in una singola transazione, assicurarsi che la proprietà di associazione UseAmbientTransaction sia impostata su True.
È inoltre necessario specificare l'azione nella porta di trasmissione. L'azione per un'operazione composita è "<http://Microsoft.LobServices.OracleDB/2007/03/CompositeOperation".> Per informazioni su come creare porte, vedere Configurare manualmente un'associazione di porte fisiche all'adapter di database Oracle. Per altre informazioni su come specificare le azioni per le porte, vedere Configurare l'azione SOAP per Oracle Database.
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 a Oracle Database. Se si importa questo file di associazione, l'azione sulla porta di trasmissione viene impostata su un'azione dinamica che coinvolge tutte le operazioni selezionate nel componente aggiuntivo Consume Adapter Service durante la generazione dello schema. Per un'operazione composita, è necessario sostituire l'azione dinamica con "<http://Microsoft.LobServices.OracleDB/2007/03/CompositeOperation".>
Avvio dell'applicazione
È necessario avviare l'applicazione BizTalk per eseguire operazioni composite nel database Oracle. 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.
Il WCF-Custom o WCF-OracleDB porta di trasmissione per l'invio di messaggi al database Oracle è in esecuzione.
L'orchestrazione BizTalk per l'operazione è in esecuzione.
Esecuzione dell'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 le operazioni composite create in precedenza. Ad esempio, un messaggio di richiesta che inserisce un record nella tabella ACCOUNTACTIVITY, richiama la stored procedure GET_ALL_ACTIVITY ed elimina un record dalla tabella ACCOUNTACTIVITY:
<Request xmlns="http://Composite_Op.CompositeSchema">
<Insert xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY">
<RECORDSET>
<ACCOUNTACTIVITYRECORDINSERT>
<TID>1</TID>
<ACCOUNT>100001</ACCOUNT>
<AMOUNT>1500</AMOUNT>
<DESCRIPTION></DESCRIPTION>
<TRANSDATE>2008-06-21T15:52:19</TRANSDATE>
<PROCESSED>n</PROCESSED>
</ACCOUNTACTIVITYRECORDINSERT >
</RECORDSET>
</Insert>
<GET_ALL_ACTIVITY xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG"/>
<Delete xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY">
<FILTER>WHERE AMOUNT = 1500</FILTER>
</Delete>
</Request>
Il messaggio di richiesta precedente inserisce prima un record e quindi richiama la routine GET_ALL_ACTIVITY per ottenere tutti i record nella tabella ACCOUNTACTIVITY. Il record inserito viene quindi eliminato specificando una clausola FILTER. Per altre informazioni sullo schema dei messaggi di richiesta per l'esecuzione di operazioni composite nel database Oracle tramite l'adapter Oracle Database, vedere Schemi messaggio per l'operazione composita .
L'orchestrazione utilizza il messaggio e lo invia al database Oracle. La risposta del database Oracle viene salvata nell'altra posizione FILE definita come parte dell'orchestrazione. Ad esempio, la risposta del database Oracle per il messaggio di richiesta precedente è simile alla seguente:
<?xml version="1.0" encoding="utf-8" ?>
<RequestResponse xmlns="http://Composite_Op.CompositeSchema">
<InsertResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOOT/Table/ACCOUNTACTIVITY">
<InsertResult>1</InsertResult>
</InsertResponse>
<GET_ALL_ACTIVITYResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG">
<ALLRECS>
<xs:schema id="NewDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element msdata:IsDataSet="true" name="NewDataSet">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="unbounded" name="NewTable">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="TID" type="xs:decimal" />
<xs:element minOccurs="0" name="ACCOUNT" type="xs:decimal" />
<xs:element minOccurs="0" name="AMOUNT" type="xs:decimal" />
<xs:element minOccurs="0" name="DESCRIPTION" type="xs:string" />
<xs:element minOccurs="0" name="TRANSDATE" type="xs:dateTime" />
<xs:element minOccurs="0" name="PROCESSED" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
<diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<NewTable>
......
......
</NewTable>
......
......
<NewTable>
<TID>10</TID>
<ACCOUNT>100001</ACCOUNT>
<AMOUNT>1000</AMOUNT>
<TRANSDATE>2008-07-28T21:39:57</TRANSDATE>
<PROCESSED>n</PROCESSED>
</NewTable>
</NewDataSet>
</diffgr:diffgram>
</ALLRECS>
</GET_ALL_ACTIVITYResponse>
<DeleteResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY">
<DeleteResult>1</DeleteResult>
</DeleteResponse>
</RequestResponse>
La risposta precedente contiene più set di risultati corrispondenti alle diverse operazioni eseguite come parte dell'operazione composita. Ad esempio, l'elemento InsertResult contiene "1", che indica il numero di righe inserite dall'operazione Di inserimento. Analogamente, l'elemento DeleteResult contiene "1", che indica il numero di righe eliminate dall'operazione Delete.
Importante
Se si verificano problemi di timeout durante l'esecuzione di un'operazione composita, il numero di connessioni è inferiore al numero di operazioni in un'operazione composita che coinvolge:
Stored procedure contenenti parametri BFILE, BLOB, CLOB, NCLOB e REF CURSOR come OUT o IN OUT.
- Selezionare l'operazione.
Per risolvere questo problema, è necessario assicurarsi che se è presente un numero "n" di tali operazioni in un'operazione composita, il valore specificato per la proprietà di associazione MinPoolSize è "n+1" o superiore. Per altre informazioni sulla proprietà di associazione MinPoolSize, vedere Working with binding properties .For more information about the MinPoolSize binding property, see Working with binding properties.
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 di database Oracle.
Vedere anche
Blocchi predefiniti per sviluppare applicazioni BizTalk con Oracle Database
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per