Aufrufen von Funktionen und Prozeduren mit REF CURSORS in Oracle Database mithilfe von BizTalk Server

Artikel
10/14/2023

Ein REF CURSOR ist ein PL/SQL-Datentyp, der einen Zeiger auf ein serverseitiges Resultset darstellt, das durch ausführen einer Abfrage generiert wird. Ein REF CURSOR-Typ ermöglicht das Ein- und Ausgabestreaming von Daten und eignet sich ideal für die Übertragung großer Datenmengen in und aus einem PL/SQL-Code. Der Oracle Database-Adapter bietet Unterstützung für stark typisierte und schwach typisierte REF-CURSORs (SYS_REFCURSOR), die als IN-, OUT- oder IN OUT-Parameter an PL/SQL-Prozeduren und -Funktionen übergeben werden können. Weitere Informationen dazu, wie der Oracle Database-Adapter REF CURSORs unterstützt, finden Sie unter Vorgänge für Funktionen und Prozeduren mit REF CURSOR-Parametern. Informationen zur XML-Struktur für REF CURSORS finden Sie unter Nachrichtenschemas für REF CURSORS.

Aufrufen von Funktionen in einer Oracle-Datenbank

Das Ausführen eines Vorgangs für eine Oracle-Datenbank mithilfe des Oracle Database-Adapters mit BizTalk Server umfasst prozedurale Aufgaben, die unter Bausteine zum Entwickeln von BizTalk-Anwendungen mit Oracle-Datenbank beschrieben sind. Um eine Funktion in einer Oracle-Datenbank aufzurufen, die REF CURSOR als Parameter verwendet und REF CURSOR als Out-Parameter angibt, sind die folgenden Aufgaben:

Erstellen Sie ein BizTalk-Projekt, und generieren Sie ein Schema für die Funktion, die Sie in einer Oracle-Datenbank aufrufen möchten.
Erstellen Sie Nachrichten im BizTalk-Projekt zum Senden und Empfangen von Nachrichten aus der Oracle-Datenbank.
Erstellen Sie eine Orchestrierung, um die Funktion in der Oracle-Datenbank aufzurufen.
Erstellen und Bereitstellen des BizTalk-Projekts.
Konfigurieren Sie die BizTalk-Anwendung, indem Sie physische Sende- und Empfangsports erstellen.
Starten Sie die BizTalk-Anwendung.

Dieses Thema enthält Anweisungen zum Ausführen dieser Aufgaben.

Beispiel basierend auf diesem Thema

Ein beispiel, Func_RefCursor, das auf diesem Thema basiert, wird auch mit dem BizTalk Adapter Pack bereitgestellt. Weitere Informationen finden Sie unter Adapterbeispiele.

Generieren eines Schemas

In diesem Thema wird die GET_ACTIVITY-Prozedur aufgerufen, um zu veranschaulichen, wie der Oracle Database-Adapter die Aufruffunktion unterstützt, die REF CURSOR-Parameter akzeptiert. Dieses Verfahren verwendet einen schwach typisierten IN REF CURSOR und einen stark typisierten IN OUT REF CURSOR als Parameter. Die Funktion gibt einen status, einen schwach typisierten OUT REF CURSOR und einen stark typisierten IN OUT REF CURSOR zurück. Die GET_ACTIVITY-Prozedur ist als Teil der ACCOUNT_PKG verfügbar, die durch Ausführen der mit den Beispielen bereitgestellten SQL-Skripts erstellt wird. Weitere Informationen zu den Beispielen und den SQL-Skripts finden Sie unter Schemabeispiele.

Um also die GET_ACTIVITY-Prozedur aufzurufen, generieren wir ein Schema für dieselbe Prozedur unter dem Schema SCOTT\Package\ACCOUNT_PKG. Weitere Informationen zum Generieren eines Schemas finden Sie unter Abrufen von Metadaten für Oracle Database-Vorgänge in Visual Studio .

Definieren von Nachrichten und Nachrichtentypen

Das zuvor generierte Schema beschreibt die "Typen", die für die Nachrichten in der Orchestrierung erforderlich sind. Eine Nachricht ist in der Regel eine Variable, deren Typ durch das entsprechende Schema definiert wird. Sie müssen das schema, das Sie im ersten Schritt generiert haben, mit den Nachrichten aus dem Fenster Orchestrierungsansicht des BizTalk-Projekts verknüpfen.

Für dieses Thema müssen Sie zwei Nachrichten erstellen: eine, um eine Anforderung an die Oracle-Datenbank zu senden, und die andere, um eine Antwort zu erhalten.

