gespeicherte Prozedur aus einer Zuordnung aufrufen

Verwenden Sie zum Aufrufen einer gespeicherte Prozedur mittels der Datenbankroutine-Transformation den Editor für die grafische Datenzuordnung.

Vorbereitungen:
Folgende Task muss zunächst ausgeführt werden:

Eine Datenbankroutine-Transformation können Sie zum Aufrufen einer gespeicherte Prozedur aus einer Datenbank verwenden.

Anmerkung: In IBM® Integration Bus v9.0 werden nur gespeicherte Prozeduren von IBM DB2 unterstützt.

Die Datenbankroutine-Transformation fungiert als eine verschachtelte Zuordnung, mit der Sie Eingaben verbinden können, um so Zuordnungen für die Eingabeparameterwerte für die gespeicherte Prozedur zu schaffen. Die Eingabeparameter der Routine werden als Ausgaben der verschachtelten Zuordnung für die Datenbankroutine angezeigt. Die Ausgaben aus der Transformation der Datenbankroutine können nicht verbunden werden.

Mit der Return-Transformation aus der Transformationsgruppe der Datenbankroutine können Sie alle Ausgabeparameter, Rückgabewerte oder ResultSets zuordnen, die durch den Aufruf der Datenbankroutine erstellt wurden. Nach dem erfolgreichen Aufruf der Datenbankroutine können Sie alle zusätzlichen Eingaben verbinden, für die eine Zuordnung hergestellt werden soll. Die Ausgabeparameter, alle Rückgabewerte und alle zurückgegebenen Ergebnisse, die Sie für die Datenbankroutine definiert haben, werden als Eingaben in der verschachtelten Return-Zuordnung bereitgestellt. Sie können die Return-Transformation als Ausgabeelement mit einem einzelnen gleichgeordneten Element oder mit mehreren gleichgeordneten Elementen verbinden, damit die zurückgegebenen Daten der Zuordnungsausgabe zugeordnet werden kann.

