Konfigurieren von Auftragsparametern

Artikel
10/14/2024

In diesem Artikel werden die Auftragsparameterfunktionalität und das Konfigurieren von Auftragsparametern mit der Benutzeroberfläche des Databricks-Arbeitsbereichs beschrieben. Sie können auch Auftragsparameter zu JSON- und YAML-Definitionen hinzufügen, die mit der REST-API, CLI und DABs verwendet werden. Siehe Auftrags-API, Was ist die Databricks CLI?, und Was sind Databricks Asset Bundles?.

Was sind Auftragsparameter?

Auftragsparameter sind Schlüsselwertpaare, mit denen Sie Aufträge mit statischen oder dynamischen Standardwerten parametrisieren können. Beim Auslösen eines neuen Laufs können Sie optional die in einem Auftrag konfigurierten Parameter außer Kraft setzen. Siehe Ausführen eines Auftrags mit anderen Parametern.

Auftragsparameterschlüssel können nur _ - . oder alphanumerische Zeichen enthalten. Parameterwerte werden als Zeichenketten oder dynamische Wertverweise festgelegt. Siehe Was ist eine dynamische Wertreferenz?.

Hinweis

Sie können einen beliebigen gültigen JSON-Code als Parameterwert verwenden. Beispielsweise kann der For each-Aufgabentyp Listen wie die folgenden parsen:

[1, 2, 3]
['a', 'b', 'c']

Hinzufügen oder Bearbeiten von Auftragsparametern

Verwenden Sie das Dialogfeld Auftragsparameter, um neue Parameter hinzuzufügen, vorhandene Parameterschlüssel und -werte zu bearbeiten oder Parameter zu löschen.

Um die Parameter mit der Arbeitsbereich-Benutzeroberfläche zu bearbeiten, wählen Sie einen vorhandenen Auftrag mit den folgenden Schritten aus:

Klicken Sie in der Randleiste auf Workflows.
Klicken Sie in der Spalte Name auf den Auftragsnamen.
Klicken Sie in der Randleiste Auftragsdetails auf Parameter bearbeiten. Das Dialogfeld Auftragsparameter wird angezeigt.
Hinzufügen oder Bearbeiten von Parametern mithilfe der Felder Schlüssel und Wert.
Klicken Sie auf , um einen Parameter zu entfernen.
Klicken Sie zum Übernehmen der Änderungen auf Speichern.

Hinweis

Klicken Sie auf { }, um die verfügbaren dynamischen Wertverweise aufzulisten. Wählen Sie eine Option aus der Liste aus, um sie in das Feld Wert einzufügen.

Job-Parameter-Pushdown

Auftragsparameter werden automatisch als Schlüsselwert-Parameter an alle Aufgaben weitergegeben, die Schlüsselwert-Parameter akzeptieren. Dazu gehören die folgenden Aufgabentypen:

Notebook
Python-Wheel (nur bei Konfiguration mit Schlüsselwortargumenten)
SQL-Abfrage, Vorversion-Dashboard oder Datei
Auftrag ausführen

Auftragsparameter, die an Vorgänge übergeben werden, sind in der Aufgabenkonfiguration in der Benutzeroberfläche neben den konfigurierten Aufgabenparametern sichtbar.

Wichtig

Auftragsparameter haben Vorrang vor Vorgangsparametern. Wenn ein Auftragsparameter und ein Vorgangsparameter denselben Schlüssel aufweisen, überschreibt der Auftragsparameter den Vorgangsparameter.

Dynamische Wertverweise auf Auftragsparameter

Alle Aufgaben, die dynamische Wertverweise akzeptieren, können auf Auftragsparameter zugreifen.

Verwenden Sie den dynamischen Wertverweis {{job.parameters.<name>}}, der <name> durch den key ersetzt, der den Parameter identifiziert.

Ausführen eines Auftrags mit anderen Parametern

Sie können konfigurierte Auftragsparameter außer Kraft setzen oder neue hinzufügen, wenn Sie einen Auftrag mit verschiedenen Parametern ausführen. Siehe Ausführen eines Auftrags mit anderen Parametern.

Sie können Auftragsparameter auch überschreiben, wenn Sie einen Auftrag reparieren. Weitere Informationen finden Sie unter Erneutes Ausführen fehlgeschlagener und übersprungener Aufgaben.

Freigeben über