Instrumentpaneler

Du kan använda instrumentpaneler för att skapa datavisualiseringar och dela informativa datainsikter med ditt team. AI/BI-instrumentpaneler har AI-assisterad redigering, ett förbättrat visualiseringsbibliotek och en effektiv konfigurationsupplevelse så att du snabbt kan omvandla data till delbara insikter.

Kommentar

AI/BI-instrumentpaneler (tidigare Lakeview-instrumentpaneler) är nu allmänt tillgängliga.

Instrumentpaneler är inte tillgängliga i Azure Government-regioner. Använd äldre instrumentpaneler.

• Ursprungliga Databricks SQL-instrumentpaneler kallas nu för äldre instrumentpaneler. De kommer att fortsätta att stödjas och uppdateras med kritiska felkorrigeringar, men nya funktioner kommer att begränsas. Du kan fortsätta att använda äldre instrumentpaneler för både redigering och förbrukning.
• Konvertera äldre instrumentpaneler med hjälp av migreringsverktyget eller REST-API:et. Mer information om hur du använder det inbyggda migreringsverktyget finns i Klona en äldre instrumentpanel till en Lakeview-instrumentpanel . Se Självstudier för instrumentpaneler för självstudier om hur du skapar och hanterar instrumentpaneler med hjälp av REST-API:et.

AI/BI-instrumentpaneler har följande komponenter:

• Data: På fliken Data kan användare definiera datauppsättningar för användning på instrumentpanelen. Datauppsättningar paketeras med instrumentpaneler när de delas, importeras eller exporteras med hjälp av användargränssnittet eller API:et.
• Arbetsyta: På fliken Arbetsyta kan användarna skapa visualiseringar och konstruera sina instrumentpaneler. Arbetsytan innehåller widgetar som kan konfigureras för att visa visualiseringar, filter, text eller bilder.

Kommentar

Du kan definiera upp till 100 datauppsättningar per instrumentpanel. Arbetsytan kan innehålla upp till 100 widgetar per instrumentpanel.

Visa och organisera instrumentpaneler

Du kan komma åt instrumentpaneler från arbetsytans webbläsare tillsammans med andra Azure Databricks-objekt.

• Klicka på Arbetsyta i sidofältet för att visa instrumentpaneler från arbetsytans webbläsare. Instrumentpaneler lagras som standard i /Workspace/Users/<username> katalogen. Användare kan ordna instrumentpaneler i mappar i arbetsytans webbläsare tillsammans med andra Azure Databricks-objekt. Se Webbläsaren Arbetsyta.

• Om du vill visa instrumentpanelens listsida klickar du på Instrumentpaneler i sidopanelen.

  Som standard visar instrumentpanelens listsida instrumentpaneler som du har åtkomst till sorterade i omvänd kronologisk ordning. Du kan filtrera listan genom att ange en rubrik i sökfältet, filtrera efter senast ändrad inom en tidsperiod eller filtrera efter ägare.

• Klicka på en instrumentpanelsrubrik för att öppna den. Om instrumentpanelen har publicerats tidigare öppnas den publicerade versionen. Annars öppnas instrumentpanelen för utkast.

Skapa en ny instrumentpanel

Om du vill skapa en ny instrumentpanel från instrumentpanelens listsida klickar du på Skapa i det övre högra hörnet på sidan.

Definiera dina datauppsättningar

Använd fliken Data för att definiera de underliggande datauppsättningarna för instrumentpanelen.

Du kan definiera datauppsättningar som något av följande:

• En ny fråga mot en eller flera tabeller eller vyer.
• En befintlig Unity Catalog-tabell eller -vy.

Du kan definiera datauppsättningar för alla typer av tabeller eller vyer. Du kan definiera flera datauppsättningar genom att skriva ytterligare frågor eller välja ytterligare tabeller eller vyer. När du har definierat en datauppsättning kan du använda menyn kebab till höger om datauppsättningens namn för att byta namn på, klona eller ta bort den. Du kan också ladda ned datauppsättningen som en CSV-, TSV- eller Excel-fil.

Begränsa dataåtkomst med SQL

