Udostępnij za pośrednictwem

Składnia parametrów Mustache

Ważna

Składnia parametrów Mustache jest obsługiwana tylko w starszym edytorze SQL. Databricks zaleca używanie nazwanych znaczników parametrów do nowych zapytań. Jeśli skopiujesz zapytanie przy użyciu składni Mustache do notatnika, edytora zbioru danych panelu AI/BI lub przestrzeni Genie, musisz przekonwertować je na nazwane znaczniki parametrów przed jego uruchomieniem.

W starszym edytorze SQL wszystkie ciągi opakowane w podwójne nawiasy klamrowe ({{ }}) są traktowane jako parametr zapytania. Widżet jest wyświetlany powyżej okienka wyników, w którym ustawiono wartość parametru.

Dodawanie parametru wąsu

  1. Naciśnij Cmd + I. Parametr jest wstawiany na pozycji kursora, a zostanie wyświetlone okno dialogowe Dodawanie parametru .
  2. Wprowadź słowo kluczowe, opcjonalnie zmień tytuł i wybierz typ.
  3. Kliknij pozycję Dodaj parametr.
  4. Ustaw wartość parametru w widżecie.
  5. Kliknij pozycję Zastosuj zmiany.
  6. Kliknij Zapisz.

Alternatywnie wpisz {{ }} bezpośrednio w zapytaniu i kliknij ikonę koła zębatego w widżecie parametru, aby go skonfigurować.

Aby ponownie uruchomić zapytanie z inną wartością, zaktualizuj widżet i kliknij przycisk Zastosuj zmiany.

Edytowanie, usuwanie i zmienianie kolejności parametrów

Edytuj: kliknij ikonę koła zębatego obok widżetu parametru. Aby uniemożliwić użytkownikom, którzy nie są właścicielami zapytania zmiany wartości parametru, kliknij pozycję Pokaż tylko wyniki.

Usuń: usuń znacznik parametru z zapytania. Widżet zostanie usunięty automatycznie.

Zmień kolejność: kliknij i przeciągnij widżety parametrów do żądanej kolejności.

Typy widżetów

Dostępne są następujące typy widżetów:

Tekst

Przyjmuje ciąg jako dane wejściowe. Ukośnik wsteczny, pojedynczy i podwójny cudzysłów są automatycznie znakowane ukośnikiem. Usługa Azure Databricks dodaje znaki cudzysłowu wokół wartości.

SELECT * FROM samples.tpch.customer WHERE c_name = {{ name_param }}

Liczba

Przyjmuje liczbę jako dane wejściowe.

SELECT * FROM users WHERE age = {{ number_param }}

Data i godzina

Parametryzuje wartości daty i znacznika czasu. Dostępne są trzy opcje:

Typ Dokładność
Data Dzień
Data i godzina Minuta
Data i godzina (z sekundami) Sekunda

Wszystkie wartości daty i godziny są przekazywane jako ciągi znaków i muszą być objęte pojedynczymi apostrofami w zapytaniu.

SELECT * FROM usage_logs WHERE date = '{{ date_param }}'

Po wybraniu opcji Zakres usługa Azure Databricks tworzy dwa parametry przy użyciu sufiksów .start i .end :

SELECT * FROM usage_logs
WHERE modified_time > '{{ date_range.start }}'
AND modified_time < '{{ date_range.end }}'

Uwaga / Notatka

Widżet Zakres dat zwraca poprawne wyniki tylko dla kolumn typu DATE. W przypadku kolumn znacznika czasu użyj widżetu Zakres dat i godzin.

Dynamiczne wartości dat: widżety daty zawierają niebieską ikonę błyskawicy. Kliknij ją, aby wybrać wartości dynamiczne, takie jak today, , yesterdaythis week, last week, last monthlub last year. Te wartości są aktualizowane automatycznie.

Ważna

Dynamiczne wartości dat nie są zgodne z zaplanowanymi zapytaniami.

