Korzystanie z parametrów pulpitów nawigacyjnych

Parametry pulpitu nawigacyjnego to jeden ze sposobów interaktywnego tworzenia pulpitów nawigacyjnych, dzięki czemu osoby przeglądające mogą używać selektorów pojedynczej wartości i selektorów dat do wprowadzania określonych wartości w zapytaniach dotyczących zestawów danych w czasie wykonywania. Na przykład parametry mogą filtrować dane na podstawie kryteriów, takich jak daty i kategorie produktów, zanim będą agregowane w zapytaniu SQL, co pozwala na bardziej wydajne wykonywanie zapytań i dokładniejszą analizę.

Parametry są dodawane do zestawów danych i połączone z co najmniej jednym widżetem na kanwie pulpitu nawigacyjnego przez autora lub edytora pulpitu nawigacyjnego. Osoby przeglądające pulpit nawigacyjny korzystają z danych pulpitu nawigacyjnego, wybierając wartości w widżetach filtrów w czasie wykonywania. Spowoduje to ponowne uruchomienie skojarzonych zapytań i wyświetlenie wizualizacji opartych na filtrowanych danych.

Parametry bezpośrednio modyfikują zapytanie, co może być zaawansowane. Filtry zestawów danych mogą również oferować interakcyjność pulpitu nawigacyjnego, więcej funkcji i lepszą wydajność z dużymi zestawami danych niż parametry. Zobacz Filtry.

Dodawanie parametru

Aby dodać parametr do zestawu danych pulpitu nawigacyjnego pulpitu nawigacyjnego, musisz mieć co najmniej uprawnienia Do edycji pulpitu nawigacyjnego. Parametry można dodawać bezpośrednio do zapytań zestawu danych na karcie Dane .

Aby dodać parametr do zapytania:

1. Umieść kursor, w którym chcesz umieścić parametr w zapytaniu.

2. Kliknij pozycję Dodaj parametr , aby wstawić nowy parametr.

   Spowoduje to utworzenie nowego parametru o domyślnej nazwie parameter. Aby zmienić nazwę domyślną, zastąp ją w edytorze zapytań. Parametry można również dodać, wpisując tę składnię w edytorze zapytań.

Edytowanie parametru

Aby edytować parametr:

1. Kliknij obok nazwy parametru. Zostanie wyświetlone okno dialogowe Szczegóły parametru.

   Okno dialogowe zawiera następujące opcje konfiguracji:

   • Słowo kluczowe: słowo kluczowe reprezentujące parametr w zapytaniu. Można to zmienić tylko przez bezpośrednie zaktualizowanie tekstu w zapytaniu.
   • Nazwa wyświetlana: nazwa w edytorze filtrów. Domyślnie tytuł jest taki sam jak słowo kluczowe.
   • Typ: Obsługiwane typy obejmują ciąg, datę, datę i godzinę, numeryczne.
     • Domyślnym typem jest Ciąg.
     • Typ danych liczbowych umożliwia określenie między liczbami dziesiętnych i całkowitych. Domyślnym typem liczbowym jest Liczba dziesiętna.

2. Kliknij inną część interfejsu użytkownika, aby zamknąć okno dialogowe.

Usuwanie parametru

Aby usunąć parametr, usuń go z zapytania.

Używanie parametru na kanwie pulpitu nawigacyjnego

Aby dodać parametr do pulpitu nawigacyjnego:

1. Kliknij pozycję Dodaj filtr (pole/parametr).
2. Kliknij przycisk obok pozycji Parametry w panelu konfiguracji.
3. Kliknij nazwę parametru, który ma być używany przez przeglądarkę z tym widżetem.

Uwzględnij parametry w adresie URL

Ustawienia parametrów są przechowywane w adresie URL, co umożliwia użytkownikom dodawanie zakładek do obsługi stanu pulpitu nawigacyjnego, w tym wstępnie ustawionych filtrów i parametrów, lub udostępnianie go innym osobom w celu spójnego stosowania tych samych filtrów i parametrów.

Przykłady składni parametrów

(1) Wartości są wstawiane przy użyciu format_string funkcji . Zobacz format_string funkcja.

W poniższych przykładach przedstawiono przypadek użycia, po którym następuje przykładowa składnia.

• Uwzględnij tylko rekordy przed określoną datą.

  WHERE date_field < :date_param

• Uwzględnij tylko ceny poniżej określonej ceny.

  WHERE price < :max_price

• Wybierz tabelę do użycia w zapytaniu.

  SELECT * FROM IDENTIFIER(:param)

• Zmień wykaz, schemat i tabelę używaną w zapytaniu.

  SELECT * FROM IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

• Połącz dwa parametry z nawiasami kwadratowymi, aby utworzyć sformatowane numery telefonów.

  W poniższym przykładzie użyto format_string funkcji do wstawiania wartości. Zobacz format_string funkcja.

  format_string('(%d) %d', :area_code, :phone_number)

Ważne

Włączenie podglądu pulpitu nawigacyjnego w celu uzyskania dostępu do danych za pomocą wyborów parametrów, takich jak nazwy tabel lub katalogów, może prowadzić do przypadkowego ujawnienia poufnych informacji. Jeśli publikujesz pulpit nawigacyjny przy użyciu tych opcji, usługa Azure Databricks zaleca nie osadzanie poświadczeń na opublikowanym pulpicie nawigacyjnym.

Parametry pulpitu nawigacyjnego a parametry zapytania SQL usługi Databricks

Parametry pulpitu nawigacyjnego używają tej samej składni co nazwane znaczniki parametrów. Zobacz Nazwane znaczniki parametrów. Pulpity nawigacyjne nie obsługują parametrów stylu SQL usługi Databricks.