Oracle Cloud Infrastructure-Dokumentation

SQL-Aufgabe erstellen

Eine SQL-Aufgabe in Data Integration ist mit einer gespeicherten Prozedur in einer Datenbank verknüpft.

Die Datenbank muss einem Datenasset zugeordnet sein, das bereits im Workspace erstellt wurde. Informationen zum Erstellen eines Datenassets finden Sie unter Datenasset erstellen.

Erstellen Sie eine SQL-Aufgabe in einem Projekt oder Ordner. Data Integration enthält ein Standardprojekt für die ersten Schritte. Informationen zum Erstellen eines weiteren Projekts oder Ordners finden Sie unter Projekte und Ordner.

In Data Integration können Sie standardmäßig gleichzeitige oder parallele Aufgabenausführungen einer Aufgabe zu einem bestimmten Zeitpunkt durchführen. Um nicht gleichzeitig gestartete Aufgabenausführungen manuell zuzulassen, aktivieren Sie beim Erstellen der Aufgabe das Kontrollkästchen Gleichzeitige Ausführung der Aufgabe deaktivieren. Wenn gleichzeitige Aufgabenausführungen nicht zulässig sind, verläuft eine Ausführungsanforderung für die Aufgabe nicht erfolgreich, wenn bereits eine Aufgabenausführung in Bearbeitung ist, die sich in einem nicht-terminalen Status befindet.

    1. Wählen Sie auf der Seite Aufgaben des Projekts oder Ordners, in dem Sie eine Aufgabe erstellen möchten, die Option Aufgabe erstellen und dann SQL aus. Wenn Sie Hilfe beim Suchen der Seite Aufgaben in einem Projekt oder Ordner benötigen, finden Sie weitere Informationen unter Aufgaben auflisten.
    2. Geben Sie auf der Seite SQL-Aufgabe erstellen einen Namen und eine optionale Beschreibung ein.

      Die ID ist ein vom System generierter Wert, der auf dem Namen basiert. Sie können den Wert ändern. Nachdem Sie die Aufgabe erstellt und gespeichert haben, können Sie die ID jedoch nicht mehr aktualisieren.

    3. Aktivieren Sie das Kontrollkästchen Gleichzeitige Ausführung der Aufgabe deaktivieren, wenn Sie gleichzeitige Ausführungen dieser Aufgabe nicht zulassen möchten.
    4. (Optional) Klicken Sie für Projekt oder Ordner auf Auswählen, und wählen Sie ein anderes Projekt oder einen anderen Ordner zum Speichern der Aufgabe aus.
    5. Um die Aufgabe zum ersten Mal zu speichern, wählen Sie eine der folgenden Schaltflächen:

      • Erstellen: Erstellen und speichern Sie die Aufgabe. Sie können die Aufgabe weiter erstellen und bearbeiten.

      • Erstellen und schließen: Erstellt und speichert die Aufgabe, schließt die Seite und kehrt zur Aufgabenliste auf der Detailseite des Projekts oder Ordners zurück.

    6. Speichern Sie regelmäßig, indem Sie eine der folgenden Schaltflächen auswählen:

      • Speichern: Schreibt die Änderungen seit dem letzten Speichern fest. Nach dem Speichern können Sie mit der Bearbeitung fortfahren.

      • Speichern und schließen: Schreibt Änderungen fest, schließt die Seite und kehrt zur Aufgabenliste auf der Detailseite des Projekts oder Ordners zurück.

      • Speichern unter: Schreibt Änderungen (seit dem letzten Speichern) fest und speichert sie in einer Kopie, anstatt die aktuelle Aufgabe zu überschreiben. Sie können einen Namen für die Kopie angeben und ein anderes Projekt oder einen anderen Ordner für die Kopie auswählen oder die Kopie in demselben Projekt oder Ordner wie die vorhandene Aufgabe speichern.

    7. Klicken Sie im Abschnitt SQL auf Auswählen, und wählen Sie das Datenasset aus, das mit der Datenbank verknüpft ist, in der die zu verwendende Stored Procedure gespeichert ist.

      Wählen Sie auf der angezeigten Seite SQL auswählen die Typen direkt aus, oder parametrisieren Sie die Ressourcentypen nur in der Reihenfolge, in der die Typen angezeigt werden.

      1. Um Ressourcentypen direkt zu suchen und auszuwählen, klicken Sie neben einem Typ auf Auswählen, wenn er zur Auswahl verfügbar ist.

        • Datenasset: Der Name des Datenassets.

        • Verbindung: Die Verbindung für den Zugriff auf die Datenbank, die mit dem Datenasset verknüpft ist.

        • Schema: Das Schema, das Eigentümer der gespeicherten Prozedur ist.

        • Gespeicherte Prozedur: Der Name der gespeicherten Prozedur, die für diese SQL-Aufgabe verwendet werden soll.

          So zeigen Sie die Parameter in einer Stored Procedure an, bevor Sie die Prozedur auswählen:

          1. Wählen Alle anzeigen im Bereich Stored Procedures auswählen aus.
          2. Suchen Sie im Bereich Stored Procedure durchsuchen die gewünschte Stored Procedure, und wählen Sie im Menü "Aktionen" (Menü "Aktionen") dieser gespeicherten Prozedur die Option Parameter anzeigen aus.
      2. So weisen Sie den Ressourcentypen Parameter zu:

        1. Wählen Sie Parameter zuweisen neben einem Ressourcentyp aus.

        2. Führen Sie auf der Seite Parameter zuweisen eine der folgenden Aktionen aus:

          • Wählen Sie einen Parameter in der Liste aus. In der Liste werden nur Parameter desselben Ressourcentyps zur Auswahl angezeigt.

          • Wählen Sie Parameter hinzufügen aus, um einen Parameter für den Ressourcentyp hinzuzufügen.

            1. Geben Sie im Bereich Parameter hinzufügen eine ID und eine optionale Beschreibung ein.

            2. Legen Sie den Standardwert des Parameters für den Ressourcentyp fest.

              Für den Stored Procedure-Typ können Sie die Parameter in einer Stored Procedure anzeigen, bevor Sie das Verfahren auswählen. Wählen Sie Alle anzeigen neben dem Menü Gespeicherte Prozedur. Im daraufhin angezeigten Bereich Stored Prozedur durchsuchen suchen Sie die gewünschte gespeicherte Prozedur, und wählen Sie im Menü "Aktionen" (Menü "Aktionen") für diese gespeicherte Prozedur die Option "Parameter anzeigen" aus.

            3. Klicken Sie auf Hinzufügen.

              Der hinzugefügte Ressourcentypparameter wird automatisch auf der Seite Parameter zuweisen ausgewählt.

        3. Wählen Sie Zuweisen aus.
      3. Wählen Sie auf der Seite SQL auswählen die Option Fertig aus.

        Sie kehren zur Seite SQL-Aufgabe erstellen zurück.

    8. Wählen Sie im Abschnitt Parameter konfigurieren die Option Konfigurieren aus, um die Parameterliste zu prüfen und ihre Werte zu konfigurieren.

      Die Anzahl der Parameter in der Stored Procedure wird neben Parameter konfiguriert angezeigt. Nur Eingabeparameterwerte in der Stored Procedure können konfiguriert werden.

      Der konfigurierte Wert eines Eingabeparameters muss mit dem definierten Datentyp dieses Parameters übereinstimmen. Beispiel: Sie können keinen STRING-Wert für einen Eingabeparameter mit dem Datentyp NUMERIC angeben.

      Konfigurieren Sie auf der Seite Parameter für Stored Procedures konfigurieren einen Parameterwert wie folgt:

      1. Wählen Sie in der Zeile des Eingabeparameterwerts, den Sie konfigurieren möchten, die Option Konfigurieren aus.
      2. Geben Sie im Bereich Parameter bearbeiten einen Wert für den Eingabeparameter ein, und wählen Sie Speichern aus.

        Nach dem Konfigurieren eines Eingabeparameters können Sie den Wert bearbeiten oder löschen.

      3. Wenn Sie die Konfiguration der Eingabeparameter abgeschlossen haben, wählen Sie Konfigurieren.
    9. (Optional) Wählen Sie im Abschnitt Aufgabe validieren die Option Validieren aus, um die konfigurierten Parameterwerte zu prüfen.

      Wenn Fehler oder Warnungen vorhanden sind, wählen Sie Nachrichten anzeigen. Lösen Sie alle Fehler, bevor Sie die Aufgabe veröffentlichen.

      Hinweis

      Eine SQL-Aufgabe kann nicht ausgeführt werden, wenn die Eingabeparameter des Datentyps NUMERIC NULL als konfigurierte Standardwerte aufweisen. Um Fehler bei der Aufgabenausführung zu vermeiden, ändern Sie einen NULL-Wert in 0 (null).
    10. Wenn Sie die Konfiguration der Aufgabe abgeschlossen haben, wählen Sie Erstellen und schließen oder Speichern und schließen aus.
    Veröffentlichen Sie die SQL-Task in einer Anwendung in Data Integration, bevor Sie die Task ausführen oder die Ausführung der Task planen. Informationen zur Veröffentlichung finden Sie unter In einer Data Integration-Anwendung veröffentlichen.

  • Verwenden Sie den Befehl oci data-integration task create-task-from-SQL-task und die erforderlichen Parameter, um eine SQL-Aufgabe zu erstellen:

    oci data-integration task create-task-from-sql-task [OPTIONS]

    Eine vollständige Liste der Kennzeichen und Variablenoptionen für CLI-Befehle finden Sie in der Befehlszeilenreferenz.

  • Führen Sie den Vorgang CreateTask mit dem entsprechenden Ressourcensubtyp aus, um eine SQL-Aufgabe zu erstellen.