Ogranicza dane wejściowe do wstępnie zdefiniowanej listy statycznej. Obsługuje zarówno wybór pojedynczej wartości, jak i wielu wartości.

  • Pojedyncza wartość: zawijaj parametr w pojedynczych cudzysłowach w zapytaniu.

  • Wiele wartości: włącz opcję Zezwalaj na wiele wartości w ustawieniach widżetu. Użyj opcji Cudzysłów, aby kontrolować, czy wartości zawierają się w pojedynczym cudzysłowie, podwójnym cudzysłowie, czy w żadnym. Zaktualizuj instrukcję WHERE, aby użyć IN.

    SELECT * FROM orders WHERE status IN ( {{ status_param }} )

    Po wybraniu podwójnych cudzysłowów zapytanie jest rozpoznawane jako : WHERE status IN ("value1", "value2", "value3").

Wartości listy rozwijanej to ciągi. Aby użyć dat lub sygnatur czasowych, wprowadź je w formacie wymaganym przez źródło danych.

Lista rozwijana oparta na zapytaniach

Wypełnia opcje listy rozwijanej z zapisanego zapytania. Zachowuje się jak Lista rozwijana, ale opcje są dynamiczne.

  1. W polu Typ w panelu ustawień wybierz Listę rozwijaną opartą na zapytaniach.
  2. Kliknij pole Zapytanie i wybierz zapisane zapytanie.

Jeśli zapytanie zwraca więcej niż jedną kolumnę, usługa Azure Databricks używa pierwszej kolumny. Jeśli zapytanie zwraca kolumny o nazwach name i value, widżet wyświetla kolumnę name, ale przekazuje powiązaną wartość value do zapytania w czasie wykonywania.

Przykład:

SELECT user_uuid AS 'value', username AS 'name' FROM users
wartość nazwa
1001 John Smith
1002 Jane Doe
1003 Tabele Bobby

Wartość przekazywana do bazy danych podczas wykonywania to 1001, 1002 lub 1003, nie nazwa wyświetlana.

Uwaga / Notatka

Wydajność spada, jeśli zapytanie źródłowe zwraca dużą liczbę rekordów.

Używanie parametrów wąsów na starszych pulpitach nawigacyjnych

Opcjonalnie zapytania mogą używać parametrów lub wartości statycznych. Gdy wizualizacja oparta na sparametryzowanym zapytaniu zostanie dodana do pulpitu nawigacyjnego, można skonfigurować każdy parametr tak, aby używał jednego z trzech źródeł wartości:

  • Parametr widżetu: dotyczy tylko pojedynczej wizualizacji, do której należy. Selektor wartości jest wyświetlany w panelu wizualizacji.
  • Parametr pulpitu nawigacyjnego: można zastosować do wielu wizualizacji na pulpicie nawigacyjnym. Selektor wartości jest wyświetlany w górnej części pulpitu nawigacyjnego. Dodawane domyślnie, gdy dodasz wizualizację sparametryzowaną do pulpitu nawigacyjnego.
  • Wartość statyczna: zastępuje parametr stałą wartością. Selektor wartości jest ukryty, dzięki czemu interfejs użytkownika pulpitu nawigacyjnego jest czysty dla parametrów, które nie muszą się zmieniać.

Aby uzyskać dostęp do ustawień mapowania parametrów, kliknij menu kebab w widżecie pulpitu nawigacyjnego i wybierz pozycję Zmień ustawienia widżetu.

Właściwości parametru pulpitu nawigacyjnego

Majątek Opis
Nazwa Nazwa wyświetlana obok selektora wartości. Domyślnie jest to słowo kluczowe parametru. Nie pokazano parametrów statycznych.
Słowo kluczowe Literał ciągu dla tego parametru w zapytaniu bazowym. Przydatne do debugowania nieoczekiwanych wyników.
Wartość domyślna Wartość używana, gdy nie określono żadnej innego wartości. Aby ją zmienić, uruchom zapytanie z żądaną wartością i kliknij przycisk Zapisz.
Źródło wartości Określa, skąd pochodzi wartość parametru. Opcje: Nowy parametr pulpitu nawigacyjnego, Istniejący parametr pulpitu nawigacyjnego, Parametr widżetu, Wartość statyczna.
  • Last updated on