Führen Sie die folgenden Schritte aus, um Nachrichten zu erstellen und sie mit dem Schema zu verknüpfen:

So erstellen Sie Nachrichten und verknüpfen mit dem Schema

Öffnen Sie das Fenster Orchestrierungsansicht des BizTalk-Projekts, wenn dieses nicht bereits geöffnet ist. Klicken Sie hierzu auf Ansicht, zeigen Sie auf Andere Fenster, und klicken Sie dann auf Orchestrierungsansicht.
Klicken Sie in der Orchestrierungsansicht mit der rechten Maustaste auf Nachrichten, und klicken Sie dann auf Neue Nachricht.
Klicken Sie mit der rechten Maustaste auf die neu erstellte Nachricht, und wählen Sie dann Eigenschaftenfenster aus.

Führen Sie im Bereich Eigenschaften für Message_1 die folgenden Schritte aus:

Option	Aufgabe
Bezeichner	Geben Sie Request ein.
Nachrichtentyp	Erweitern Sie in der Dropdownliste Schemas, und wählen Sie Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITY aus, wobei Func_RefCursor der Name Ihres BizTalk-Projekts ist. OracleDBBindingSchema ist das Schema, das für die GET_ACTIVITY-Prozedur generiert wird.

Wiederholen Sie den vorherigen Schritt, um eine neue Nachricht zu erstellen. Gehen Sie im Bereich Eigenschaften für die neue Nachricht wie folgt vor:

Option Aufgabe

Bezeichner Geben Sie Antwort ein.

Nachrichtentyp Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITYResponse

Option	Aufgabe
Bezeichner	Geben Sie Antwort ein.
Nachrichtentyp	Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITYResponse

Einrichten der Orchestrierung

Sie müssen eine BizTalk-Orchestrierung erstellen, um BizTalk Server zum Aufrufen einer Prozedur mit REF CURSOR-Parametern zu verwenden. In dieser Orchestrierung löschen Sie eine Anforderungsnachricht an einem definierten Empfangsspeicherort. Der Oracle Database-Adapter nutzt diese Nachricht und gibt sie über ODP an die Oracle-Datenbank weiter. Die Antwort aus der Oracle-Datenbank wird an einem anderen Speicherort gespeichert. Eine typische Orchestrierung zum Aufrufen von Funktionen und Prozeduren mit REF CURSORs enthält Folgendes:

Senden und Empfangen von Shapes, um Nachrichten an Oracle-Datenbank zu senden und Antworten zu empfangen.
Ein unidirektionale Empfangsport zum Empfangen von Anforderungsnachrichten, die an die Oracle-Datenbank gesendet werden sollen.
Ein bidirektionales Sendeport zum Senden von Anforderungsnachrichten an die Oracle-Datenbank und zum Empfangen von Antworten.
Ein unidirektionale Sendeport, um die Antworten aus der Oracle-Datenbank an einen Ordner zu senden.

Eine Beispielorchestrierung ähnelt der folgenden:

Hinzufügen von Nachrichten-Shapes

Stellen Sie sicher, dass Sie die folgenden Eigenschaften für die einzelnen Nachrichtenformen angeben. Die in der Spalte Shape aufgeführten Namen sind die Namen der Nachrichtenformen, die in der gerade erwähnten Orchestrierung angezeigt werden.

Form	Formtyp	Eigenschaften
ReceiveMessage	Empfangen	– Name aufReceiveMessage festlegen – Legen Sie Aktivieren auf True fest.
SendMessage	Send	– Name aufSendMessage festlegen
ReceiveResponse	Empfangen	– Name aufReceiveResponse festlegen – Legen Sie Aktivieren auf False fest.
SendResponse	Send	– Name aufSendResponse festlegen

Hinzufügen von Ports

Stellen Sie sicher, dass Sie die folgenden Eigenschaften für jeden der logischen Ports angeben. Die in der Spalte Port aufgeführten Namen sind die Namen der Ports, die in der Orchestrierung angezeigt werden.

Port	Eigenschaften
FileIn	– Festlegen des Bezeichners auf FileIn – Festlegen von Type auf FileInType - Festlegen des Kommunikationsmusters auf unidirektionales Muster - Festlegen der Kommunikationsrichtung auf Empfangen
LOBPort	– Festlegen des Bezeichners auf LOBPort – Legen Sie Type auf LOBPortType fest. – Festlegen des Kommunikationsmusters auf Request-Response – Festlegen der Kommunikationsrichtung auf Senden/Empfangen
SaveResponse	– Bezeichner auf SaveResponse festlegen – Legen Sie Type auf SaveResponseType fest. – Festlegen des Kommunikationsmusters auf Unidirektionale – Kommunikationsrichtung auf Senden festlegen

