Gebruik parameters in Lakeflow Designer

Parameters zijn benoemde waarden die voor de visuele datavoorbereiding als geheel worden gedefinieerd. Je kunt parameters refereren in SQL- en Python-operatorcode, in ondersteunde operatorconfiguratievelden en in expressies die operatoren in- of uitschakelen. Parameters laten je dezelfde visuele datavoorbereiding uitvoeren in verschillende omgevingen, bijvoorbeeld een testcatalogus tijdens ontwikkeling en een productiecatalogus in productie.

Definieer parameters

Om parameters te beheren, selecteer je Parameters in het linkerdeelvenster. Elke parameter heeft een waarde die u instelt wanneer u deze definieert. Wanneer de visuele datavoorbereiding volgens een schema of als taak verloopt, kun je die waarde overschrijven. Zie Parameterwaarden overschrijven in productie.

Verwijs naar een parameter vanuit een operator

Hoe je naar een parameter verwijst, hangt af van waar je hem gebruikt:

  • SQL-operator: de syntaxis van benoemde parametermarkeringen gebruiken, zoals :environment. Zie Benoemde parametermarkeringen gebruiken.
  • Python-operator: Roep dbutils.widgets.get() aan, zoals dbutils.widgets.get("environment"). Zie het hulpprogramma Widgets (dbutils.widgets).
  • Ondersteunde operatorconfiguratievelden: Selecteer in het configuratiepaneel van de operator Parameters rechtsboven. Selecteer een veld en voer een uitdrukking in zoals :source_table. Ondersteunde vakgebieden zijn onder andere:
    • Bron: tabel, bestandspad en bestandsformaat.
    • Uitvoer: Catalogus, Schema, Tabel, Weergave, Volume, Bestandsnaam en Schrijfmodus.
    • Limiet: Limiet.
    • Combineer: Stel operatie in, Merge strategie, Union op naam en Sta ontbrekende kolommen toe.

Wanneer u een SQL- of Python-operator opent voor bewerking, ziet u in Lakeflow Designer een voorbeeld van het verwijzen naar de beschikbare parameters boven de broneditor.

Parameters combineren met vaste tekst

Gebruik in een parameteruitdrukking voor een bron- of uitvoeroperator :parameter_name om een volledige waarde te vervangen. Om parameters met vaste tekst te combineren, zet je de tekst tussen enkele aanhalingstekens en gebruik je ||. Bijvoorbeeld, de volgende Source Table-expressie construeert een volledig gekwalificeerde tabelnaam:

:catalog || '.' || :schema || '.' || :table

Schakel een operator in of uit met een parameter

Je kunt een parameter gebruiken om elke geconfigureerde operator in of uit te schakelen. Selecteer in het Parameters-paneelUitgeschakeld en voer een Booleaanse expressie in. Bijvoorbeeld, :skip_operator schakelt de operator uit wanneer de parameter is true. Een uitgeschakelde operator produceert geen rijen in de uitvoer.

Om een operator handmatig in of uit te schakelen, zie Operators hernoemen, kopiëren, verwijderen en uitschakelen.

Overschrijf parameterwaarden in productie

Tijdens runtime leest een visuele datavoorbereiding zijn parameters op dezelfde manier, of het nu interactief draait of als een taak, zodat hetzelfde bestand in al je omgevingen werkt zonder veranderingen. Geef verschillende waarden aan voor elke omgeving als volgt:

  • Wanneer u een taak in de gebruikersinterface plant: overschrijf de parameterwaarden voor elke planning. Plan bijvoorbeeld dezelfde visuele datavoorbereiding elke dag om twaalf uur 's middags met een environment parameter ingesteld op test, en opnieuw om 14.00 uur met environment gezet op production. Zie Plannen als taak.
  • Wanneer u implementeert met een bundel: stel de parameterwaarden in via de taak parametersen gebruik bundeldoelen om verschillende waarden per omgeving op te geven. Met bundelontwikkelings- en productiedoelen kunt u dezelfde taak implementeren in afzonderlijke omgevingen met omgevingsspecifieke instellingen. Zie de implementatiemodi voor declaratieve Automation-bundels en de configuratie van declaratieve Automation-bundels.

Aanvullende bronnen

  • Laatst bijgewerkt om