Daten aus Datenbankspalten auswählen

Sie können einen Rechen-, Filter oder Datenbankknoten konfigurieren, um Daten aus Datenbankspalten auszuwählen und in eine Ausgabenachricht einzufügen. Im folgenden Beispiel wird vorausgesetzt, dass Sie über eine Datenbanktabelle mit dem Namen USERTABLE und zwei Spalten vom Datentyp CHAR(6) (oder einem äquivalenten Datentyp) mit dem Namen 'Column1' und 'Column2' verfügen. Die Tabelle enthält zwei Zeilen:

  Column1 Column2
Zeile 1 value1 value2
Zeile 2 value3 value4

Konfigurieren Sie den Rechen-, Filter- oder Datenbankknoten so, dass er die Datenbank, in der Sie die Tabelle definiert haben, identifiziert. Klicken Sie z. B. bei Verwendung der Standarddatenbank (wird über die Knoteneigenschaft Datenquelle angegeben) mit der rechten Maustaste auf den Knoten, wählen Sie ESQL öffnen aus, und codieren Sie die folgenden ESQL-Anweisungen im Modul für diesen Knoten:

SET OutputRoot = InputRoot;
DELETE FIELD OutputRoot.*[<];
SET OutputRoot.XML.Test.Result[] =
  (SELECT T.Column1, T.Column2 FROM Database.USERTABLE AS T);

Dies führt zur Generierung der folgenden Ausgabenachricht:

<Test>
   <Result>
      <Column1>value1</Column1>
      <Column2>value2</Column2>
   </Result>
   <Result>
      <Column1>value3</Column1>
      <Column2>value4</Column2>
   </Result>
</Test>
Um die SELECT-Anweisung auszulösen, senden Sie eine Auslösenachricht mit einem XML-Hauptteil, der das folgende Format hat:
<Test>
   <Result>
      <Column1></Column1>
      <Column2></Column2>
   </Result>
   <Result>
      <Column1></Column1>
      <Column2></Column2>
   </Result>
</Test>

Die genaue Struktur des XML-Codes ist nicht wichtig, aber der einschließende Tag muss <Test> heißen, so dass er mit der Referenz im ESQL-Code übereinstimmt. Ist dies nicht der Fall, führen die ESQL-Anweisungen dazu, dass umschließende Tags auf der obersten Ebene erstellt werden, was in XML nicht gültig ist.

Wenn Sie eine Ausgabenachricht erstellen möchten, die alle Spalten aller Zeilen enthält, die eine bestimmte Bedingung erfüllen, verwenden Sie die SELECT-Anweisung mit einer WHERE-Klausel:

-- Declare and initialize a variable to hold the 
--      test vaue (in this case the surname Smith)
DECLARE CurrentCustomer STRING 'Smith';

-- Loop through table records to extract matching information
SET OutputRoot.XML.Invoice[] = 
    (SELECT R FROM Database.USERTABLE AS R
              WHERE R.Customer.LastName = CurrentCustomer
    );

Die Nachrichtenfelder werden in derselben Reihenfolge erstellt wie die Spalten in der Tabelle angezeigt werden.

Wenn Sie mit SQL in einer Datenbankumgebung vertraut sind, erwarten Sie möglicherweise, dass SELECT * codiert werden kann. Dies wird vom Broker nicht akzeptiert, da alle Verweise auf Spalten mit einem Korrelationsnamen beginnen müssen. Dadurch wird eine Mehrdeutigkeit bei deklarierten Variablen vermieden. Wenn Sie SELECT I.* codieren, wird dies vom Broker akzeptiert, '*' wird jedoch als erstes untergeordnetes Element und nicht als alle Element interpretiert, wie dies zu erwarten ist, wenn man von anderem SQL-Datenbankcode ausgeht.

