Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Parameter in Lakeflow Designer sind benannte Werte, die für die visuelle Datenvorbereitung als Ganzes definiert sind. Man kann Parameter in SQL- und Python-Operatorcode, in unterstützten Operator-Konfigurationsfeldern und in Ausdrücken referenzieren, die Operatoren aktivieren oder deaktivieren. Parameter ermöglichen es, dieselbe visuelle Datenvorbereitung für verschiedene Umgebungen auszuführen, zum Beispiel einen Testkatalog während der Entwicklung und einen Produktionskatalog in der Produktion.
Requirements
- Um Parameter zu erstellen oder Feldbelegungen zu ändern, benötigen Sie die Berechtigung, die visuelle Datenvorbereitung zu bearbeiten.
- Um eine Gruppe zu parametrisieren, benötigen Sie die Berechtigung, diese zu bearbeiten
- die visuelle Datenvorbereitung bearbeiten
- Vorschauen ausführen
Parameter definieren
Um Parameter zu verwalten, wähle Parameter im linken Bereich aus. Jeder Parameter hat einen Wert, den Sie beim Definieren festgelegt haben. Wenn die visuelle Datenvorbereitung nach einem Zeitplan oder als Auftrag läuft, kannst du diesen Wert überschreiben. Siehe Parameterwerte in der Produktion überschreiben.
In dem Bereich werden die Operatoren aufgelistet, die den jeweiligen Parameter verwenden. Wählen Sie einen Operatornamen aus, um ihn auf dem Canvas in den Fokus zu rücken.
Referenz auf einen Parameter aus einem Operator
Wie man einen Parameter referenziert, hängt davon ab, wo man ihn verwendet:
-
SQL-Operator: Verwenden Sie benannte Parametermarker-Syntax, wie zum Beispiel
:environment. Siehe Verwenden von benannten Parametermarkierungen. -
Python-Operator: Rufen Sie
dbutils.widgets.get()auf, wiedbutils.widgets.get("environment"). Siehe Widgets-Tool (dbutils.widgets). -
Unterstützte Operator-Konfigurationsfelder: Bewegen Sie den Mauszeiger über das Feld im Konfigurationsbereich des Operators und wählen Sie dann
(Verwenden Sie einen Parameter). Geben Sie einen Ausdruck wie
:source_table, oder wählen Sie einen bestehenden Parameter aus. Unterstützte Fachgebiete umfassen:- Quelle: Tabelle, Dateipfad und Dateiformat.
- Ausgabe: Katalog, Schema, Tabelle, Ansicht, Volume, Dateiname und Schreibmodus.
- Limit: Limit.
- Filter: Individuelle Bedingungsausdrücke.
- Vorbereiten: Unterstützte Felder innerhalb einzelner Aktionen.
- Kombinieren: Operation festlegen, Zusammenführungsstrategie, Vereinigung nach Namen und fehlende Spalten zulassen.
Um einen Parameter während der Konfiguration eines unterstützten Feldes zu definieren, wählen Sie im Parameterwähler Parameter erstellen . Konfigurieren Sie den neuen Parameter im Parameterbereich und verwenden Sie ihn dann im Feld.
Wenn Sie einen SQL- oder Python-Operator für die Bearbeitung öffnen, zeigt Lakeflow Designer ein Beispiel für den Verweis auf die verfügbaren Parameter über dem Quell-Editor.
Parameter mit festem Text kombinieren
Verwenden Sie in einem Parameterausdruck für einen Quell- oder Ausgabeoperator :parameter_name, um einen vollständigen Wert zu ersetzen. Um Parameter mit festem Text zu kombinieren, setzen Sie den Text in einfache Anführungszeichen und verwenden Sie ||. Zum Beispiel erstellt der folgende Source-Table-Ausdruck einen vollständig qualifizierten Tabellennamen:
:catalog || '.' || :schema || '.' || :table
Aktivieren oder deaktivieren Sie einen Operator mit einem Parameter
Um zu steuern, ob ein konfigurierter Operator ausgeführt wird:
- Öffnen Sie den Konfigurationsbereich des Bedieners und wählen Sie
(Bedienereinstellungen).
- Wählen Sie neben Deaktiviert
(Verwenden Sie einen Parameter).
- Geben Sie einen booleschen Ausdruck ein, wie zum Beispiel
:skip_operator.
Der Ausdruck deaktiviert den Operator, wenn er auf True auswertet. Ein deaktivierter Operator erzeugt keine Ausgabezeilen.
Um eine ganze Gruppe zu steuern, öffne Gruppe deaktivieren oder Gruppe aktivieren in der Werkzeugleiste der Gruppe, und wähle (Einen Parameter verwenden) neben Disabled. Geben Sie einen booleschen Ausdruck ein und schließen Sie den Editor, um ihn anzuwenden.
Wenn Sie stattdessen einen Operator manuell aktivieren oder deaktivieren möchten, lesen Sie Operatoren umbenennen, kopieren, löschen und deaktivieren.
Parameterwerte in der Produktion überschreiben
Zur Laufzeit liest eine visuelle Datenvorbereitung ihre Parameter auf die gleiche Weise, egal ob sie interaktiv oder als Job ausgeführt wird, sodass dieselbe Datei in allen deinen Umgebungen ohne Änderungen funktioniert. Geben Sie für jede Umgebung unterschiedliche Werte an, wie folgt:
-
Wenn du einen Job in der Benutzeroberfläche planst: Überschreibe die Parameterwerte für jeden Zeitplan. Planen Sie zum Beispiel die gleiche visuelle Datenvorbereitung jeden Tag um zwölf Uhr mittags mit einem auf
testgesetztenenvironmentParameter und erneut um 14 Uhr mit aufproductiongesetztemenvironment. Siehe Als Auftrag planen. -
Wenn du mit einem Bundle deployest: Setze die Parameterwerte über die Jobs
parametersund nutze Bundle-Ziele, um pro Umgebung unterschiedliche Werte bereitzustellen. Mit Bündelung von Entwicklungs- und Produktionszielen können Sie denselben Auftrag in separaten Umgebungen mit umgebungsspezifischen Einstellungen bereitstellen. Weitere Informationen finden Sie unter Deklarative Automation Bundles-Bereitstellungsmodi und Konfiguration deklarativer Automatisierungspakete.