Alla data i en instrumentpanelsdatauppsättning kan vara tillgängliga för visning av instrumentpaneler, även om de inte visas i en visualisering. Om du vill förhindra att känsliga data skickas till webbläsaren begränsar du de kolumner som anges i SQL-frågan som definierar datauppsättningen. I stället för att välja alla kolumner från en tabell väljer du till exempel bara de specifika kolumner som behövs för visualiseringarna i SQL-instruktionen i stället för tabellkonfiguration.

Lägga till eller ta bort visualiseringar, text och filterwidgetar på arbetsytan

Använd fliken Arbetsyta för att konstruera instrumentpanelen. Använd verktygsfältet längst ned på arbetsytan för att lägga till widgetar som visualiseringar, textrutor och filter.

Visualiseringar

Skapa en visualisering genom att lägga till en visualiseringswidget på arbetsytan. Visualiseringar som stöds är bland annat yt-, stapel-, kombinations-, räknar-, värmekarta-, histogram-, linje-, cirkel-, pivot-, punkt- och tabelldiagramtyper.

Kommentar

Frågor som används av visualiseringar motsvarar inte alltid exakt datamängden. Om du till exempel tillämpar aggregeringar på en visualisering visar visualiseringen de aggregerade värdena.

Om du vill skapa en visualisering använder du någon av följande metoder:

• AI-assisterad visualisering: Beskriv diagrammet som du vill se på naturligt språk och låt Databricks Assistant generera ett diagram. När det har skapats kan du ändra det genererade diagrammet med hjälp av konfigurationspanelen. Du kan inte använda Assistent för att skapa tabell- eller pivottabelldiagramtyper.
• Använd konfigurationspanelen: Använd ytterligare aggregeringar eller tidsintervall i visualiseringskonfigurationen utan att ändra datauppsättningen direkt. Du kan välja en datauppsättning, x-axelvärden, y-axelvärden och färger. Se Visualiseringstyper för instrumentpaneler för konfigurationsinformation och exempel på varje visualiseringstyp som stöds. Se Tabellalternativ för att lära dig hur du styr datapresentationen i tabellvisualiseringar.

Kommentar

När du tillämpar temporala transformeringar i visualiseringskonfigurationen representerar datumet som visas i visualiseringen början av den perioden.

Textwidgetar

Markdown är ett markeringsspråk för formatering av text i en oformaterad textredigerare. Du kan använda markdown i textwidgetar för att formatera text, infoga länkar och lägga till bilder på instrumentpanelen.

• Om du vill lägga till en statisk bild i en textwidget lägger du till markdown-bildsyntax med en önskad beskrivning och URL: ![description](URL) från en offentligt tillgänglig URL. Följande markdown infogar till exempel en bild av Databricks-logotypen: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png). Ändra storlek på bilden genom att ändra storlek på widgetdimensionerna.
• Om du vill lägga till en bild från DBFS lägger du till markdown-bildsyntax med en önskad beskrivning och FileStore-sökväg: ![description](files/path_to_dbfs_image). Ändra storlek på bilden genom att ändra storlek på widgetdimensionerna. Mer information om DBFS finns i Vad är DBFS?.

Mer information om markdown-syntax finns i den här guiden.

Filter

Filter är widgetar som gör det möjligt för instrumentpanelsvisning att begränsa resultaten genom att filtrera efter specifika fält eller ange datauppsättningsparametrar. De fungerar på samma sätt som utsnitt i andra BI-verktyg, vilket gör att instrumentpanelsvisare kan manipulera och förfina data som presenteras i visualiseringar. Varje filterwidget kan konfigureras för att filtrera på datauppsättningsfält eller tilldela värden till fördefinierade parametrar i en datamängdsfråga. Fältfilter och parametrar kan kombineras i en enda widget när du använder frågebaserade parametrar. Se Använda frågebaserade parametrar för att lära dig hur du använder en frågebaserad parameter.

Du kan ange ett standardvärde i en widget för vissa filtertyper, enligt listorna för filtertyp som följer. Det gör du genom att välja ett värde i listrutan Standardvärde i filterwidgetens konfigurationsinställningar. Filter gäller alltid för hela datamängden. Om datamängden är liten tillämpas filtret direkt i webbläsaren för att förbättra prestandan. Om datamängden är större läggs filtret till i frågan som körs i SQL-lagret. Se optimering och cachelagring av datauppsättningar.