Geben Sie Nachrichten für Aktions-Shapes an, und verbinden Sie sie mit Ports.

In der folgenden Tabelle sind die Eigenschaften und deren Werte angegeben, die Sie festlegen sollten, um Nachrichten für Aktions-Shapes anzugeben und sie mit den Ports zu verknüpfen. Die in der Spalte Shape aufgeführten Namen sind die Namen der Meldungs-Shapes, die in der zuvor erwähnten Orchestrierung angezeigt werden.

Form	Eigenschaften
ReceiveMessage	– Nachricht aufAnforderung festlegen – Legen Sie Operation auf FileIn.REFCURSOR.Request fest.
SendMessage	– Nachricht aufAnforderung festlegen – Legen Sie Operation auf LOBPort.REFCURSOR.Request fest.
ReceiveResponse	– Nachricht aufAntwort festlegen – Legen Sie Operation auf LOBPort.REFCURSOR.Response fest.
SendResponse	– Nachricht aufAntwort festlegen – Legen Sie Operation auf SaveResponse.REFCURSOR.Request fest.

Nachdem Sie diese Eigenschaften angegeben haben, werden die Nachrichtenformen und Ports verbunden, und Die Orchestrierung ist abgeschlossen.

Sie müssen nun die BizTalk-Lösung erstellen und in einem BizTalk Server bereitstellen. Weitere Informationen finden Sie unter Erstellen und Ausführen von Orchestrierungen.

Konfigurieren der BizTalk-Anwendung

Nachdem Sie das BizTalk-Projekt bereitgestellt haben, wird die zuvor erstellte Orchestrierung in der BizTalk Server Verwaltungskonsole im Bereich Orchestrierungen aufgeführt. Sie müssen die BizTalk Server-Verwaltungskonsole verwenden, um die Anwendung zu konfigurieren. Eine exemplarische Vorgehensweise finden Sie unter Exemplarische Vorgehensweise: Bereitstellen einer einfachen BizTalk-Anwendung.

Das Konfigurieren einer Anwendung umfasst Folgendes:

Auswählen eines Hosts für die Anwendung.
Zuordnen der Ports, die Sie in Ihrer Orchestrierung erstellt haben, zu physischen Ports in der BizTalk Server-Verwaltungskonsole. Für diese Orchestrierung müssen Sie:
- Definieren Sie einen Speicherort auf der Festplatte und einen entsprechenden Dateiport, an dem Sie eine Anforderungsnachricht ablegen. Die BizTalk-Orchestrierung nutzt die Anforderungsnachricht und sendet sie an die Oracle-Datenbank.
- Definieren Sie einen Speicherort auf der Festplatte und einen entsprechenden Dateiport, an dem die BizTalk-Orchestrierung die Antwortnachricht mit der Antwort aus der Oracle-Datenbank abgibt.
- Definieren Sie einen physischen WCF-Custom oder WCF-OracleDB Sendeport, um Nachrichten an die Oracle-Datenbank zu senden. Sie müssen die Aktion auch im Sendeport angeben. Informationen zum Erstellen WCF-Custom oder WCF-OracleDB Ports finden Sie unter Manuelles Konfigurieren der physischen Portbindung an den Oracle Database Adapter.
  
  Hinweis
  
  Beim Generieren des Schemas mithilfe des BizTalk-Projekt-Add-Ins "Consume Adapter Service" wird auch eine Bindungsdatei erstellt, die Informationen zu den Ports und den aktionen enthält, die für diese Ports festgelegt werden sollen. Sie können diese Bindungsdatei aus der BizTalk Server-Verwaltungskonsole importieren, um Sendeports (für ausgehende Anrufe) oder Empfangsports (für eingehende Anrufe) zu erstellen. Weitere Informationen finden Sie unter Konfigurieren der physischen Portbindung mithilfe der Portbindungsdatei für Oracle Database.

Starten der Anwendung

Sie müssen die BizTalk-Anwendung zum Aufrufen einer Prozedur in einer Oracle-Datenbanktabelle starten. Anweisungen zum Starten einer BizTalk-Anwendung finden Sie unter Starten einer Orchestrierung.

Stellen Sie in dieser Phase Folgendes sicher:

Der FILE-Empfangsport zum Empfangen von Anforderungsmeldungen für die Orchestrierung wird ausgeführt.
Der FILE-Sendeport zum Empfangen der Antwortnachrichten von der Orchestrierung wird ausgeführt.
Der WCF-Custom oder WCF-OracleDB Sendeport zum Senden von Nachrichten an die Oracle-Datenbank wird ausgeführt.
Die BizTalk-Orchestrierung für den Vorgang wird ausgeführt.

Ausführen des Vorgangs

Nachdem Sie die Anwendung ausgeführt haben, müssen Sie eine Anforderungsnachricht am File-Empfangsspeicherort ablegen. Das Schema für die Anforderungsnachricht muss dem Schema für die zuvor generierte Prozedur entsprechen. Weitere Informationen zum Anforderungsnachrichtenschema zum Aufrufen von Funktionen mithilfe des Oracle Database-Adapters finden Sie unter Nachrichtenschemas für Funktionen und Prozeduren .

Um die GET_ACTIVITY-Prozedur aufzurufen, müssen Sie einen schwach typisierten IN REF CURSOR und einen stark typisierten IN OUT REF CURSOR als Parameter angeben. Die Anforderungsnachricht zum Aufrufen dieser Prozedur lautet also:

<GET_ACTIVITY xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG">  
  <INRECS>BEGIN OPEN ? FOR SELECT * FROM ACCOUNTACTIVITY WHERE ACCOUNT=100001; END;</INRECS>  
  <INOUTRECS_IN>BEGIN ACCOUNT_PKG.GET_ALL_ACTIVITY(?); END;</INOUTRECS_IN>  
</GET_ACTIVITY>

Die Orchestrierung nutzt die Anforderungsnachricht und sendet sie an die Oracle-Datenbank. Die Antwort aus der Oracle-Datenbank wird am anderen FILE-Speicherort gespeichert, der als Teil der Orchestrierung definiert ist.

Die Antwort für die obige Anforderungsnachricht lautet:

<?xml version="1.0" encoding="utf-8" ?>   
<GET_ACTIVITYResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG">  
  <STATUS>5</STATUS>   
  <INOUTRECS>  
    <INOUTRECSRECORD xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG/GET_ACTIVITY">  
      <TID>1</TID>   
      <ACCOUNT>100001</ACCOUNT>   
      <AMOUNT>500</AMOUNT>   
      <DESCRIPTION />   
      <TRANSDATE>2007-10-16T16:58:44</TRANSDATE>   
      <PROCESSED>n</PROCESSED>   
    </INOUTRECSRECORD>  
    <INOUTRECSRECORD xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG/GET_ACTIVITY">  
      .....   
      .....   
    </INOUTRECSRECORD>  
    ....  
    ....  
  </INOUTRECS>  
  <OUTRECS>  
    <GenRecordRow xmlns="http://Microsoft.LobServices.OracleDB/2007/03">  
      <GenRecordColumn>  
        <GenRecordColumn>  
          <ColumnName>TID</ColumnName>   
          <ColumnValue>1</ColumnValue>   
          <ColumnType>System.Decimal</ColumnType>   
        </GenRecordColumn>  
        <GenRecordColumn>  
          ....   
        </GenRecordColumn>  
        .....  
        .....  
      </GenRecordColumn>  
    </GenRecordRow>  
    <GenRecordRow xmlns="http://Microsoft.LobServices.OracleDB/2007/03">  
      .....  
      .....  
    </GenRecordRow>  
    .....  
    .....  
  </OUTRECS>  
</GET_ACTIVITYResponse>

Beachten Sie, dass die Antwort eine status, einen schwach typisierten OUT REF CURSOR und einen stark typisierten IN OUT REF CUROSR enthält.

Mögliche Ausnahmen

Informationen zu den Ausnahmen, die beim Aufrufen von Funktionen und Prozeduren mithilfe von BizTalk Server auftreten können, finden Sie unter Ausnahmen und Fehlerbehandlung.

Bewährte Methoden

Nachdem Sie das BizTalk-Projekt bereitgestellt und konfiguriert haben, können Sie Konfigurationseinstellungen in eine XML-Datei exportieren, die als Bindungsdatei bezeichnet wird. Nachdem Sie eine Bindungsdatei generiert haben, können Sie die Konfigurationseinstellungen aus der Datei importieren, sodass Sie die Sendeports, Empfangsports usw. für dieselbe Orchestrierung nicht erstellen müssen. Weitere Informationen zu Bindungsdateien finden Sie unter Wiederverwenden von Oracle Database Adapter-Bindungen.

Weitere Informationen

Entwickeln von BizTalk-Anwendungen

Freigeben über