SQL Command - spectrum_platform - 23 - 23.1

Spectrum Enterprise Data Integration-Handbuch

Product type
Software
Portfolio
Integrate
Product family
Spectrum
Product
Spectrum > Data Integration
Version
23.1
Language
Deutsch
Product name
Spectrum Data Integration
Title
Spectrum Enterprise Data Integration-Handbuch
First publish date
2005
Last updated
2023-10-25
Published on
2023-10-25T06:22:15.743462

SQL Command führt einen oder mehrere SQL-Befehle für jeden Datensatz im Datenfluss aus. Sie können SQL Command für Folgendes verwenden:

  • Ausführen von komplexen INSERT/UPDATE-Anweisungen, wie Anweisungen, die Unteranfragen enthalten oder Verbindungen mit anderen Relationen erstellen.
  • Aktualisieren von Relationen nach dem Einfügen/Aktualisieren von Daten, um die referenzielle Integrität zu wahren.
  • Aktualisieren oder Löschen eines Datensatzes in einer Datenbank, bevor ein Ersatzdatensatz geladen wird.
  • Aktualisieren von mehreren Relationen in einer einzigen Transaktion.

Sie können vor und nach den SQL-Hauptbefehlen zusätzliche SQL-Befehle ausführen, und Sie können gespeicherte Prozeduren aufrufen.

Anmerkung: Verwenden Sie die folgende Syntax, um eine gespeicherte Prozedur auszuführen:

Call <Prozedurname>

Gespeicherte Prozeduren, die von SQL Command aufgerufen werden, dürfen keine OUT-Parameter verwenden.

Anmerkung: Es können bestimmte Leistungsverbesserungen erzielt werden, indem Sie mehrere Laufzeitinstanzen von SQL Command verwenden. Klicken Sie auf die Schaltfläche Laufzeit, um mehrere Laufzeitinstanzen anzugeben.

Allgemein

Auf der Registerkarte Allgemein können Sie dynamische SQL-Anweisungen festlegen, die Sie einmal für jeden Datensatz ausführen möchten. Die folgende Tabelle enthält die Optionen der Registerkarte Allgemein.

Option Beschreibung

Verbindung

Wählen Sie die gewünschte Datenbankverbindung aus. Die Auswahlmöglichkeiten variieren, je nachdem, welche Verbindungen im Verbindungs-Manager der Spectrum Management Console definiert sind. Klicken Sie auf Verbindungen verwalten, wenn Sie eine neue Datenbankverbindung herstellen oder eine vorhandene Datenbankverbindung ändern oder löschen müssen.

Wenn Sie eine Datenbankverbindung hinzufügen oder ändern, füllen Sie diese Felder aus:
Verbindungsname
Geben Sie einen Namen für die Verbindung ein. Sie können den Namen frei wählen.
Datenbanktreiber
Wählen Sie den passenden Datenbanktyp aus.
Verbindungsoptionen
Geben Sie Host, Port, Instanz, Benutzername und Kennwort an, die für die Verbindung zur Datenbank verwendet werden sollen.

SQL-Anweisungen

Geben Sie die SQL-Anweisungen ein, die Sie für jeden Datensatz im Datenfluss ausführen möchten. Mit Beginn der Eingabe erscheint ein Fenster, das automatisch die gültigen SQL-Befehle anzeigt. Trennen Sie mehrere SQL-Anweisungen mit einem Semikolon ( ; ).

Verwenden Sie die folgende Syntax, um einen Wert in einem Datenflussfeld festzulegen:

${<field name>}

Dabei steht „<field name>“ für den Namen eines Feldes im Datenfluss.

Zum Beispiel:

UPDATE MyDatabase.dbo.customer SET name=${Name} WHERE id=${ID};

In diesem Beispiel wird ${Name} durch den Wert aus dem Namensfeld des Datenflusses und ${ID} durch den Wert aus dem ID-Feld des Datenflusses ersetzt.

Anmerkung: Anforderungen müssen den vollständig qualifizierten Namen verwenden. Beispiel: MyDatabase.dbo.customer,.

Transaktionsverarbeitung

Gibt an, ob Datensätze in Batches oder alle auf einmal verarbeitet werden können. Eine von diesen:

Batch-Größe
Gruppiert Datensätze in Batches der von Ihnen angegebenen Größe und verarbeitet einen Batch nach dem anderen.
Gesamte Ausführung
Erstellt ein großes Batch für alle Datensätze und verarbeitet alle Transaktionen gleichzeitig.

Fehlerverarbeitung

Gibt an, was zu tun ist, wenn während der Ausführung der SQL-Befehle ein Fehler auftritt. Zur Auswahl stehen:

Datenfluss bei Fehler nicht beenden
Der Datenfluss wird weiter ausgeführt, wenn die Datenbank bei der Ausführung der SQL-Befehle einen Fehler zurückgibt.
Datenfluss nach Auftreten dieser Anzahl von Fehlern beenden
Der Datenfluss wird gestoppt, nachdem die Datenbank die festgelegte Anzahl von Fehlern zurückgibt.
Anmerkung: Wenn in SQL ein Syntaxfehler auftritt, wird der Datenfluss ungeachtet der von Ihnen hier ausgewählten Einstellung immer beendet.

Zusätzlich können Sie optional Fehlerdatensätze in ein Laden von Daten schreiben, indem Sie den SQL Command-Fehlerport mit dem gewünschten Datenladungstyp verbinden. Der Fehlerport ist das weiße Dreieck auf der rechten Seite des Schrittsymbols im Datenfluss. Zum Schreiben von Fehlerdatensätzen in ein Flatfile müssen Sie z. B. den SQL Command-Fehlerport mit dem „Write to File“-Schritt verbinden, wie hier dargestellt:

Pre-/Post-SQL

Auf der Registerkarte Pre/Post SQL legen Sie SQL-Anweisungen fest, die einmal pro Datenflussausführung ausgeführt werden sollen. Dies ist der Gegensatz zur einmaligen Ausführung pro Datensatz wie auf der Registerkarte Allgemein. Die folgende Tabelle enthält die Optionen der Registerkarte Pre-/Post-SQL.

Option Beschreibung

Pre-SQL

Geben Sie eine oder mehrere SQL-Anweisungen ein, die Sie ausführen möchten, bevor die in den Schritt eintretenden Datensätze verarbeitet werden. Die von Ihnen eingegebenen SQL-Anweisungen werden einmal pro Ausführung ausgeführt, nachdem der Datenfluss gestartet ist, aber bevor der „SQL Command“-Schritt die ersten Datensätze verarbeitet.

Ein Beispiel für die Verwendung von Pre-SQL ist die Erstellung einer Relation für die zu verarbeitenden Datensätze.

Automatischer Commit von Pre-SQL

Aktivieren Sie dieses Kästchen, um die Pre-SQL-Anweisungen zu übergeben, bevor die SQL-Anweisungen auf der Registerkarte Allgemein ausgeführt werden.

Wenn Sie dieses Kästchen nicht aktivieren, werden die Pre-SQL-Anweisungen in der gleichen Transaktion wie die SQL-Anweisungen auf der Registerkarte Allgemein übergeben.

Anmerkung: Wenn Sie weder das Kästchen Automatischer Commit von Pre-SQL noch das Kästchen Automatischer Commit von Post-SQL aktivieren, werden alle SQL-Anweisungen für den Schritt in einer Transaktion übergeben.
Post-SQL

Geben Sie eine oder mehrere SQL-Anweisungen ein, die Sie ausführen möchten, nachdem alle Datensätze verarbeitet wurden. Die von Ihnen hier eingegebenen SQL-Anweisungen werden einmal pro Ausführung ausgeführt, nachdem der „SQL Command“-Schritt beendet ist, aber bevor der Datenfluss beendet wird.

Eine Beispielanwendung von Pre-SQL wäre der Aufbau eines Index nach der Verarbeitung der Datensätze.

Automatischer Commit von Post-SQL

Aktivieren Sie dieses Kästchen, um die Post-SQL-Anweisungen in ihrer eigenen Transaktion zu übergeben, nachdem die SQL-Befehle der Registerkarte Allgemein übergeben wurden.

Wenn Sie dieses Kästchen nicht aktivieren, werden die Post-SQL-Anweisungen in der gleichen Transaktion wie die SQL-Anweisungen auf der Registerkarte Allgemein übergeben.

Anmerkung: Wenn Sie weder das Kästchen Automatischer Commit von Pre-SQL noch das Kästchen Automatischer Commit von Post-SQL aktivieren, werden alle SQL-Anweisungen für den Schritt in einer Transaktion übergeben.

Registerkarte „Laufzeit“

Die Registerkarte Laufzeit enthält Schrittoptionen und gibt Ihnen die Möglichkeit, Standardwertwerte für die Schrittoptionen zu definieren.

Feldname

Beschreibung

Schrittoptionen
In diesem Abschnitt sind die Datenflussoptionen aufgeführt, die in der SQL-Abfrage dieses Schrittes verwendet werden. Zudem können Sie hier einen Standardwert für diese Optionen angeben. In der Spalte Name sind die Optionen aufgelistet. In der entsprechenden Spalte Wert können Sie die Standardwerte eingeben.
Anmerkung: Der hier angegebene Standardwert wird auch im Abschnitt Datenflussoptionen zu Schritten zuordnen des Dialogfeldes Datenflussoptionen angezeigt. Mithilfe der Dialogbox können Sie außerdem den Standardwert ändern. Wenn für Standardwerte einer Option unterschiedliche Werte über Schrittoptionen, Datenflussoptionen und Job Executor angegeben sind, gilt folgende Rangfolge: im Job Executor angegebener Wert > unter Datenflussoptionen definierter Wert > unter Schrittoptionen eingegebener Wert.