Filtrera efter fält

Filter kan tillämpas på fält i en eller flera datauppsättningar. Om du vill ansluta ett filter till fält från mer än en datauppsättning lägger du till flera fält, upp till en per datauppsättning. Filtret gäller för alla visualiseringar som bygger på de valda datauppsättningarna. Filtermarkeringen överlappar alla andra filter. Instrumentpaneler stöder följande filtertyper för filtrering på ett fält:

• Enskilt värde (accepterar standardvärde)
• Flera värden (accepterar standardvärde)
• Dataväljare
• Datumintervallväljare
• Textpost
• Skjutreglage för intervall

Filtrera efter parametrar

Ett filter kan tillämpas på en eller flera parametrar. Om du vill ansluta ett filter till fler än en parameter lägger du till flera parametrar i filterkonfigurationspanelen. För filtertyper som accepterar att ange ett standardvärde i widgeten åsidosätter standardvärdet standardvärdet som angetts i frågeredigeraren på fliken Data . Om ett filter är anslutet till en parameter körs en fråga mot SQL-lagret, oavsett datamängdens storlek. Se Vad är instrumentpanelsparametrar?.

Instrumentpaneler stöder följande filtertyper för filtrering på en parameter:

• Enskilt värde (accepterar standardvärde)
• Dataväljare

Du kan ange parametervärden för att acceptera någon av följande datatyper:

• String
• Datum
• Datum och tid
• Decimal
• Integer

Kommentar

Det går inte att använda parametrar för att ange datumintervall. Om du vill ange ett datumintervall använder du filter för fälten som innehåller start- och slutdatum för önskat intervall.

Inkludera filter och parametrar i de publicerade url:erna för instrumentpanelen

Filter- och parameterval lagras i URL:en. Användare kan bokmärke dessa URL:er för att spara instrumentpanelens tillstånd, inklusive alla filter och parametrar. På så sätt förblir instrumentpanelens inställningar intakta, så att andra kan visa den med samma konfigurationer när de kommer åt länken.

Kopiera widgetar

Använd kortkommandon för att kopiera en vald widget och klistra in den igen på arbetsytan. När du har skapat en ny widget kan du redigera den på samma sätt som med andra widgetar.

Utför följande steg för att klona en widget på din utkastinstrumentpanelsarbetsyta:

• Högerklicka på en widget.
• Klicka på Klona.

En klon av widgeten visas under originalet.

Ta bort widgetar

Ta bort widgetar genom att välja en widget och trycka på borttagningsknappen på tangentbordet. Eller högerklicka på widgeten. Klicka sedan på Ta bort.

Hämta resultat

Du kan ladda ned datauppsättningar som CSV-, TSV- eller Excel-filer. Du kan ladda ned visualiseringar på arbetsytan som PNG-filer.

• Om du vill öppna nedladdningsalternativ från fliken Arbetsyta klickar du på menyn för kebab i det övre högra hörnet av widgeten.
• Om du vill öppna nedladdningsalternativ från fliken Data klickar du på menyn kebab till höger om datauppsättningen.

Du kan ladda ned upp till cirka 1 GB resultatdata i CSV- och TSV-format och upp till 100 000 rader till en Excel-fil. Den slutliga filnedladdningsstorleken kan vara något mer eller mindre än 1 GB, eftersom gränsen på 1 GB tillämpas på ett tidigare steg än den slutliga filnedladdningen.

Skapa och samarbeta på en instrumentpanel

Nya instrumentpaneler börjar som ett utkast. Du kan dela utkastet med andra användare på din arbetsyta för att samarbeta. Utkastinstrumentpaneler kan inte delas med användare utanför arbetsytan. Alla användare använder sina egna autentiseringsuppgifter för att interagera med data och visualiseringar i instrumentpanelsutkast.

Mer information om behörighetsnivåer finns i ACL:er för AI/BI-instrumentpaneler.

Publicera en instrumentpanel

