Verwenden Sie Parameter in Lakeflow Designer

Parameter 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.

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.

Einen Parameter aus einem Operator referenzieren

Wie man einen Parameter referenziert, hängt davon ab, wo man ihn verwendet:

  • SQL-Operator: Verwenden Sie die Syntax mit benannten Parametermarkierungen, z. B. :environment. Siehe Verwenden von benannten Parametermarkierungen.
  • Python-Operator: Aufruf von dbutils.widgets.get(), z. B. dbutils.widgets.get("environment"). Siehe Widgets-Tool (dbutils.widgets).
  • Unterstützte Operator-Konfigurationsfelder: Im Konfigurationsfenster des Operators wählen Sie oben rechts Parameter aus. Wählen Sie ein Feld aus und geben Sie einen Ausdruck wie :source_table ein. Unterstützte Fachgebiete umfassen:
    • Quelle: Tabelle, Dateipfad und Dateiformat.
    • Ausgabe: Katalog, Schema, Tabelle, Ansicht, Volume, Dateiname und Schreibmodus.
    • Grenzwert: Grenzwert.
    • Kombinieren: Operation festlegen, Strategie zusammenführen, Vereinigungnach Name undfehlende Spalten erlauben.

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

Du kannst einen Parameter verwenden, um jeden konfigurierten Operator zu aktivieren oder zu deaktivieren. Im Parameterbereich wählen Sie Deaktiviert aus und geben Sie einen booleschen Ausdruck ein. Zum Beispiel deaktiviert den Operator, :skip_operator wenn der Parameter ist true. Ein deaktivierter Operator erzeugt keine Ausgabezeilen.

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 Sie einen Auftrag in der Benutzeroberfläche planen: Überschreiben Sie die Parameterwerte für jeden Zeitplan. Planen Sie zum Beispiel die gleiche visuelle Datenvorbereitung jeden Tag um zwölf Uhr mittags mit einem auf test gesetzten environment Parameter und erneut um 14 Uhr mit auf production gesetztem environment. Siehe Als Auftrag planen.
  • Wenn Sie mit einem Bundle bereitstellen: Legen Sie die Parameterwerte über den Auftrag parametersfest, und verwenden Sie Bundleziele, um unterschiedliche Werte pro Umgebung 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.

Zusätzliche Ressourcen

  • Zuletzt aktualisiert um