Använda frågebaserade parametrar

Artikeln vägleder dig genom stegen för att skapa en interaktiv instrumentpanel som använder frågebaserade parametrar. Den förutsätter grundläggande kunskaper om att skapa instrumentpaneler i Azure Databricks. Mer information om hur du skapar instrumentpaneler finns i Kom igång.

Krav

• Du är inloggad på en Azure Databricks-arbetsyta.
• Du har SQL-behörigheten på den arbetsytan.
• Du har minst KAN ANVÄNDA åtkomst till ett eller flera SQL-lager.

Skapa en instrumentpanelsdatauppsättning

I den här självstudien används genererade data från exempelkatalogen på Azure Databricks.

1. Klicka på Nytt i sidopanelen och välj Instrumentpanel på menyn.

2. Klicka på fliken Data.

3. Klicka på Skapa från SQL och klistra in följande fråga i redigeraren. Klicka sedan på Kör för att returnera resultatet.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. Din nyligen definierade datauppsättning sparas automatiskt med namnet Namnlös datauppsättning. Dubbelklicka på rubriken och byt sedan namn på den till marknadsföringssegmentet.

Lägga till en parameter

Du kan lägga till en parameter i den här datamängden för att filtrera de returnerade värdena. Parametern i det här exemplet är :segment. Mer information om parametersyntax finns i Arbeta med instrumentpanelsparametrar .

1. Klistra in följande WHERE sats längst ned i frågan. Ett textfält med parameternamnet segment visas under din fråga.

   WHERE
     c_mktsegment = :segment
   

2. Skriv BUILDING in i textfältet under din fråga för att ange standardvärdet för parametern.

3. Kör frågan igen för att granska resultatet.

Konfigurera en visualiseringswidget

Lägg till en visualisering för datamängden på arbetsytan genom att utföra följande steg:

1. Klicka på fliken Arbetsyta .
2. Klicka på Lägg till en visualisering för att lägga till en visualiseringswidget och använd musen för att placera den på arbetsytan.

Konfigurera X-axeln

1. Om det behövs väljer du Stapel på den nedrullningsbara menyn Visualisering .
2. Klicka för att välja de data som visas längs X-axeln. Du kan använda sökfältet för att söka efter ett fält efter namn. Välj c_nationkey.
3. Klicka på det fältnamn som du har valt för att visa ytterligare konfigurationsalternativ.
   • Som Skalningstyp väljer du Kategorisk.
   • För alternativet Transformera väljer du Ingen.

Konfigurera Y-axeln

1. Klicka bredvid Y-axeln och välj add field iconsedan c_acctbal.
2. Klicka på det fältnamn som du har valt för att visa ytterligare konfigurationsalternativ.
   • Som Skalningstyp väljer du Kvantitativ.
   • För alternativet Transformera väljer du SUMMA.

Visualiseringen uppdateras automatiskt när du konfigurerar den. De data som visas innehåller endast poster där segment är BUILDING.

Lägg till ett filter

Konfigurera ett filter så att instrumentpanelens visningsprogram kan styra vilket marknadsföringssegment som ska fokuseras på.

1. Klicka på Lägg till ett filter (fält/parameter) för att lägga till en filterwidget. Placera den på arbetsytan.
2. På den nedrullningsbara menyn Filter i konfigurationspanelen väljer du Enskilt värde.
3. Markera kryssrutan Rubrik för att visa ett rubrikfält på filterwidgeten.
4. Klicka på platshållarrubriken på widgeten och skriv Segment för att ge filtret nytt namn.
5. Klicka bredvid Parametrar i konfigurationspanelen.
6. Välj segment från datauppsättningen Marknadsföringssegment .

Den konfigurerade filterwidgeten visar standardparametervärdet för datamängden.

Definiera ett urval av värden

Filtret du skapade är funktionellt, men det kräver att visningsprogrammet känner till det tillgängliga urvalsintervallet innan de kan skriva ett val. Det kräver också att användarna matchar ärendet och stavningen när de anger önskat parametervärde.

Om du vill skapa en listruta så att visningsprogrammet kan välja en parameter från en lista med tillgängliga alternativ skapar du en ny datauppsättning för att definiera listan över möjliga värden.

1. Klicka på fliken Data.

2. Klicka på Skapa från SQL för att skapa en ny datauppsättning.

3. Kopiera och klistra in följande i redigeraren:

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Kör frågan och granska resultatet. De fem marknadsföringssegmenten från tabellen visas i resultatet.

5. Dubbelklicka på den automatiskt genererade rubriken och byt sedan namn på det här datamängdssegmentet.

Uppdatera filtret

Uppdatera ditt befintliga filter så att det använder den datauppsättning som du nyss skapade för att fylla i en listruta med värden som användare kan välja mellan.

1. Klicka på Arbetsyta. Klicka sedan på filterwidgeten som du skapade i ett tidigare steg.
2. Klicka bredvid Fält.
3. Klicka på Segmentval och sedan på fältnamnet c_mktsegment.

Filtrets widget uppdateras när du ändrar konfigurationen. Klicka på fältet i filterwidgeten för att se tillgängliga alternativ i den nedrullningsbara menyn.

Kommentar

Den här självstudien innehåller ett förenklat användningsfall som är avsett att visa hur du använder frågebaserade parametrar. En alternativ metod för att skapa den här instrumentpanelen är att tillämpa ett filter på fältet c_mktsegment .

Nästa steg

Fortsätt att lära dig hur du arbetar med instrumentpaneler med följande artiklar:

• Läs mer om hur du använder filter. Se Använda filter.
• Läs mer om instrumentpanelsparametrar. Se Arbeta med instrumentpanelsparametrar.
• Publicera och dela din instrumentpanel. Se Publicera en instrumentpanel.