Publicera en instrumentpanel för att skapa en ren kopia av det aktuella utkastet. Du måste ha minst BEHÖRIGHET ATT REDIGERA för att kunna publicera en instrumentpanel.

När du har publicerat en instrumentpanel förblir den publicerade versionen intakt tills du publicerar igen, även om du gör ändringar i utkastet. Du kan göra ändringar och förbättringar av utkastversionen utan att påverka den publicerade kopian. Alla registrerade användare med åtkomst till den publicerade instrumentpanelen kan fortsätta att visa den publicerade versionen. Den publicerade versionen fortsätter att skickas via e-post till prenumeranter om det finns några. Mer information om hur du hanterar instrumentpanelsåtkomst finns i Dela en instrumentpanel.

När du publicerar en instrumentpanel kan du välja att bädda in dina autentiseringsuppgifter eller inte.

Viktigt!

Publicerade instrumentpaneler är inte versionshanterade och bör inte användas för versionskontroll. Du kan inte återställa ett utkast till en instrumentpanel till ett tidigare publicerat tillstånd.

• Autentiseringsuppgifter för inbäddning: Alla användare av en publicerad instrumentpanel kan köra frågor med dina autentiseringsuppgifter för data och beräkning. På så sätt kan användarna se instrumentpanelen även om de inte har åtkomst till den ursprungliga arbetsytan, underliggande data eller SQL Warehouse. Detta kan exponera data för användare som inte har beviljats direkt åtkomst till dem. Detta är standardförslaget.
• Bädda inte in autentiseringsuppgifter: Alla användare av den publicerade instrumentpanelen kör frågor med sina egna data och autentiseringsuppgifter för beräkning. För att visa resultat på instrumentpanelen behöver användarna åtkomst till arbetsytan, det anslutna SQL-lagret och tillhörande data.

Se Dela en publicerad instrumentpanel för rekommendationer om vilken inställning du vill välja.

Utför följande steg för att publicera en instrumentpanel:

1. Öppna en instrumentpanel. Om instrumentpanelen har publicerats tidigare öppnas den publicerade versionen. Om det behövs använder du växlaren överst på sidan för att se den aktuella utkastversionen.
2. Klicka på Publicera. Dialogrutan Publicera visas.
3. Välj de autentiseringsuppgifter som ska användas för den publicerade instrumentpanelen. Du kan välja att bädda in dina autentiseringsuppgifter eller inte.
4. Klicka på Publicera. Om instrumentpanelen publiceras för första gången öppnas en delningsdialogruta och du uppmanas att dela den publicerade instrumentpanelen. Mer information och rekommendationer om delning finns i Dela en instrumentpanel .

Om du vill komma åt den publicerade instrumentpanelen klickar du på Publicerad i den nedrullningsbara menyn längst upp på instrumentpanelen.

Schemalägga instrumentpaneler för regelbundna uppdateringar

Du kan konfigurera schemalagda uppdateringar för att automatiskt uppdatera instrumentpanelen och eventuellt skicka e-postmeddelanden med en PDF av den senaste instrumentpanelen till användare som prenumererar på schemat.

Användare med minst Behörighet att redigera kan skapa ett schema så att publicerade instrumentpaneler med inbäddade autentiseringsuppgifter körs med jämna mellanrum. Varje instrumentpanel kan ha upp till tio scheman.

För varje schemalagd instrumentpanelsuppdatering sker följande:

• All SQL-logik som definierar datauppsättningar körs enligt det angivna tidsintervallet.
• Resultaten fyller i frågeresultatets cacheminne och hjälper till att förbättra den första inläsningstiden för instrumentpanelen.

Så här skapar du ett schema:

1. Klicka på Schemalägg i det övre högra hörnet på instrumentpanelen. Dialogrutan Lägg till schema visas.

   

2. Använd listrutorna för att ange frekvens och tidszon. Du kan också markera kryssrutan Visa cron-syntax för att redigera schemat i Quartz Cron-syntax.

3. Klicka på Skapa. Dialogrutan Scheman visas och visar det schema som du skapade. Om det finns andra scheman för den här instrumentpanelen visas även dessa i dialogrutan.

