Verwenden Sie den DatabaseRetrieve-Knoten, um sicherzustellen, dass die Informationen in einer Nachricht aktuell sind.
Dieses Thema enthält folgende Abschnitte:
Verwenden Sie den DatabaseRetrieve-Knoten, um eine Nachricht mit Informationen aus einer Datenbank zu modifizieren. Beispielsweise können Sie mit Hilfe eines Schlüssels, der in einer Nachricht enthalten ist, Informationen zu einer Nachricht hinzufügen; bei dem Schlüssel kann es sich z.B. um eine Accountnummer handeln.
Der DatabaseRetrieve-Knoten befindet sich im Ablagefach Database (Datenbank) der Nachrichtenflussknotenpalette und wird in Workbench durch folgendes Symbol dargestellt:
Anhand des Beispielprogramms Beispielprogramm 'Simplified Database Routing' wird die Verwendung dieses Knotens deutlich. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
| Java | JDBC |
|---|---|
| Ganzzahl | INTEGER (Ganze Zahl) |
| Long | BIGINT |
| Double | DOUBLE |
| BigDecimal | NUMERIC |
| Boolescher Wert | BIT |
| byte[] | VARBINARY oder LONGVARBINARY |
| BitSet | VARBINARY oder LONGVARBINARY |
| Zeichenfolge | VARCHAR oder LONGVARCHAR |
| MbTime | java.sql.Time |
| MbTimestamp | java.sql.Timestamp |
| MbDate | java.sql.Date |
| JDBC | Java | ESQL-Typ |
|---|---|---|
| SMALLINT | Ganzzahl | INTEGER (Ganze Zahl) |
| INTEGER (Ganze Zahl) | Ganzzahl | INTEGER (Ganze Zahl) |
| BIGINT | Long | DECIMAL |
| DOUBLE | Double | FLOAT (Gleitkommazahl) |
| REAL | Double | FLOAT (Gleitkommazahl) |
| FLOAT (Gleitkommazahl) | Double | FLOAT (Gleitkommazahl) |
| NUMERIC | BigDecimal | DECIMAL |
| DECIMAL | BigDecimal | DECIMAL |
| BIT | Boolescher Wert | Boolesch |
| Boolesch | Boolescher Wert | Boolesch |
| BINARY | byte[] | BLOB (Binary large object) |
| VARBINARY | byte[] | BLOB (Binary large object) |
| LONGVARBINARY | byte[] | BLOB (Binary large object) |
| CHAR (Zeichen) | Zeichenfolge | CHARACTER |
| VARCHAR | Zeichenfolge | CHARACTER |
| LONGVARCHAR | Zeichenfolge | CHARACTER |
| TINYINT | byte[1] | BLOB (Binary large object) |
| TIME | java.util.Date | TIME |
| TIMESTAMP | java.util.Date | TIMESTAMP |
| DATE | java.util.Date | DATE |
Wenn ein Fehler im XPath-Ausdruck eines Musters festgestellt wird, wird dieser Fehler bei der Auswertung im Workbench gemeldet. In der Fehlernachricht ist möglicherweise der fehlerhafte Ausdruck und der eindeutige Name des zugehörigen dynamischen oder statischen Terminals angegeben, oder die Zeichenfolge ist als fehlerhaft in der Tabelle markiert.
Der DatabaseRetrieve-Knoten sucht Werte in einer Datenbank und speichert sie als Elemente in den Baumstrukturen der Ausgabenachrichtenassemblierung. Der von der Datenbank in Form von Ausgabespaltenwerten abgerufene Informationstyp, der durch SQL-Abfragen abgerufen und in deren Ergebnismengen zurückgegeben wird, wird zunächst in einen passenden Java-Typ und danach in einen internen Nachrichtenelement-Wertetyp konvertiert und schließlich in der Baumstruktur einer Ausgabenachrichtenassemblierung gespeichert. Wenn ein Nachrichtenelement bereits in der Baumstruktur der ausgehenden Nachrichten vorhanden ist, wird der alte Wert durch den neuen Wert überschrieben. Falls das Zielelement nicht vorhanden ist, wird es erstellt und der Wert wird gespeichert.
Der Knoten benötigt Abfrageinformationen, die zur Generierung einer SQL-SELECT-Abfrage verwendet werden, die mittels mehrerer Prüfbedingungen auf mehrere Tabellen in einer Datenbank zugreifen kann. Nicht immer befinden sich alle Informationen, die Sie in einer Ergebnismenge abrufen möchten, in einer einzigen Datenbank. Eventuell müssen Sie die gewünschten Spaltenwerte daher aus zwei oder mehr Tabellen abrufen. Dieser Knoten unterstützt die Verwendung von SELECT-Anweisungen, mit denen Sie Spalten einer oder mehrerer Tabellen in einer Ergebnismenge abrufen können. Die normale Join-Syntax, die von diesem Knoten unterstützt wird, wird als Inner Join bezeichnet.
Inner Join-Informationen, die zur Generierung einer Abfrage erfasst werden, umfassen eine Liste mit tabellenqualifizierten Spaltenwerten für den Abruf und eine Liste mit Prüfbedingungen, mit denen die WHERE-Klausel einer SELECT-Anweisung gebildet wird. Tabellenqualifizierte Spaltenwerte können den linken Operanden in einer Prüfbedingung bilden. Wählen Sie einen Vergleichsoperator aus, der für diesen Operanden angewendet wird, und geben Sie optional einen rechten Operanden an, um die Prüfbedingung zu vervollständigen. Bei dem Operator könnte es sich um einen NULL-Vergleichstest handeln, für den kein rechter Operand erforderlich ist. Bei dem Wert des rechten Operanden kann es sich um einen Datenbanktyp handeln (z. B. 'Integer' (ganze Zahl), 'Boolean' (Boolesch) oder 'Long' (Langzeichen)), eine weitere tabellenqualifizierte Spalte oder einen Wert, der mittels eines allgemeinen XPath 1.0-Ausdrucks aus einem Element in der eingehenden Nachricht abgerufen wird.
Der Ausdruck sollte ein einzelnes Element, einen Booleschen Wert oder eine Zeichenfolge zurückgeben. Anderenfalls wird eine Ausnahme generiert. Wenn die Abfrage mehrere Zeilen zurückgibt, wird die erste Zeile ausgewählt und alle anderen Zeilen werden ignoriert, es sei denn, die Option Mehrere Zeilen ist aktiviert. Im letzteren Fall werden alle Zeilen verarbeitet und die Werte dieser Zeilen werden zur Aktualisierung der Baumstrukturen der Ausgabenachrichtenassemblierung verwendet.
Es ist kann hilfreich sein, einen DatabaseRetrieve-Knoten mit anderen Nachrichtenflussknoten zu kombinieren. Beispielsweise können Sie einen XSLTransform-Knoten verwenden, um Daten vor und nach dem Aufruf des DatabaseRetrieve-Knotens zu bearbeiten.
Der DatabaseRetrieve-Knoten verfügt über ein Eingabeterminal (IN) und drei Ausgabeterminals ('Out', 'keyNotFound' und 'Failure'). Wenn die Nachricht erfolgreich modifiziert wurde, wird sie an das Terminal 'Out' weitergeleitet. Wenn die Modifizierung der Nachricht fehlschlägt bzw. während der Verarbeitung ein Fehler festgestellt wird, wird die Nachricht an das Terminal 'Failure' weitergegeben. Wenn nach der Ausführung einer bestimmten SQL-SELECT-Abfrage in der Ergebnismenge keine Zeilen zurückgegeben werden, wird die Originalnachricht an das Terminal 'keyNotFound' weitergeleitet.
Der DatabaseRetrieve-Knoten erstellt seine JDBC-Verbindungen unter Verwendung der Verbindungsdetails, die in der Brokerregistry als konfigurierbarer Service gespeichert sind. Die konfigurierbaren JDBC-Provider-Services stehen allen unterstützten Datenbanken zur Verfügung. Sie können die Einstellungen des für Ihre Datenbank bereitgestellten Services mit dem Befehl mqsichangeproperties anpassen, oder Sie können mit dem Befehl mqsicreateconfigurableservice einen neuen Service erstellen. Weitere Informationen zur Verwendung der JDBC-Provider-Services finden Sie im Abschnitt JDBC-Provider für Verbindungen des Typs 4 einrichten. Sie müssen für jede Datenbank, zu der Sie eine Verbindung herstellen möchten, einen anderen JDBC-Provider-Service einrichten.
Nachdem Sie den Service definiert haben, müssen Sie die Eigenschaft Datenquellenname dieses Knotens auf den Namen des dafür erstellten JDBC-Provider-Service setzen. Die Attribute des Service werden für Verbindungen des DatabaseRetrieve-Knotens benötigt.
Damit die Änderungen wirksam werden, müssen Sie den Broker beenden und neu starten, es sei denn, Sie möchten eine neue Ausführungsgruppe für den Broker erstellen, in dem Sie den Nachrichtenfluss mit diesem Knoten implementieren.
Wenn Sie eine Instanz des DatabaseRetrieve-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
| EmployeeNumber (Personalnummer) | FamilyName (Nachname) | FirstName (Vorname) | Salary (Gehalt) |
|---|---|---|---|
| 00001 | Smith | John | 20000 |
| 00002 | Jones | Harry | 26000 |
| 00003 | Doe | Jane | 31000 |
<EmployeeRecord> <EmployeeNumber>00001</EmployeeNumber> </EmployeeRecord>
| Tabellenname | Spaltenname | Operator | Wertetyp | Wert |
|---|---|---|---|---|
| Employee (Mitarbeiter) | FamilyName (Nachname) | |||
| Employee (Mitarbeiter) | Salary (Gehalt) | |||
| Employee (Mitarbeiter) | EmployeeNumber (Personalnummer) | = | Option | $OutputRoot/XMLNSC/EmpRecord/EmpNumber |
| Spaltenname | Nachrichtenelement |
| Employee.FamilyName | $OutputRoot/XMLNSC/EmployeeRecord/Surname |
| Employee.Salary | $OutputRoot/XMLNSC/EmployeeRecord/Wage |
SELECT Employee.FamilyName, Employee.Salary FROM Employee WHERE EmployeeNumber=? ORDER BY Employee.FamilyName ASC, Employee.Salary ASCDabei ist ? der Wert, der aus der eingehenden Nachricht abgerufen wird und über die Eigenschaft Wert in der dritten Zeile der Abfrageelementtabelle lokalisiert wird, die den Wertetyp Element aufweist.
<EmployeeRecord> <EmployeeNumber>00001</EmployeeNumber> <Surname>Smith</Surname> <Wage>20000</Wage> </EmployeeRecord>
<EmployeeRecord> <EmployeeNumber>00002</EmployeeNumber> <Surname>Jones</Surname> <Wage>26000</Wage> </EmployeeRecord>
<EmployeeRecord> <EmployeeNumber>00001</EmployeeNumber> <Surname>Smith</Surname> <Wage>20000</Wage> <EmployeeNumber>00002</EmployeeNumber> <Surname>Jones</Surname> <Wage>26000</Wage> </EmployeeRecord>
Durch die Festlegung der Auswertungseigenschaften können Sie festlegen, wie die vom DatabaseRetrieve-Knoten generierte Nachricht ausgewertet werden soll. Diese Eigenschaften führen nicht dazu, dass die Eingabenachricht ausgewertet wird. Falls diese Auswertung erforderlich ist, wird davon ausgegangen, dass die Auswertung bereits durch den Empfangsknoten oder einen vorhergehenden Auswertungsknoten ausgeführt wurde.
Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.
Der Terminals des DatabaseRetrieve-Knotens werden in der folgenden Tabelle beschrieben.
| Terminal | Beschreibung |
|---|---|
| Eingangsterminal | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt. |
| Ausgang | Das Ausgabeterminal, an das die abgehende Nachricht bei erfolgreicher Verarbeitung geleitet wird. |
| keyNotFound | Das Ausgabeterminal, an das die unveränderte Originalnachricht weitergeleitet wird, wenn die Ergebnismenge leer ist. |
| Fehlerterminal | Das Ausgabeterminal, an das die Eingabenachricht gesendet wird, wenn während der Verarbeitung ein Fehler auftritt. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Der Knotentyp, DatabaseRetrieve | Der Name des Knotens. |
| Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens. | |
| Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Datenquellenname | Ja | Ja | DB2 | Der Aliasname zum Lokalisieren der in der Brokerregistry gespeicherten Definition des JDBC-Provider-Service. Der Aliasname wird zum Lokalisieren und Erstellen der JDBC-Verbindungs-URL verwendet, die zum Herstellen einer Verbindung zu einem DBMS verwendet wird. Die Verbindungs-URL ist treiberspezifisch, enthält jedoch den Namen der Datenbank, zu der die Verbindung hergestellt werden soll. Wenn die Verbindung zur Datenbank über ein Anmeldeaccount und -Kennwort hergestellt wird, verwendet der Knoten diese Eigenschaft auch als Suchschlüssel, mit dem diese Werte von einem erwarteten entsprechenden DSN-Eintrag in der Brokerregistry abgerufen werden können. Wenn das Datenbankmanagementsystem (DBMS) durch ein Kennwort geschützt ist, geben Sie den Parameter -n im Befehl mqsisetdbparms für den eindeutigen JDBC-Sicherheitsschlüssel an, bevor Sie den Nachrichtenfluss implementieren, in dem dieser DatabaseRetrieve-Knoten enthalten sind. |
| Nachricht kopieren | Nein | Ja | Nicht ausgewählt | Diese Eigenschaft gibt an, ob eine Kopie der eingehenden Originalnachricht erforderlich ist, da die Nachrichtenbaumstruktur möglicherweise zusätzlich zu logischen Baumstrukturen in der Nachrichtenassemblierung aktualisiert wird. Das Kontrollkästchen ist standardmäßig inaktiviert. Aus Leistungsgründen sollten Sie diese Eigenschaft nur auswählen, wenn die Eingabenachricht erweitert wird. |
| Mehrere Zeilen | Nein | Ja | Nicht ausgewählt | Diese Eigenschaft gibt an, ob alle Zeilen verarbeitet werden, wenn eine Abfrage mehrere Zeilen zurückgibt. Wenn Sie Mehrere Zeilen auswählen, werden alle Zeilen verarbeitet und die Werte dieser Zeilen werden zur Aktualisierung der Baumstrukturen der Ausgabenachrichtenassemblierung verwendet. Wenn Sie diese Eigenschaft nicht auswählen, wird die erste Zeile ausgewählt und alle anderen Zeilen werden ignoriert. |
| Abfrageelemente | Ja | Nein | Eine Tabelle mit Abfrageelementen, die zum Erstellen einer einzelnen SQL-Anweisung SELECT verwendet werden. Die Tabelle besteht aus fünf Spalten und einer oder mehreren Zeilen. Folgende Spalten sind in der Tabelle enthalten: Tabellenname, Spaltenname, Operator, Wertetyp und Wert. Diese fünf Eigenschaften beschreiben ein Abfrageelement und geben einen tabellenqualifizierten Spaltenwert an, der aus der Datenbank abgerufen werden soll. In diesem Fall bildet das Element einen Teil der SELECT- und ORDER BY-Klauseln der generierten Abfrage. Ansonsten dient das Abfrageelement als Prüfbedingung, die innerhalb der WHERE-Klausel der generierten Abfrage ein Vergleichselement darstellt. | |
| Tabellenname | Ja | Nein | Der Name der Datenbanktabelle, die Bestandteil der SQL-Anweisung SELECT ist, einschließlich des Schemanamens; z. B. myschema.mytable. | |
| Spaltenname | Ja | Nein | Der Name der Spalte in der Datenbanktabelle, die in den Ergebnissen abgerufen wird und über den Wert für die Eigenschaft Tabellenname bestimmt wurde. Diese SELECT-Klausel kann auf diesen Namen als Spaltenwert für die Rücklieferung von einer Abfrage oder für den Verweis in einer Prüfbedingung innerhalb der WEHRE-Klausel verweisen. | |
| Operator | Ja | Nein | Ein Vergleichsoperator, der für einen Wert des linken Operanden (die in den ersten zwei Spalten der Zeile angegebene Tabellenspalte) und optional des rechten Operanden angewendet wird. Wenn Sie für diese Eigenschaft einen aufsteigenden oder absteigenden Operatorwert (ASC oder DESC) angeben, gibt diese Zeile die Deklaration einer tabellenqualifizierten Spalte an, die einen Teil der SELECT- und ORDER BY-Klauseln der generierten Abfrage bildet und auf die in künftigen Zeilen optional als Wert für den rechten Operanden verwiesen werden kann. | |
| Wertetyp | Ja | Nein | Ein Wert, der entweder auf None (Keiner) gesetzt ist oder der den Typ des Werts angibt, der in der letzten Spalte dieser Zeile definiert ist. Wenn diese Eigenschaft nicht auf None gesetzt ist, verweist sie auf eine Zeile, die innerhalb der WHERE-Klausel der SQL-SELECT-Anweisung eine Prüfbedingung beschreibt. | |
| Wert | Ja | Nein | Ein Wert, der entweder auf None (Keiner) gesetzt ist oder der einen von mehreren Eigenschaftentypen angibt, die in der Eigenschaft Wertetyp definiert sind. Wenn die Eigenschaft Wertetyp beispielsweise auf Element gesetzt ist, erfasst die Eigenschaft Wert einen allgemeinen XPath 1.0-Ausdruck. Der Wert, der von dem Ausdruck zurückgegeben wird, wenn er auf die eingehende Nachricht des Knotens angewendet wird, wird als Wert für den rechten Operanden verwendet, der mit diesem Prädikat verglichen wird. Der Vergleichswert des rechten Operanden muss dem Typ entsprechen, der für die Tabellenspalte abgerufen wird, die als linker Operand für den Vergleich verwendet wird. Es sind auch komplexe Ausdrücke möglich, die keinen bis mehrere Werte aus der eingehenden Nachricht abrufen und so manipulieren, dass sie für den Vergleich einen einzigen Wert ergeben. Beispielsweise kann durch einen allgemeinen Ausdruck für den Wertetyp Element die Summe aus mehreren Feldwerten der eingehenden Nachricht berechnet werden. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Datenelemente | Ja | Nein | Eine Liste mit Datenelementen. Ein Datenelement wird über die Eigenschaften Spaltenname für Wert und Nachrichtenelement beschrieben. | |
| Spaltenname für Wert | Ja | Nein | Der Name der Datenbankspalte, aus der der Elementwert abgerufen wird. Die Liste mit Namen wird auf Basis der Einträge, die in die Tabelle mit den Abfrageelementen eingefügt werden, dynamisch aktualisiert. | |
| Nachrichtenelement | Ja | Nein | Ein XPath 1.0-Schreib-/Lesepfadausdruck, der die Pfadposition eines Nachrichtenelements beschreibt. Im Nachrichtenelement ist der Datenbankwert gespeichert. Der XPath-Ausdruck muss ein einzelnes Element in der Nachricht ergeben. |
In der folgenden Tabelle werden die Validierungseigenschaften des DatabaseRetrieve-Knotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie im Abschnitt Auswertungseigenschaften.| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswertung | Nein | Ja | Keines | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. |
| Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur festgelegt werden, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert setzen. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |