Użyj parametrów w Lakeflow Designer

Parametry to nazwane wartości definiowane dla całego przygotowania danych wizualnych. Możesz odwoływać się do parametrów w kodzie operatorów SQL i Python, w polach konfiguracji obsługiwanych operatorów oraz w wyrażeniach umożliwiających lub wyłączających operatory. Parametry pozwalają uruchomić te same wizualne przygotowania danych w różnych środowiskach, na przykład katalog testowy w fazie rozwoju i katalog produkcyjny w produkcji.

Zdefiniuj parametry

Aby zarządzać parametrami, wybierz Parametry w lewym panelu. Każdy parametr ma wartość ustawioną podczas jego definiowania. Gdy Visual Data Prep działa według harmonogramu lub jako zadanie, możesz nadpisać tę wartość. Zobacz Nadpisywanie wartości parametrów w środowisku produkcyjnym.

Odwołaj się do parametru operatora

To, jak odniesiesz się do parametru, zależy od tego, gdzie go używasz:

  • Operator SQL: użyj składni znacznika nazwanego parametru, takiej jak :environment. Zobacz Używanie nazwanych znaczników parametrów.
  • operator w języku Python: Wywołanie dbutils.widgets.get(), na przykład dbutils.widgets.get("environment"). Zobacz Narzędzie Widgets (dbutils.widgets).
  • Obsługiwane pola konfiguracyjne operatora: W panelu konfiguracji operatora wybierz Parametry w prawym górnym rogu. Wybierz pole i wprowadź wyrażenie takie jak :source_table. Obsługiwane dziedziny obejmują:
    • Źródło: tabela, ścieżka pliku i format pliku.
    • Wyjście: Katalog, Schemat,Tabela, Widok, Tom,Nazwa pliku oraz tryb zapisu.
    • Limit: Limit.
    • Łącz: Ustawienie operacji, Strategia scalania, Suma według nazwy oraz Zezwalaj na brakujące kolumny.

Po otwarciu operatora SQL lub Python do edycji program Lakeflow Designer pokazuje przykład sposobu odwołowania się do dostępnych parametrów powyżej edytora źródłowego.

Łącz parametry z tekstem stałym

W wyrażeniu parametrów dla operatora źródłowego lub wyjściowego używamy :parameter_name do zastąpienia całej wartości. Aby połączyć parametry z tekstem stałym, otoczyć tekst pojedynczymi cudzysłowami i użyć ||. Na przykład następujący wyrażenie Source Table konstruuje w pełni kwalifikowaną nazwę tabeli:

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

Włącz lub wyłącz operator za pomocą parametru

Możesz użyć parametru, aby włączyć lub wyłączyć dowolny skonfigurowany operator. W panelu Parametry wybierz Disabled i wprowadź wyrażenie boolowske. Na przykład :skip_operator wyłącza operatora, gdy parametr wynosi true. Operator wyłączony nie generuje żadnych wierszy wyjściowych.

Aby ręcznie włączyć lub wyłączyć operatora, zobacz Zmiana nazwy, kopiowanie, usuwanie i wyłączanie operatorów.

Nadpisz wartości parametrów w produkcji

W czasie działania Visual Data Prep odczytuje swoje parametry w ten sam sposób, niezależnie od tego, czy działa interaktywnie, czy jako zadanie, więc ten sam plik działa we wszystkich środowiskach bez zmian. Dla każdego środowiska podaj różne wartości w następujący sposób:

  • Podczas planowania zadania w interfejsie użytkownika: przesłaniaj wartości parametrów dla każdego harmonogramu. Na przykład zaplanuj to samo przygotowanie danych wizualnych do codziennego uruchamiania w południe z parametrem environment ustawionym na test, a następnie ponownie o 14:00 z environment ustawionym na production. Zobacz Zaplanuj jako zadanie.
  • Podczas wdrażania za pomocą pakietu: ustaw wartości parametrów za pomocą zadania parametersi użyj elementów docelowych pakietu, aby podać różne wartości dla danego środowiska. Cele deweloperskie i produkcyjne pakietu umożliwiają wdrożenie tego samego zadania w oddzielnych środowiskach z ustawieniami specyficznymi dla danego środowiska. Zobacz tryby wdrażania deklaratywnych pakietów automatyzacji i konfigurację deklaratywnych pakietów automatyzacji.

Dodatkowe zasoby

  • Ostatnia aktualizacja o