4. Du kan också klicka på Prenumerera för att lägga till dig själv som prenumerant och få ett e-postmeddelande med en PDF-ögonblicksbild av instrumentpanelen när en schemalagd körning har slutförts.

Kommentar

Om ett schema redan har skapats för den här instrumentpanelen står det Prenumerera på knappen i det övre högra hörnet. Du kan använda det tidigare beskrivna arbetsflödet för att lägga till ett schema.

Hantera prenumerationer

Schemaprenumeranter får ett e-postmeddelande med en PDF-ögonblicksbild av den aktuella instrumentpanelen varje gång schemat körs. Berättigade prenumeranter inkluderar arbetsyteanvändare och e-postaviseringsmål.

Kommentar

Om du inte kan lägga till e-postprenumeranter kan din arbetsyteadministratör ha inaktiverat e-postaviseringar för din arbetsyta. Se Administrationsguide för instrumentpaneler.

Arbetsyteadministratörer måste definiera mål för e-postmeddelanden innan de kan väljas som prenumeranter. Se Hantera aviseringsmål. Kontoanvändare, distributionslistor och användare utanför kontot (till exempel användare hos partner- eller klientorganisationer) kan alla konfigureras som mål för e-postaviseringar och prenumerera. De kan dock inte prenumerera direkt.

Viktigt!

Prenumerationslistor kan innehålla upp till 100 prenumeranter. Ett mål för e-postavisering räknas som en prenumerant oavsett hur många e-postmeddelanden det skickar.

Du kan lägga till och ta bort andra prenumeranter för att få uppdateringar om du har minst Kan redigera behörigheter på instrumentpanelen. Du kan lägga till och ta bort dig själv som prenumerant i ett befintligt schema om du har minst kan visa behörigheter på instrumentpanelen.

• Så här prenumererar du på andra användare:

  1. Klicka på Prenumerera i det övre högra hörnet på instrumentpanelen. Dialogrutan Scheman visas.
  2. Identifiera det schema som du vill lägga till prenumeranter i. Klicka till höger om schemat. Klicka sedan på Redigera.

  Kommentar

  Du kan också använda den här snabbmenyn för att pausa eller ta bort ett schema.

  Om du har Kan visa åtkomst till en instrumentpanel som har ett tilldelat schema kan du prenumerera på dig själv för att få uppdateringar varje gång en schemalagd körning inträffar.

• Så här prenumererar du på ett befintligt schema:

  1. Klicka på knappen Prenumerera i det övre högra hörnet på instrumentpanelen. Dialogrutan Scheman visar alla scheman för instrumentpanelen.
  2. Klicka på Prenumerera till höger om det schema du väljer.

  Om du inte kan lägga till dig själv som prenumerant kontrollerar du följande orsaker:

  • En arbetsyteadministratör har inaktiverat alternativet Aktivera instrumentpanelsprenumerationer för arbetsytan.

    Den här inställningen ersätter alla andra. Om arbetsytans administratör har inaktiverat den här inställningen kan instrumentpanelsredigerare fortfarande tilldela ett schema, men inga prenumeranter kan tilldelas.

  • Instrumentpanelen delas inte med inbäddade autentiseringsuppgifter.

    Instrumentpaneler som delas utan inbäddade autentiseringsuppgifter kan inte tilldelas ett schema, så de kan inte tilldelas prenumeranter.

  • Du har inte behörighet att komma åt arbetsytan.

    Kontoanvändare kan bara läggas till som prenumeranter som e-postaviseringsmål. Det finns ingen prenumerationsknapp på instrumentpanelen för kontoanvändare.

  • Inga scheman har definierats.

    För instrumentpaneler utan ett definierat schema kan arbetsyteanvändare med kan visa eller kan köra åtkomst till en instrumentpanel inte interagera med knappen Prenumerera .

Avsluta prenumerationen på e-postuppdateringar

Prenumeranter kan välja att sluta ta emot e-postmeddelanden genom att avbryta prenumerationen från schemat.

• Så här avbryter du prenumerationen med instrumentpanelens användargränssnitt:

  1. Klicka på knappen Prenumerera i det övre högra hörnet på instrumentpanelen. Dialogrutan Scheman visar alla scheman för instrumentpanelen.
  2. Klicka på Prenumerera för att avbryta prenumerationen. Knapptexten ändras till Prenumerera.

  

