Udostępnij za pośrednictwem

Co to są parametry pulpitu nawigacyjnego?

  • Artykuł

Parametry pulpitu nawigacyjnego AI/BI to jeden ze sposobów na interaktywne tworzenie pulpitów nawigacyjnych, dzięki czemu osoby przeglądające mogą używać selektorów z jedną wartością i selektorów dat w czasie wykonywania. Na przykład można użyć parametrów do filtrowania danych na podstawie kryteriów, takich jak daty i kategorie produktów, zanim dane są 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 do zapytania

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

Plik GIF przedstawia przykład poniższych kroków.

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 zapytania

Aby edytować parametr:

  1. Kliknij Ikona koła zębatego obok nazwy parametru. Zostanie wyświetlone okno dialogowe Szczegóły parametru i 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.

Ustawianie domyślnej wartości parametru

Wartość domyślną parametru można ustawić, wpisując ją w polu tekstowym pod nazwą parametru. Uruchom zapytanie, aby wyświetlić podgląd wyników zapytania z zastosowaną wartością parametru. Uruchomienie zapytania umożliwia również zapisanie wartości domyślnej. Po ustawieniu tego parametru za pomocą widżetu filtru na kanwie zostanie użyta wartość domyślna.

Parametry oparte na zapytaniach

Parametry oparte na zapytaniach umożliwiają autorom zdefiniowanie dynamicznej lub statycznej listy wartości, które osoby przeglądające mogą wybrać podczas ustawiania parametrów podczas eksplorowania danych na pulpicie nawigacyjnym. Są one definiowane przez połączenie filtru pola i filtru parametrów w jednym widżecie filtru.

Aby utworzyć parametr oparty na zapytaniach, autor pulpitu nawigacyjnego wykonuje następujące kroki:

  1. Utwórz zestaw danych, którego zestaw wyników jest ograniczony do listy możliwych wartości parametrów.
  2. Utwórz zapytanie zestawu danych, które używa parametru.
  3. Skonfiguruj widżet filtru na kanwie filtru, który filtruje pole i używa parametru.
    • Konfiguracje pól należy ustawić tak, aby używało pola z żądaną listą kwalifikujących się wartości parametrów.
    • Konfiguracja parametrów powinna być ustawiona, aby wybrać wartość parametru.

Uwaga

Jeśli zestaw danych używany w parametrach opartych na zapytaniach jest również używany w innych wizualizacjach na pulpicie nawigacyjnym, wybór filtru przeglądarki modyfikuje wszystkie połączone zapytania. Aby tego uniknąć, autorzy powinni utworzyć dedykowany zestaw danych dla parametrów opartych na zapytaniach, które nie są używane w żadnych innych wizualizacjach na pulpicie nawigacyjnym.

Zobacz Używanie parametrów opartych na zapytaniach, aby zapoznać się z samouczkiem krok po kroku, który pokazuje, jak dodać parametr i wizualizację opartą na zapytaniach.

Tworzenie dynamicznej listy parametrów

Aby utworzyć dynamiczny zestaw danych, który wypełnia listę rozwijaną używaną przez osoby przeglądające do wybierania wartości parametrów, napisz zapytanie SQL zwracające jedno pole i zawierające wszystkie wartości w tym polu. Każda nowa wartość w tym polu jest automatycznie dodawana jako wybór parametru po zaktualizowaniu zestawu danych. Przykładowe zapytanie SQL jest następujące:

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

Tworzenie listy parametrów statycznych

Możesz utworzyć statyczny zestaw danych zawierający tylko wartości, które są zakodowane na stałe w zestawie danych. Przykładowe zapytanie wygląda następująco:

SELECT
  *
FROM
  (
    VALUES
      ('MACHINERY'),
      ('BUILDING'),
      ('FURNITURE'),
      ('HOUSEHOLD'),
      ('AUTOMOBILE')
  ) AS data(available_choices)

Typy filtrów

Filtry pojedynczej wartości i selektora dat obsługują parametry ustawień. Podczas ustawiania parametrów opartych na zapytaniach z filtrem selektora dat daty wyświetlane w wynikach zapytania bazowego są wyświetlane na czarno. Daty, które nie są wyświetlane w wynikach zapytania, są szare. Użytkownicy mogą wybierać szare daty, mimo że nie są uwzględnione w zapytaniu bazowym.

Usuwanie parametru zapytania

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

Pokaż parametry na pulpicie nawigacyjnym

Dodanie filtru do kanwy pulpitu nawigacyjnego umożliwia widzom wybieranie i modyfikowanie wartości parametrów, dzięki czemu mogą interaktywnie eksplorować i analizować dane. Jeśli nie uwidaczniasz parametru na pulpicie nawigacyjnym, osoby przeglądające zobaczą tylko wyniki zapytania, które używają domyślnej wartości parametru ustawionej w zapytaniu.

Aby dodać parametr do pulpitu nawigacyjnego:

  1. Kliknij pozycję Ikona filtru Dodaj filtr (pole/parametr).
  2. Kliknij przycisk ikona dodawania pola 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

W poniższych przykładach przedstawiono niektóre typowe przypadki użycia parametrów.

Wstaw datę

Poniższy przykład zawiera parametr Date , który ogranicza wyniki zapytania do rekordów po określonej dacie.


SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  sum(o_totalprice) AS `Total Price`
FROM
  samples.tpch.orders
WHERE
  o_orderdate > :date_param
GROUP BY
  1,
  2

Wstaw liczbę

Poniższy przykład zawiera parametr liczbowy, który ogranicza wyniki do rekordów, w których o_total_price pole jest większe niż podana wartość parametru.


SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  o_totalprice AS Price
FROM
  samples.tpch.orders
WHERE
  o_totalprice > :num_param

Wstaw nazwę pola

W poniższym przykładzie field_param parametr jest używany z funkcją IDENTIFIER w celu zapewnienia wartości progowej zapytania w czasie wykonywania. Wartość parametru powinna być nazwą kolumny z tabeli używanej w zapytaniu.


SELECT
  *
FROM
  samples.tpch.orders
WHERE
  IDENTIFIER(:field_param) < 10000

Wstawianie obiektów bazy danych

Poniższy przykład tworzy trzy parametry: catalog, schemai table. Osoby przeglądające pulpit nawigacyjny mogą używać widżetów filtrów na kanwie do wybierania wartości parametrów.


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

Zobacz klauzulę IDENTIFIER.

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.

Łączenie wielu parametrów

Parametry można uwzględnić w innych funkcjach SQL. W tym przykładzie można wybrać tytuł pracownika i identyfikator numeru. Zapytanie używa format_string funkcji do łączenia dwóch ciągów i filtrowania wierszy, które są zgodne. Zobacz format_string funkcja.


SELECT
  o_orderkey,
  o_clerk
FROM
  samples.tpch.orders
WHERE
  o_clerk LIKE format_string('%s%s', :title, :emp_number)

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.