Mit dem grafischen Datenzuordnungseditor können Sie Daten in einer Datenbanktabelle aktualisieren.
Bevor Sie beginnen:
Folgende Task muss zunächst ausgeführt werden:
Erstellen Sie mit dem Editor für die grafische Datenzuordnung eine grafische Datenzuordnung. Informationen hierzu finden Sie
im Abschnitt Grafische Datenzuordnungen erstellen.
Gehen Sie wie folgt vor, um im Editor für grafische Datenzuordnungen eine oder mehrere
Datenzeilen in einer Datenbanktabelle zu aktualisieren:
Wenn im Editor für die grafische Datenzuordnung eine grafische Datenzuordnung (Datei .map) geöffnet ist, klicken Sie mit der rechten Maustaste auf den
Entwicklungsbereich und wählen Sie Datenbank > Tabelle aktualisieren aus. Sie können stattdessen auch auf das Symbol Update
a row in a database table (Zeile in einer Datenbanktabelle aktualisieren) klicken. Der Assistent Neue Datenbanktabellenaktualisierung.
Wählen Sie im Feld Datenbank die Datenbank aus, die Sie ändern möchten. Klicken Sie auf Datenbank hinzufügen, um eine Datenbankdefinitionsdatei hinzuzufügen oder eine Verbindung zu einem Datenbankserver herzustellen, um eine neue Datenbank zu ermitteln. Der Abschnitt Datenbankdefinition (.dbm-Datei) mit dem Assistenten Neue Datenbankdefinitionsdatei erstellen enthält weitere Informationen hierzu. Um während der Ausführung einen anderen Datenbanknamen zu verwenden, können Sie diesen Wert überschreiben, indem Sie die Eigenschaft databaseName des konfigurierbaren
JDBCProvider-Service festlegen, mit dem Ihre Datenbank verbunden ist. Weitere Informationen dazu finden Sie unter JDBC-Provider für Verbindungen des Typs 4 einrichten.
Wählen Sie im Feld Schema das Datenbankschema aus, das Sie zur Erstellung der Transformation verwenden möchten. Um während der Ausführung ein anderes Datenbankschema zu verwenden, können Sie diesen Wert überschreiben, indem Sie die Eigenschaft databaseSchemaNames des konfigurierbaren
JDBCProvider-Service festlegen, mit dem Ihre Datenbank verbunden ist. Weitere Informationen dazu finden Sie unter JDBC-Provider für Verbindungen des Typs 4 einrichten.
Wählen Sie im Feld Tabelle die Datenbanktabelle aus, die Sie ändern möchten.
Optional: Wählen Sie Warnungen als Fehler behandeln aus. Wenn diese Option ausgewählt ist, gibt die erste SQL-Operation, die in der ausgewählten Datenbank eine Warnung auslöst, eine Ausnahme zurück.
Wichtig: Datenbankwarnungen sind herstellerspezifisch.
Weitere Informationen zu Datenbankwarnungen finden Sie in der Dokumentation zu Ihrem Datenbankprodukt.
Verwenden Sie im Feld SQL-Klausel WHERE die unterstützte SQL, um die Kriterien zur Auswahl der Zeilen aus Ihrer Datenbanktabelle anzugeben.
Erstellen Sie eine unterstützte SQL-Anweisung und ziehen Sie dazu Elemente
aus den Bereichen Table columns (Tabellenspalten) und
Operators (Operatoren) in das Feld SQL where
clause.
Um Werte in Ihre SQL-Anweisung aufzunehmen, ziehen Sie Elemente aus dem
Bereich Available
inputs for column values (Verfügbare Eingaben für Spaltenwerte) in
das Feld SQL
where clause, um sie als Parameter hinzuzufügen, oder geben Sie
Literalwerte wie 'abc' oder 123 direkt in
das Feld SQL where clause ein.
Parameter aus der SQL-Klausel WHERE (SQL where clause)
werden in der Tabelle mit den XPath-Ausdrücken aufgeführt. Die XPath-Ausdrücke können zur Präzisierung der Eingabe bearbeitet werden; so
kann beispielsweise für ein durch Ziehen aufgenommenes Wiederholungsfeld ein
bestimmter Feldgruppenindex hinzugefügt werden. Es wird eine SQL-Standardklausel WHERE erstellt. Diese wählt alle Zeilen in der ausgewählten Datenbanktabelle aus.
Anmerkung: Wenn Sie den Text des Felds SQL where clause
direkt bearbeiten, müssen Sie Folgendes beachten:
Die Groß-/Kleinschreibung der Tabellen- und Spaltennamen muss der
Schreibweise in Ihrer Datenbank entsprechen.
Tabellen- und Spaltennamen dürfen nicht in doppelte Anführungszeichen
gesetzt werden.
Es dürfen nur unterstützte SQL-Schlüsselwörter verwendet werden, die im
Operatorenbereich aufgeführt sind.
Optional: Wählen Sie Insert when a row does not exist (Einfügen, wenn eine Zeile nicht vorhanden ist) aus, wenn Sie eine neue Zeile in Ihre Datenbanktabelle einfügen möchten, weil die vorhandenen Zeilen die Kriterien der SQL-Klausel WHERE nicht erfüllen. Wenn diese Option ausgewählt ist, überprüft die Zuordnung die Rückgabe 'Anzahl der aktualisierten Zeilen' vom Datenbankserver auf die Operation zur Aktualisierung der SQL. Wenn die 'Anzahl der aktualisierten Zeilen' null ist, ruft die Zuordnung eine SQL-Operation zum Einfügen auf. Für die erfolgreiche Ausführung der Insert-Operation muss die
Update-Transformation explizit gültige Werte für alle obligatorischen Datenbankspalten bereitstellen. Wenn eine Zeile, die auf diese Weise eingefügt wurde, andere Werte als die durch die
Update-Transformation bereitgestellten Werte verwenden soll, können Sie eine bedingte
Insert-Transformation in der Return-Transformation hinzufügen.
Klicken Sie auf OK. Eine Update- und eine
Return-Transformation werden als Umsetzungsgruppe erstellt und in der grafischen Datenzuordnung angezeigt. Die Return-Transformation ist ein optionaler Transformationstyp, der eine verschachtelte Zuordnung bereitstellt. Diese wird nur eingegeben, wenn die zugehörige Update-Transformation erfolgreich war. Wenn Sie keine Return-Transformation verwenden müssen, können Sie sie aus der grafischen Datenzuordnung löschen.
Optional: Wenn Sie eine aus der grafischen Datenzuordnung gelöschte Return-Transformation ersetzen möchten, klicken Sie mit der rechten Maustaste auf die Update-Transformation und wählen Database > Utilize
return (Datenbank > Rückgabe verwenden) aus.
Legen Sie im Editor für die grafische Datenzuordnung den Inhalt der aktualisierten Zeile fest. Verbinden Sie dazu Eingabeobjekte mit der Update-Transformation. Wenn Sie ein sich wiederholendes Element verbinden, wird die Update-Transformation innerhalb einer For Each-Transformation verschachtelt. Diese verschachtelte Transformation wird geöffnet, damit Sie die Bearbeitung Ihrer Update-Transformation fortsetzen können.
Klicken Sie auf die Update-Transformation, um Verbindungen zu den Spalten Ihrer aktualisierten Zeile herzustellen und die Transformation genauer zu definieren.
Optional: Verbinden Sie die Return-Transformation, um eine verschachtelte Zuordnung zu implementieren, die aufgerufen wird, wenn die Update-Operation erfolgreich beendet wurde. Die verschachtelte Return-Transformation stellt eine integrierte Eingabe, die Option "NumberOfRowsUpdated" sowie zusätzliche Eingaben bereit, zu denen eine Verbindung hergestellt werden kann.
Optional: Klicken Sie auf die Return-Transformation, um die Transformation weiter zu definieren. Eine verschachtelte Zuordnung wird erstellt, in der Sie die speziellen Transformationen auswählen können, die für die Ein- und Ausgabeelemente erforderlich sind.
Nächste Schritte:
Wenn Ausnahmebedingungen, die bei der Ausführung der SQL-Operation vom Datenbankserver zurückgegeben wurden, die Zuordnung nicht stoppen und anschließend gemeldet, sondern von der Zuordnung verarbeitet werden sollen, können Sie eine Failure-Transformation in die Transformationsgruppe integrieren; weiteren Informationen finden Sie unter Datenbankausnahmen in einer grafischen Datenzuordnung behandeln.