• Använd länken Avbryt prenumeration i e-postfoten för att avbryta prenumerationen på schemalagda uppdateringar.

Kommentar

När en användare som ingår i en större distributionslista som konfigurerats för e-postaviseringar väljer att avbryta prenumerationen med hjälp av länken i e-postfoten avbryter åtgärden hela distributionslistan. Gruppen som helhet tas bort från prenumerationen och kommer inte att få framtida UPPDATERINGAR av PDF-ögonblicksbilder.

Storleksgränser för instrumentpaneler för prenumerationer

E-post för instrumentpanelsprenumeration innehåller följande base64-kodade filer:

• PDF: En PDF-fil som innehåller den fullständiga instrumentpanelen.
• DesktopImage: En bildfil som är optimerad för visning på stationära datorer.

En maximal gräns på 9 MB tillämpas på den kombinerade storleken på de två filerna. Följande beskrivningar beskriver det förväntade beteendet när den kombinerade filstorleken överskrider gränsen:

• Om PDF-filen är större än 9 MB: Prenumerationens e-post innehåller inte PDF-bifogad fil eller bilder. Den innehåller en anteckning om att instrumentpanelen har överskridit storleksgränsen och visar den faktiska filstorleken för den aktuella instrumentpanelen.
• Om den kombinerade filstorleken är större än 9 MB: Endast PDF-filen är kopplad till e-postmeddelandet. Det infogade meddelandet innehåller en länk till instrumentpanelen men ingen bild.

Exportera, importera eller ersätta en instrumentpanel

Du kan exportera och importera instrumentpaneler som filer för att underlätta delning av redigerbara instrumentpaneler på olika arbetsytor. Om du vill överföra en instrumentpanel till en annan arbetsyta exporterar du den som en fil och importerar den sedan till den nya arbetsytan. Du kan också ersätta instrumentpanelsfiler på plats. Det innebär att när du redigerar en instrumentpanelsfil direkt kan du ladda upp filen till den ursprungliga arbetsytan och skriva över den befintliga filen samtidigt som du behåller befintliga delningsinställningar.

Följande steg beskriver hur du exporterar och importerar instrumentpaneler i användargränssnittet. Du kan också använda Databricks API för att importera och exportera instrumentpaneler programmatiskt. Se POST /api/2.0/workspace/import.

Exportera en instrumentpanelsfil

• Från en utkastinstrumentpanel klickar du på menyn för kebab i skärmens övre högra hörn och klickar sedan på Exportera instrumentpanel.
• Bekräfta eller avbryt åtgärden med hjälp av dialogrutan Exportera instrumentpanel . När exporten lyckas sparas en .lvdash.json fil i webbläsarens standardkatalog för nedladdning.

Importera en instrumentpanelsfil

• På sidan Instrumentpaneler klickar du på >Importera instrumentpanel från fil.
• Klicka på Välj fil för att öppna dialogrutan för den lokala filen och välj sedan den .lvdash.json fil som du vill importera.
• Klicka på Importera instrumentpanel för att bekräfta och skapa instrumentpanelen.

Den importerade instrumentpanelen sparas i användarmappen. Om det redan finns en importerad instrumentpanel med samma namn på den platsen löses konflikten automatiskt genom att ett tal inom parentes läggs till för att skapa ett unikt namn.

Ersätt en instrumentpanel från en fil

• Från ett utkast till instrumentpanel klickar du på menyn för kebab i skärmens övre högra hörn och klickar sedan på Ersätt instrumentpanel.
• Klicka på Välj fil för att öppna fildialogrutan och välj den fil som .lvdash.json ska importeras.
• Klicka på Skriv över för att skriva över den befintliga instrumentpanelen.

Hantera instrumentpaneler med REST-API:et

Se Använda Azure Databricks-API:er för att hantera instrumentpaneler för självstudier som visar hur du använder REST-API:er för Azure Databricks för att hantera instrumentpaneler. De inkluderade självstudierna förklarar hur du konverterar äldre instrumentpaneler till Lakeview-instrumentpaneler samt hur du skapar, hanterar och delar dem.