Während der Laufzeit führt die Aktivität Abfrage ausführen eine SQL-Anweisung SELECT aus.
Die Aktivität Abfrage ausführen unterstützt parametrisierte Abfragen. Das sind Abfragen, die Eingabeparameter oder Eingabe- und Ausgabeparameter enthalten. Wenn in einer Abfrage Eingabeparameter angegeben werden, wird während der Ausführung der Wert des Parameter bereitgestellt. Das Zeichen ? in der folgenden Beispielanweisung SELECT gibt an, dass ein (1) Eingabeparameter vorhanden ist:
select * from myUserSchema.mySourceTable. Dabei gilt: myUserSchema.mySourceTable.myColumn=?
Das Zeichen
* in der obigen Anweisung SELECT gibt an, dass die Abfrage die in der Tabelle
mySourceTable gefundenen Spalten als Ausgabeparameter zurückgibt. Beispiel: Wenn die Tabelle
mySourceTable zwei Spalten enthält, je eine vom Typ CHAR und VARCHAR, gibt die Aktivität
Abfrage ausführen zwei Ausgabeparameter zurück, und zwar je einen vom Typ CHAR und VARCHAR.
Anmerkung: In der Aktivität Abfrage ausführen wird nur die SQL-Anweisung SELECT unterstützt.
Die SQL-Anweisung INSERT wird in der Aktivität Abfrage ausführen nicht unterstützt.
Die Schritte zum Hinzufügen und Konfigurieren einer Aktivität
Abfrage ausführen für eine Orchestrierung werden in den folgenden Prozeduren beschrieben:
Aktivität 'Abfrage ausführen' zur Orchestrierung hinzufügen
- Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
- Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner Datenbank.
- Ziehen Sie die Aktivität Abfrage ausführen auf die Orchestrierung.
- Wählen Sie die Aktivität Abfrage ausführen aus.
Datenbankendpunkt erstellen, auswählen oder bearbeiten
- Klicken Sie auf die Task Endpunkt auswählen in der Prüfliste und
wählen Sie eine der folgenden Aktionen aus:
- Wählen Sie einen vorhandenen Endpunkt aus:
- Wählen Sie Durchsuchen aus. Der Projektexplorer wird geöffnet.
- Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
Springen Sie zu der Prozedur SQL-Anweisung für die Abfrage angeben.
- Wählen Sie einen vorhandenen Endpunkt und bearbeiten Sie den Endpunkt:
- Wählen Sie Durchsuchen aus. Der Projektexplorer wird geöffnet.
- Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
- Klicken Sie auf
Bearbeiten. Das Teilfenster Endpunkt bearbeiten wird geöffnet.
- Erstellen Sie einen Endpunkt: Wählen Sie Neu aus. Das Teilfenster Endpunkt erstellen wird geöffnet.
- Erstellen oder bearbeiten Sie einen Datenbankendpunkt.
SQL-Anweisung für die Abfrage angeben
- Wählen Sie die Task Abfrage eingeben aus der Prüfliste aus.
Das Teilfenster Abfrage eingeben wird geöffnet.
- Geben Sie die Abfrage in dem im Teilfenster angezeigten Leerraum ein. Setzen Sie am Ende der Abfrage kein Semikolon.
- Klicken Sie auf Spalten anzeigen, um die Spaltendetails einer ausgewählten Tabelle anzuzeigen. Dies hilft Ihnen bei der Erstellung der SQL-Anweisung, indem Sie gültige Tabellennamen und -spalten eingeben.
- Wählen Sie eine alternative Einstellung für die Zeichencodierung für die Eingabe- und Ausgabeparameter aus, falls die gewünschte Codierung von der Standardcodierung der Datenbank abweicht. Verwenden Sie dazu folgende Optionen:
- Wählen Sie in der Liste Codierung einen Standardcodierungstyp aus.
- Geben Sie Ihren Codierungstyp direkt ein, indem Sie in das Feld Codierung klicken und Ihren Codierungstyp eingeben.
Anmerkung: Bestimmte Doppelbytezeichen werden bei Verwendung der Codierung SHIFT-JIS nicht umgewandelt. Weitere Informationen finden Sie unter
Shift-JIS-Codierung verwenden.
- Klicken Sie auf Abfrage validieren. Diese Aktion prüft die Gültigkeit der Abfrage und füllt die Eingabe- und Ausgabeparameter in den Tasks Eingaben zuordnen und Ausgaben zuordnen.
- Geben Sie im Feld MaxRows einen Wert ein. Das Feld MaxRows gibt die maximale Anzahl Zeilen an, die während der Ausführung von der Abfrage zurückgegeben werden sollen.
Anmerkung: Wird eine Abfrage mehrmals für dieselben Daten ausgeführt, werden dieselben Zeilengruppen zurückgegeben. Wenn der Wert für MaxRows beispielsweise 1 lautet, wird bei jedem Start der Abfrage immer dieselbe Zeile (die erste Zeile) zurückgegeben - eine Iteration durch die Zeilengruppen findet nicht statt.
Wiederholungsoptionen für die Abfrage angeben
Gehen Sie wie folgt vor, um Wiederholungsoptionen für die Abfrage anzugeben:
- Konfigurieren Sie die Wiederholungsoptionen.
Anmerkung: Wenn Sie für die Wiederholungsoption der Aktivität Abfrage ausführen der Datenbank den Wert 'Null' festlegen, wiederholt die Integrationseinheit den Verbindungsaufbau unbegrenzt.
Ausgabe der Aktivität zuordnen
- Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus.
Die von der Anweisung SELECT zurückgegebenen Spalten sind die Elemente, die im Teilfenster 'Von Aktivität' unter dem Element 'Zeilen/Zeile' angezeigt werden.
- Sie brauchen die Ausgabeparameter der Aktivität nicht zuzuordnen.
Allgemeine Anweisungen zur Zuordnung finden Sie unter Zuordnung erstellen.