Używanie parametrów opartych na zapytaniach

W tym artykule przedstawiono procedurę tworzenia interaktywnego pulpitu nawigacyjnego korzystającego z parametrów opartych na zapytaniach. Przyjęto założenie, że podstawowa znajomość tworzenia pulpitów nawigacyjnych w usłudze Azure Databricks. Zobacz Wprowadzenie , aby zapoznać się z podstawowymi instrukcjami dotyczącymi tworzenia pulpitów nawigacyjnych.

Wymagania

• Zalogowano się do obszaru roboczego usługi Azure Databricks.
• Masz uprawnienie SQL w tym obszarze roboczym.
• Masz co najmniej dostęp do jednego lub większej liczby magazynów SQL.

Tworzenie zestawu danych pulpitu nawigacyjnego

W tym samouczku są używane wygenerowane dane z wykazu przykładów w usłudze Azure Databricks.

1. Kliknij pozycję Nowy na pasku bocznym i wybierz pozycję Pulpit nawigacyjny z menu.

2. Kliknij kartę Dane.

3. Kliknij pozycję Utwórz z bazy danych SQL i wklej następujące zapytanie do edytora. Następnie kliknij przycisk Uruchom , aby zwrócić wyniki.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. Nowo zdefiniowany zestaw danych jest automatycznie zapisany z nazwą Zestaw danych bez tytułu. Kliknij dwukrotnie tytuł, a następnie zmień jego nazwę na Segment marketingu.

Dodawanie parametru

Możesz dodać parametr do tego zestawu danych, aby filtrować zwrócone wartości. Parametrem w tym przykładzie jest :segment. Aby dowiedzieć się więcej o składni parametrów, zobacz Co to są parametry pulpitu nawigacyjnego?

1. Wklej następującą WHERE klauzulę w dolnej części zapytania. Poniżej zapytania zostanie wyświetlone pole tekstowe o nazwie segment parametru.

   WHERE
     c_mktsegment = :segment
   

2. Wpisz BUILDING w polu tekstowym poniżej zapytania, aby ustawić wartość domyślną parametru.

3. Uruchom ponownie zapytanie, aby sprawdzić wyniki.

Konfigurowanie widżetu wizualizacji

Dodaj wizualizację zestawu danych na kanwie, wykonując następujące kroki:

1. Kliknij kartę Kanwa .
2. Kliknij pozycję Dodaj wizualizację, aby dodać widżet wizualizacji i użyć myszy, aby umieścić ją na kanwie.

Konfigurowanie osi X

1. W razie potrzeby wybierz pozycję Pasek z menu rozwijanego Wizualizacja .
2. Kliknij , aby wybrać dane przedstawione wzdłuż osi X. Możesz użyć paska wyszukiwania, aby wyszukać pole według nazwy. Wybierz pozycję c_nationkey.
3. Kliknij wybraną nazwę pola, aby wyświetlić dodatkowe opcje konfiguracji.
   • Jako typ skalowania wybierz pozycję Kategoria.
   • Dla zaznaczenia Przekształć wybierz pozycję Brak.

Konfigurowanie osi Y

1. Kliknij przycisk obok osi Y, a następnie wybierz pozycję c_acctbal.
2. Kliknij wybraną nazwę pola, aby wyświetlić dodatkowe opcje konfiguracji.
   • Jako typ skalowania wybierz pozycję Ilościowe.
   • W obszarze Wyboru Przekształć wybierz pozycję SUM.

Wizualizacja zostanie automatycznie zaktualizowana podczas jej konfigurowania. Wyświetlane dane zawierają tylko rekordy, w których wartość segment to BUILDING.

Dodaj filtr

Skonfiguruj filtr, aby użytkownicy pulpitu nawigacyjnego mogli kontrolować, na którym segmencie marketingu ma się skupić.

1. Kliknij pozycję Dodaj filtr (pole/parametr), aby dodać widżet filtru. Umieść go na kanwie.
2. Z menu rozwijanego Filtr w panelu konfiguracji wybierz pozycję Pojedyncza wartość.
3. Zaznacz pole wyboru Tytuł, aby wyświetlić pole tytułu w widżecie filtru.
4. Kliknij tytuł symbolu zastępczego w widżecie i wpisz Segment, aby ponownie tytułować filtr.
5. Kliknij przycisk obok pozycji Parametry w panelu konfiguracji.
6. Wybierz segment z zestawu danych Segment marketingu.

Skonfigurowany widżet filtru pokazuje domyślną wartość parametru dla zestawu danych.

Definiowanie wyboru wartości

Utworzony filtr jest funkcjonalny, ale wymaga, aby osoba przeglądająca wiedziała o dostępnym zakresie wyborów, zanim będzie mogła wpisać wybór. Wymaga to również, aby użytkownicy dopasowali wielkość liter i pisownię podczas wprowadzania żądanej wartości parametru.

Aby utworzyć listę rozwijaną, aby przeglądarka mogła wybrać parametr z listy dostępnych opcji, utwórz nowy zestaw danych, aby zdefiniować listę możliwych wartości.

1. Kliknij kartę Dane.

2. Kliknij pozycję Utwórz z bazy danych SQL , aby utworzyć nowy zestaw danych.

3. Skopiuj i wklej następujące elementy do edytora:

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Uruchom zapytanie i sprawdź wyniki. Pięć segmentów marketingowych z tabeli jest wyświetlanych w wynikach.

5. Kliknij dwukrotnie automatycznie wygenerowany tytuł, a następnie zmień nazwę wybranego segmentu zestawu danych.

Aktualizowanie filtru

Zaktualizuj istniejący filtr, aby użyć właśnie utworzonego zestawu danych, aby wypełnić listę rozwijaną wartości, z których użytkownicy mogą wybierać.

1. Kliknij pozycję Kanwa. Następnie kliknij widżet filtru utworzony w poprzednim kroku.
2. Kliknij przycisk obok pozycji Pola.
3. Kliknij pozycję Wybór segmentu, a następnie kliknij nazwę c_mktsegmentpola .

Widżet filtru jest aktualizowany podczas zmieniania konfiguracji. Kliknij pole w widżecie filtru, aby wyświetlić dostępne opcje w menu rozwijanym.

Uwaga

Ten samouczek zawiera uproszczony przypadek użycia przeznaczony do zademonstrowania sposobu używania parametrów opartych na zapytaniach. Alternatywnym podejściem do tworzenia tego pulpitu nawigacyjnego jest zastosowanie filtru c_mktsegment do pola.

Następne kroki

Dowiedz się, jak pracować z pulpitami nawigacyjnymi, wykonując następujące artykuły:

• Dowiedz się więcej na temat stosowania filtrów. Zobacz Filtry.
• Dowiedz się więcej o parametrach pulpitu nawigacyjnego. Zobacz Co to są parametry pulpitu nawigacyjnego?.
• Publikowanie i udostępnianie pulpitu nawigacyjnego. Zobacz Publikowanie pulpitu nawigacyjnego.