Eine Zuordnung von Datenbankergebnislisten zu einer parsereigenen Nachrichtenbaumstruktur ist nur möglich, wenn die Ergebnisliste exakt mit der Nachrichtendefinition übereinstimmt. Da der generische XML-Parser selbstdefinierend ist, wird im Beispiel oben eine neue untergeordnete Baumstruktur außerhalb des Rechnungsordners erstellt. Der Parser kann dann die neuen Elemente analysieren. Stimmt die Struktur der Ergebnisliste exakt mit der Nachrichtendefinition überein, kann die Ergebnisliste direkt der Baumstruktur für den Nachrichtentext OutputRoot zugeordnet werden.

Bei nicht genauer Übereinstimmung zwischen der Struktur der Ergebnisliste und der MRM-Nachrichtendefinition müssen Sie zunächst die Ergebnisliste einem Datentyp ROW (Zeile) oder einer Umgebungsbaumstruktur ohne zugeordnete Parser zuordnen.

Die erforderlichen Daten können dann OutputRoot zugeordnet werden, um eine der Nachrichtendefinition entsprechende Nachrichtenbaumstruktur aufzubauen.

Daten aus einer Tabelle in einem Datenbanksystem auswählen, bei dem die Groß-/Kleinschreibung beachtet werden muss

Wenn bei dem Datenbanksystem die Groß-/Kleinschreibung beachtet werden muss, müssen Sie eine andere Methode verwenden. Diese Methode ist auch erforderlich, wenn Sie den Namen des generierten Feldes ändern möchten:

SET OutputRoot = InputRoot;
SET OutputRoot.XML.Test.Result[] =
  (SELECT T.Column1 AS Column1, T.Column2 AS Column2
  FROM Database.USERTABLE AS T);

In diesem Beispiel wird dieselbe Nachricht wie im obigen Beispiel erstellt. Stellen Sie sicher, dass bei den Verweisen auf die Datenbankspalten (in diesem Beispiel 'T.Column1' und 'T.Column2') die Groß-/Kleinschreibung genau mit den Datenbankdefinitionen übereinstimmt. Wenn Sie die Datenbankdefinitionen nicht exakt abgleichen und stattdessen beispielsweise T.COLUMN1 angeben, generiert der Broker einen Laufzeitfehler. Beachten Sie die Verwendung von Column1 und Column2 in der SELECT-Anweisung. Hier können Sie beliebige Werte verwenden, sie müssen im Gegensatz zu diesem Beispiel nicht mit den Namen der Spalten übereinstimmen, die Sie in der Datenbank definiert haben.

Bitstromdaten aus einer Datenbank auswählen

Die folgenden Beispiele zeigen, wie XML-Bitstromdaten aus einer Datenbank abgerufen und in eine Ausgabenachricht eingeschlossen werden. Unter INSERT-Anweisung erhalten Sie Beispiele dazu, wie Bitstromdaten in eine Datenbank eingefügt werden können.

Im folgenden Beispiel befinden sich Bitstromdaten in einer Datenbankspalte mit einem BLOB-Datentyp. Wenn der Bitstrom aus der Datenbank nicht vom Nachrichtenfluss befragt oder geändert werden muss, kann die Ausgabenachricht in der BLOB-Domäne konstruiert werden, wie dies ist im folgenden ESQL-Code zu sehen ist:

CALL CopyMessageHeaders();
  SET Environment.Variables.DBResult = THE( SELECT T.* FROM Database.TABLE1 AS T);
  DECLARE resultRef REFERENCE TO Environment.Variables.DBResult;
  IF LASTMOVE(resultRef) THEN
    SET OutputRoot.Properties.CodedCharSetId = resultRef.MSGCCSID;
    SET OutputRoot.Properties.Encoding = resultRef.MSGENCODING;
    SET OutputRoot.BLOB.BLOB = resultRef.MSGDATA;
  END IF;

Wenn Sie einen Bitstrom, der aus einer Datenbank extrahiert wurde, befragen oder ändern möchten, müssen Sie die ursprüngliche Nachrichtenbaumstruktur erneut erstellen. Um die XML-Nachrichtenbaumstruktur vom Bitstrom neu zu erstellen, können Sie eine CREATE-Anweisung mit einer PARSE-Klausel verwenden. Die Ausgabenachricht kann dann vom Nachrichtenfluss geändert werden. Im folgenden Beispiel wird die Nachrichtenbaumstruktur in der XMLNS-Domäne erneut erstellt:

CALL CopyMessageHeaders();
  SET Environment.Variables.DBResult = THE( SELECT T.* FROM Database.TABLE1 AS T);
  DECLARE resultRef REFERENCE TO Environment.Variables.DBResult;
  IF LASTMOVE(resultRef) THEN
    DECLARE outCCSID INT resultRef.MSGCCSID;
    DECLARE outEncoding INT resultRef.MSGENCODING;
    DECLARE outMsg BLOB resultRef.MSGDATA;
    SET OutputRoot.Properties.CodedCharSetId = outCCSID;
    SET OutputRoot.Properties.Encoding = outEncoding;
    CREATE LASTCHILD OF OutputRoot DOMAIN('XMLNS') PARSE(outMsg, outEncoding, outCCSID);
    -- Nun Nachrichtenbaumstrukturfelder ändern 
    SET OutputRoot.XMLNS.A.B = 4;
    SET OutputRoot.XMLNS.A.E = 5;
  END IF;

Im folgenden Beispiel befinden sich Daten in einer Datenbankspalte mit einem Zeichendatentyp wie z. B. CHAR oder VARCHAR. Mit einer Umsetzung werden die Daten, die aus der Datenbank extrahiert wurden, in das BLOB-Format konvertiert. Wenn der Bitstrom aus der Datenbank nicht vom Nachrichtenfluss befragt oder geändert werden muss, kann die Ausgabenachricht in der BLOB-Domäne ohne Änderungen konstruiert werden.

CALL CopyMessageHeaders();
  SET Environment.Variables.DBResult = THE( SELECT T.* FROM Database.TABLE1 AS T);
  DECLARE resultRef REFERENCE TO Environment.Variables.DBResult;
  IF LASTMOVE(resultRef) THEN
    DECLARE outCCSID INT resultRef.MSGCCSID;
    DECLARE outMsg BLOB CAST(resultRef.MSGDATA AS BLOB CCSID outCCSID);
    SET OutputRoot.Properties.CodedCharSetId = outCCSID;
    SET OutputRoot.Properties.Encoding = resultRef.MSGENCODING;
    SET OutputRoot.BLOB.BLOB = outMsg;
  END IF;

Im folgenden Beispiel befinden sich Daten in einer Datenbankspalte mit einem Zeichendatentyp wie z. B. CHAR oder VARCHAR. Mit einer Umsetzung werden die Daten, die aus der Datenbank extrahiert wurden, in das BLOB-Format konvertiert. Um diese Daten im Nachrichtenfluss zu ändern oder befragen, müssen Sie die ursprüngliche Nachrichtenbaumstruktur erneut erstellen. In diesem Beispiel wird mit einer CREATE-Anweisung mit einer PARSE-Klausel die XML-Nachrichtenbaumstruktur in der XMLNS-Domäne erneut erstellt.

CALL CopyMessageHeaders();
  SET Environment.Variables.DBResult = THE( SELECT T.* FROM Database.TABLE1 AS T);
  DECLARE resultRef REFERENCE TO Environment.Variables.DBResult;
  IF LASTMOVE(resultRef) THEN
    DECLARE outCCSID INT resultRef.MSGCCSID;
    DECLARE outEncoding INT resultRef.MSGENCODING;
    DECLARE outMsg BLOB CAST(resultRef.MSGDATA AS BLOB CCSID outCCSID);
    SET OutputRoot.Properties.CodedCharSetId = outCCSID;
    SET OutputRoot.Properties.Encoding = outEncoding;
    CREATE LASTCHILD OF OutputRoot DOMAIN('XMLNS') PARSE(outMsg, outEncoding, outCCSID);
    -- Nun Nachrichtenbaumstrukturfelder ändern 
    SET OutputRoot.XMLNS.A.B = 4;
    SET OutputRoot.XMLNS.A.E = 5;
  END IF;

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ak05810_