Führen Sie mithilfe des Editors für die grafische Datenzuordnung die folgenden Schritte aus:

  1. Öffnen Sie im Editor für die grafische Datenzuordnung eine grafische Datenzuordnungsdatei (.map), klicken Sie mit der rechten Maustaste auf den Erstellungsbereich und wählen Sie Datenbank > Datenbankroutine aufrufen aus.
    • Alternativ können Sie ein Schemaelement (oder Schemaelemente) als Eingabeparameterwert auswählen. Optional wählen Sie ein Schemaelement (oder Schemaelemente) als Ausgabewert aus.
    • Sie können die Transformation der Datenbankroutine auch mittels Drag-and-Drop erstellen. Wenn Sie das Eingabeobjekt mit den Ausgabeobjekt verbinden, wird automatisch eine Transformation erstellt. Wählen Sie die Transformation aus und wählen Sie anschließend in der Liste Transformationen die Option Datenbankroutine aus.
    • Sie können auch auf das Symbol Gespeicherte Prozedur in einer Datenbank aufrufen klicken.Symbol für 'Gespeicherte Prozedur in einer Datenbank aufrufen'
    Der Assistent für die Datenbankroutine wird angezeigt.
  2. Wählen Sie im Feld Datenbank die Datenbank aus, aus der Sie die Routine aufrufen möchten. Wenn Sie eine Datenbankdefinitionsdatei hinzufügen oder eine neue Datenbank durch die Verbindung von IBM Integration Toolkit über JDBC zu einem Datenbankserver ermitteln möchten, klicken Sie auf Datenbank hinzufügen. Der Abschnitt Datenbankdefinition über den Assistenten Neue Datenbankdefinitionsdatei erstellen enthält weitere Informationen hierzu. Während des Erkennungsprozesses müssen Sie die Option Routines (Routinen) auswählen. Wenn Sie während der Ausführung einen anderen Datenbanknamen als den im Toolkit verwendeten Namen verwenden möchten, können Sie diesen Wert überschreiben, indem Sie die Eigenschaft databaseName des konfigurierbaren JDBCProvider-Service angeben, mit dem die Verbindung zu Ihrer Datenbank definiert wird (siehe JDBC-Provider für Verbindungen des Typs 4 einrichten).
  3. Wählen Sie im Feld Schema das Datenbankschema aus, das die gespeicherte Prozedur definiert, die Sie aus der Zuordnung aufrufen möchten. Wenn die gespeicherte Prozedur während der Ausführung aus einem anderen Datenbankschema aufgerufen werden soll, können Sie diesen Wert überschreiben, indem Sie die Eigenschaft databaseSchemaNames des konfigurierbaren JDBCProvider-Service festlegen, der die Verbindung zu Ihrer Datenbank definiert (siehe JDBC-Provider für Verbindungen des Typs 4 einrichten).
  4. Wählen Sie im Feld Routine die gespeicherte Prozedur aus, die Sie in der Zuordnung in die Datenbankroutine-Transformation aufrufen möchten.
    1. Optional: Wenn die ausgewählte Routine einen Wert zurückgeben kann, wird ein Kontrollkästchen für den Rückgabewert angezeigt. Aktivieren Sie dieses Kontrollkästchen, damit der Rückgabewert für die Zuordnung in der Return-Transformation verfügbar ist.
    Anmerkung: Mit der ausgewählten Routine werden anschließend die folgenden gesperrten Felder ausgefüllt:
    • Typ: Gibt den Typ der ausgewählten Routine an: gespeicherte Prozedur .
    • Parameter: Einzelheiten zu Name, Modus und Typ des Parameters für die ausgewählte Routine.
    • Max. Ergebnisse: Zeigt die maximalen Ergebnisse an, falls die Datenbankdefinitionsdatei für die Routine diese Information bereitstellt. Andernfalls ist das Feld leer.

    Zum Anzeigen dieser Felder klicken Sie auf Display Routine parameter details (Details zu Routineparametern anzeigen).

  5. Optional: Wählen Sie Warnungen als Fehler behandeln aus. Wenn diese Option ausgewählt ist und durch das Aufrufen der Datenbankroutine in der konfigurierten Laufzeitdatenbank eine SQL-Warnung zurückgegeben wird, wird die Option behandelt, wie wenn die Datenbank eine Ausnahmebedingung auslöst. Wenn die Failure-Transformation vorhanden ist, wird die zugehörige verschachtelte Zuordnung verwendet. Andernfalls wird die Ausführung der Zuordnung gestoppt und im Zuordnungs, auf dem die Zuordnung ausgeführt wird, wird eine Ausnahmebedingung ausgelöst.
    Wichtig: Datenbankwarnungen sind herstellerspezifisch. Weitere Informationen zu Datenbankwarnungen finden Sie in der Dokumentation zu Ihrem Datenbankprodukt.
  6. Optional: Wenn die ausgewählte Routine Ergebnisse zurückgeben kann und Sie daraus Werte zuordnen möchten, müssen Sie die Reihenfolge und Spalteninhalte definieren.
    1. Wenn in Ihrer Datenbankdefinitionsdatei die Anzahl der Ergebnisse definiert ist, wird die Liste der Ergebnisse mit ResultSet vorausgefüllt und zeigt die maximale Anzahl der Ergebnisse an, die zurückgegebenen werden können. Über die Schaltflächen Hinzufügen und Löschen können Sie die Liste der Ergebnisse bis zu der in der Datenbankdefinitionsdatei definierten maximalen Anzahl ausfüllen. Sie müssen die Ergebnisse wie im Code der Datenbankroutine definiert sortieren. Auch wenn Sie nur die Daten aus dem zweiten Ergebnis zuordnen möchten, müssen Sie nach wie vor auch das erste Ergebnis in die Tabelle aufnehmen, da der Zugriff auf die Ergebnisse nach ihrer Positionsreihenfolge erfolgt.
    2. Wählen Sie jedes Ergebnis aus und fügen Sie über die Kontrollkästchen unter Verfügbare Tabellenspalten Spaltendefinitionen zu den Ergebnissen hinzu, um eine Übereinstimmung mit den von der Datenbankroutine zurückgegebenen Ergebnissen zu erreichen. Sie müssen nur die Ergebnisspalten definieren, die für die Zuordnung verfügbar sein sollen.
  7. Klicken Sie auf OK. Die Datenbankroutine und die zugehörige gruppierte Return-Transformation werden in Ihrer grafischen Datenzuordnung angezeigt. Wenn Sie in der Ein-/Ausgabe der Zuordnung eine Auswahl getroffen haben, werden alle ausgewählten Eingaben mit der Datenbankroutine und die Ausgaben mit der Return-Transformation verbunden. Wenn Sie keine Auswahl vorgenommen haben, werden die neuen Transformationen in der Zuordnung ohne Verbindung angezeigt.
  8. Stellen Sie alle erforderlichen Werte für die Modusparameter IN und INOUT für die Datenbankroutine bereit. Die Eingabeparameter für die ausgewählte gespeicherte Prozedur werden in der verschachtelten Datenbankroutine-Transformation als Ausgaben angezeigt.
    1. Verbinden Sie die erforderlichen Eingabeelemente mit der Datenbankroutine und stellen Sie in der verschachtelten Zuordnung Transformationen bereit, damit für jeden Parameter ein Wert festgelegt werden kann. Die Datenbankroutine wird nur einmal verwendet und führt dann einen Aufruf an das Datenbanksystem aus. Sie müssen die Kardinalität für alle sich wiederholenden Elemente festlegen, für die in der Transformation der Datenbankroutine eine Verbindung hergestellt wurde, oder eine Funktionstransformation verwenden, um einen einzelnen Wert für den Parameter bereitzustellen.
      Anmerkung: Wenn einem Parameter kein Wert zugeordnet wird, gibt der Datenbankserver möglicherweise eine Ausnahmebedingung zurück, falls kein Standardwert bereitgestellt werden kann. Wenn der resultierende Ausgabewert der Transformationen, mit denen die Parameter festgelegt werden, nicht den korrekten Typ für die Datenbankroutine hat oder die Inhalte ungültig sind (z. B. bei Überschreitung einer maximalen Länge), kann eine Datenbankausnahmebedingung auftreten.
  9. Stellen Sie alle erforderlichen Zuordnungen für die Ausgabeelemente aus den Daten bereit, die von der Datenbankroutine zurückgegeben werden. Diese Daten können die Modusparameter OUT und INOUT sowie optionale Rückgabewerte des Typs Routine und ein oder mehrere Ergebnisse enthalten. Die Ausgaben der Routine werden in der verschachtelten Return-Transformation als Eingaben angezeigt.
    1. Optional: Stellen Sie eine Verbindung zwischen allen zusätzlichen Eingabeelementen, die Sie möglicherweise benötigen und die mit den Daten der Datenbankroutine zusammengeführt wurden, und der Return-Transformation her. Verbinden Sie die Return-Transformation mit einem oder mehreren Ausgabeelementen der Zuordnung. Stellen Sie Transformationen innerhalb der verschachtelten Return-Zuordnung bereit, um die verbundenen Ausgaben aus den bereitgestellten Ausgabewerten der Datenbankroutine festzulegen.
Nächste Schritte:
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-07-18 03:09:20


TaskthemaTaskthema | IBM Integration Bus Version 9.0.0.0 | cm28838_