Eingehende Parameter für Aufgaben konfigurieren

Dieses Verfahren gilt nur für Aufgaben, bei denen Parameter zugewiesen wurden, oder in den zugrunde liegenden Datenflüssen von Integrationsaufgaben.

Zugewiesene Parameter haben Standardwerte, die während der Entwurfs- und Laufzeit der Pipeline verwendet werden.

Bei Bedarf können Sie den Standardwert eines eingehenden Parameters zur Entwurfs- und Laufzeit überschreiben. Sie können auch den Standardwert eines Parameters überschreiben, der in einem Ausdruck in einem eingehenden Parameter verwendet wird.

Um einen Wert zu überschreiben, können Sie zur Entwurfszeit direkt einen anderen Wert festlegen oder einen benutzerdefinierten Pipelineparameter für den Wert hinzufügen, der zur Laufzeit festgelegt wird. Gegebenenfalls können Sie der Eingabe auch einen Systemparameterwert oder einen Wert aus der Ausgabe eines vorherigen Operators zuweisen.

  1. Wählen Sie auf der Leinwand einer Pipeline die Aufgabe aus, für die Sie Werte für eingehende Parameter anzeigen oder konfigurieren möchten.
  2. Wählen Sie im Bereich Eigenschaften für die ausgewählte Aufgabe die Option Konfiguration aus.
  3. Prüfen Sie neben Konfiguriert für eingehende Parameter die Anzahl der konfigurierten und verfügbaren eingehenden Parameter.
    Beispiel: 0/4 bedeutet, dass vier eingehende Parameter in dieser Aufgabe verfügbar sind und dass kein Parameter neu konfiguriert wurde.
  4. Wählen Sie neben Konfigurierte eingehende Parameter die Option Konfigurieren aus.
  5. Prüfen Sie auf der Seite Eingehende Parameter konfigurieren die Eingaben, die neu konfiguriert werden können.
    Eine Eingabe hat einen Standardwert. Wenn der eingehende Parameter neu konfiguriert wird, weist die Eingabe einen konfigurierten Wert auf. Ein konfigurierter Wert kann ein benutzerdefinierter Parametername mit dem konfigurierten Wert in Klammern sein.
  6. (Optional) Wählen Sie in der Zeile mit dem Parametertyp und -wert, die neu konfiguriert werden sollen, die Option Konfigurieren aus.
    Wenn der eingehende Parameter bereits neu konfiguriert wurde, wählen Sie Bearbeiten aus, um den konfigurierten Wert zu ändern, oder wählen Sie Löschen aus, um den Wert zu entfernen.
  7. Führen Sie auf der Seite Eingehenden Parameter für <type> konfigurieren, die für den ausgewählten Parameter angezeigt wird, eine der Eingabekonfigurationsoptionen aus, und wählen Sie Fertig aus, um zur vorherigen Seite zurückzukehren.

    Beachten Sie Folgendes, wenn Sie eingehende Parameter konfigurieren:

    • Wenn eine Aufgabe für die Ausführung im OCI Data Flow-Service konfiguriert ist, verwenden Sie das folgende Format, wenn Sie die Standardparameterwerte für OCI_DF_LOG_BUCKET und OCI_DF_ARTIFACT_BUCKET bearbeiten: oci://<bucket-name>@<tenancy-name>
    • Wenn die inkrementelle Exportstrategie für eine BICC-Quelle so konfiguriert ist, dass ein Datum verwendet wird, das vom Data Integration-Systemparameter SYS.LAST_LOAD_DATE verwaltet wird, dürfen Sie den Datumswert während der Entwurfszeit nicht ändern.

    • Wenn die inkrementelle Exportstrategie für eine BICC-Quelle so konfiguriert ist, dass sie ein parametrisiertes letztes Exportdatum verwendet, das Sie hinzugefügt haben, können Sie den Datumswert während der Entwurfszeit und Laufzeit ändern.

    • Wenn eine parametrisierte Zieldatenentity für die Verwendung der Zusammenführungsstrategie konfiguriert ist, können Sie die Auswahl des Zusammenführungsschlüssels ändern.

    • Für ein parametrisiertes Datenasset, für das eine Staging Area erforderlich ist: Wenn Sie ein Datenasset auswählen, für das keine Standard-Staging Area in diesem Datenasset angegeben ist, zeigt Data Integration eine Warnmeldung an. Wenn die Benachrichtigung angezeigt wird, wählen Sie eine der folgenden Optionen:
      • Aktualisieren Sie dieses Datenasset, indem Sie eine Standard-Staging Area hinzufügen.
      • Wählen Sie ein anderes Datenasset mit einer Standard-Staging Area aus.
    • Für eine parametrisierte OCI Data Flow-Aufgabe:

      • Bei einer parametrisierten Treiber- oder Executor-Ausprägung werden die OCPUs und Speicherwerte ignoriert, wenn im Parameter eine nicht flexible Ausprägung konfiguriert ist. Die OCPUs und Speicherwerte werden nur verwendet, wenn Sie eine flexible Ausprägung als Parameterwert konfigurieren.

      • Stellen Sie mit parametrisierten OCPUs und Speicherwerten für eine flexible Ausprägung sicher, dass Sie einen Wert angeben, der im zulässigen Wertebereich für diese Eigenschaft liegt. Die zulässigen Werte für OCPUs hängen von der flexiblen Ausprägung ab. Die zulässigen Werte für den Speicher hängen vom OCPUs-Wert ab.

    Eingabeoption Beschreibung
    Wert zuweisen

    Überschreiben Sie den Standardwert für diesen Parameter, indem Sie einen Wert direkt angeben. Wie Sie einen Wert angeben, hängt vom eingehenden Parametertyp ab.

    Beispiel: Geben Sie einen Wert in ein Feld für einen numerischen Typ, einen String oder einen Datumstyp ein. Verwenden Sie jedoch ein Menü, um einen Wert für einen Parameter des Typs Datenasset, Verbindung, Schema und Datenentity auszuwählen. Bedingungen und Ausdrücke geben Sie mit dem Bedingungs- oder Ausdruckseditor ein.

    Vorherige Operatorausgabe

    Um einen Ausgabewert von einem vorherigen Operator als Eingabe für diesen Parameter zu verwenden, wählen Sie einen Wert in der Liste der verfügbaren Ausgaben aus.

    Nur Ausgaben mit demselben Typ wie der eingehende Parameter stehen zur Auswahl.

    Beispiel: Wenn ein eingehender Parameter STRING ist, sind nur SYS.STATUS und SYS.ERROR_MESSAGE verfügbar.

    Parameter zuweisen

    Geben Sie einen Pipelineparameter an, um einen anderen Wert festzulegen, wenn die Pipeline ausgeführt wird. Sie können einen benutzerdefinierten Parameter oder einen Systemparameter als Eingabe des eingehenden Parameters zuweisen.

    • Benutzerdefinierte Parameter verwenden: Wählen Sie gegebenenfalls einen vorhandenen benutzerdefinierten Parameter in der Liste der verfügbaren Parameter aus. Nur Parameter mit demselben Typ wie der eingehende Parameter stehen zur Auswahl.

      Wählen Sie gegebenenfalls Parameter hinzufügen aus, um einen Parameter in der Pipeline zur Auswahl zu erstellt. Im daraufhin angezeigten Bereich Parameter hinzufügen geben Sie einen Namen und eine optionale Beschreibung für den Parameter an. Der Datentyp kann nicht geändert werden. Dies entspricht dem Typ des eingehenden Parameters. Wie Sie die übrigen Felder für einen Parameter definieren, hängt vom eingehenden Typ ab. Um den Parameter zu erstellen, wählen Sie Hinzufügen aus. Standardmäßig ist der neu hinzugefügte benutzerdefinierte Parameter ausgewählt.

    • Systemparameter verwenden: Wählen Sie einen Systemparameter in der Liste der verfügbaren Parameter aus, die vom Laufzeitsystem generiert werden, sofern vorhanden. Nur Systemparameter mit demselben Typ wie der eingehende Parameter stehen zur Auswahl. OCID-Systemparameter werden als STRING behandelt.

      Beispiel: Wenn ein eingehender Parameter VARCHAR ist, sind nur TASK_RUN_NAME, TASK_RUN_KEY, PARENT_TASK_RUN_KEY, TASK_SCHEDULE_TIMEZONE, PIPELINE_NAME und PIPELINE_IDENTIFIER verfügbar.

  8. Prüfen Sie auf der Seite Eingehende Parameter konfigurieren den Standardwert und den konfigurierten Wert für den gerade neu konfigurierten Parameter.
    Ein konfigurierter Wert kann ein benutzerdefinierter Parametername mit dem konfigurierten Wert in Klammern sein.
  9. Wiederholen Sie gegebenenfalls die Schritte 6 und 7, um weitere Eingabewerte zu konfigurieren. Sie können auch Bearbeiten oder Löschen auswählen, um einen zuvor konfigurierten Wert zu ändern.
  10. Wählen Sie auf der Seite Eingehende Parametern konfigurieren die Option Konfigurieren aus, wenn Sie mit der Konfiguration von Werten für eingehende Parameter in der Aufgabe fertig sind.