Skriva frågor och utforska data i SQL-redigeraren

Azure Databricks-användargränssnittet innehåller en SQL-redigerare som du kan använda för att skapa frågor, bläddra bland tillgängliga data och skapa visualiseringar. Du kan också dela dina sparade frågor med andra teammedlemmar på arbetsytan. Den här artikeln beskriver hur du använder SQL-redigeraren för att skriva, köra och hantera frågor. En ny version av SQL-redigeraren finns i offentlig förhandsversion. Information om hur du aktiverar och arbetar med den nya SQL-redigeraren finns i Samarbeta med kollegor med den nya SQL-redigeraren.

När du har öppnat redigeraren kan du skapa en SQL-fråga eller bläddra bland tillgängliga data. Textredigeraren stöder automatisk komplettering, autoformatering och olika andra kortkommandon.

Du kan öppna flera frågor med hjälp av frågeflikarna överst i textredigeraren. Varje frågeflik har kontroller för att köra frågan, markera frågan som en favorit och ansluta till ett SQL-lager. Du kan också spara, schemalägga eller dela frågor.

Öppna SQL-redigeraren

Om du vill öppna SQL-redigeraren i Azure Databricks-användargränssnittet klickar du på SQL-redigeraren i sidofältet.

SQL-redigeraren öppnas för din senaste öppna fråga. Om det inte finns någon fråga, eller om alla dina frågor uttryckligen har stängts, öppnas en ny fråga. Den heter automatiskt Ny fråga och tidsstämpeln för skapande läggs till i rubriken.

Ansluta till beräkning

Du måste ha minst CAN USE-behörigheter på ett SQL-lager som körs för att köra frågor. Du kan använda listrutan längst upp i redigeraren för att se tillgängliga alternativ. Om du vill filtrera listanger du text i textrutan.

Första gången du skapar en fråga visas list av tillgängliga SQL-lager alfabetiskt. Det senast använda SQL-lagret väljs nästa gång du skapar en fråga.

Ikonen bredvid SQL-lagret anger statusen:

• Löpning
• Start
• Stoppat

Kommentar

Om det inte finns några SQL-lager i listkontaktar du arbetsyteadministratören.

Det valda SQL-lagret startas om automatiskt när du kör frågan. Se Starta ett SQL-lager för att lära dig andra sätt att starta ett SQL-lager.

Bläddra bland dataobjekt i SQL-redigeraren

Om du har behörighet att läsa metadata visar schema webbläsaren i SQL-redigeraren tillgängliga databaser och tables. Du kan också bläddra bland dataobjekt från Catalog Explorer.

Du kan navigera i Unity Catalog-reglerade databasobjekt i Catalog Explorer utan aktiv beräkning. Om du vill utforska data i hive_metastore och andra catalogs som inte styrs av Unity Catalogmåste du ansluta till beräkning med lämpliga privilegier. Se Datastyrning med Unity Catalog.

Kommentar

Om det inte finns några dataobjekt i schema webbläsare eller Catalog Explorer kontaktar du arbetsyteadministratören.

Klicka på ikonen längst upp i webbläsaren schema för att refreshschema. Du kan filtrera schema genom att skriva filtersträngar i sökrutan.

Klicka på ett table-namn för att visa columns för den table.

Skapa en fråga

Du kan ange text för att skapa en fråga i SQL-redigeraren. Du kan insert element från webbläsaren schema för att referera till catalogs och tables.

1. Skriv din fråga i SQL-redigeraren.

   SQL-redigeraren stöder automatisk komplettering. När du skriver föreslår automatisk komplettering slutföranden. Om ett giltigt slutförande på markörens plats till exempel är en columnföreslår automatisk komplettering ett column namn. Om du skriver select * from table_name as t where t.identifierar automatisk komplettering att t är ett alias för table_name och föreslår columns inuti table_name.

   

2. (Valfritt) När du är klar med redigeringen klickar du på Spara. Som standard sparas frågan i användarens hemmapp, eller så kan du select en annan plats. Klicka sedan på Spara.

Aktivera och inaktivera automatisk komplettering

Live-autokomplettering kan slutföra schema tokens, frågesyntaxidentifierare (till exempel SELECT och JOIN) och titlarna på frågefragment. Den är aktiverad som standard om inte databasen schema överskrider fem tusen token (tables eller columns).

Använd växlingsknappen under SQL-redigeraren för att inaktivera eller aktivera live-automatisk komplettering.

• Om du vill inaktivera live-automatisk komplettering trycker du på Ctrl + Blanksteg eller klickar på knappen under SQL-redigeraren.

Spara frågor

Knappen Spara längst upp till höger i SQL-redigeraren sparar din fråga.

Viktigt!

När du ändrar en fråga men inte uttryckligen klickar på Spara behålls tillståndet som ett frågeutkast. Frågeutkast behålls i 30 dagar. Efter 30 dagar tas frågeutkasten bort automatiskt. Om du vill behålla ändringarna måste du uttryckligen spara dem.

Redigera flera frågor

Som standard använder SQL-redigeraren flikar så att du kan redigera flera frågor samtidigt. Om du vill öppna en ny flik klickar du på +och sedan selectSkapa ny fråga eller Öppna befintlig fråga. Klicka på Öppna befintlig fråga för att se dina list med sparade frågor. klicka på Mina frågor eller Favoriter för att filtrera list av frågor. På raden som innehåller den fråga som du vill visa klickar du på Öppna.

Köra en enskild fråga eller flera frågor

Så här kör du en fråga eller alla frågor:

1. Select ett SQL-lager.

2. Markera en fråga i SQL-redigeraren (om flera frågor finns i frågefönstret).

3. Tryck på Ctrl/Cmd + Retur eller klicka på Kör (1 000) för att visa resultatet som en table i resultatfönstret.

   

Kommentar

Limit 1 000 har valts som standard för att alla frågor ska limit frågan återgå till 1 000 rader. Om en fråga sparas med inställningen Limit 1000 gäller den här inställningen för alla frågekörningar (även i kontrollpaneler). Om du vill returnera alla rader för den här frågeuppställningen kan du avmarkera LIMIT 1000 genom att klicka på rullgardinsmenyn Kör (1000). Om du vill ange en annan limit på antalet rader kan du lägga till en LIMIT-sats i frågan med ett valfritt värde.

Avsluta en fråga

Om du vill avsluta en fråga medan den körs klickar du på Avbryt. En administratör kan stoppa en körningsfråga som en annan användare startade genom att visa frågan Avsluta en körning.

Frågealternativ

Du kan använda snabbmenyn för kebab längst upp i frågeredigeraren för att få åtkomst till menyalternativ för att klona, återställa, formatera och redigera frågeinformation.

Återgå till sparad fråga

När du redigerar en fråga visas alternativet Återställ ändringar i snabbmenyn för frågan. Du kan klicka på Återställ för att gå tillbaka till den sparade versionen.

Ignorera och återställa frågor

Så här flyttar du en fråga till papperskorgen:

• Klicka på snabbmenyn för kebab bredvid frågan i SQL-redigeraren och selectFlytta till papperskorgen.
• Bekräfta genom att klicka på Flytta till papperskorgen .

Så här restore du en fråga från papperskorgen:

1. I listAlla frågor klickar du på .
2. Klicka på en fråga.
3. Klicka på snabbmenyn för kebab längst upp till höger i SQL-redigeraren och klicka på Restore.

Set frågebeskrivning och visa frågeinformation

Skapa en set frågebeskrivning:

1. Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation.

   

2. I textrutan Beskrivning anger du din beskrivning. Klicka sedan på Spara. Du kan också visa historiken för frågan, inklusive när den skapades och uppdaterades, i den här dialogrutan.

Favorit- och taggfrågor

Du kan använda favoriter och taggar för att filtrera listor med frågor och instrumentpaneler som visas på arbetsytans landningssida och på var och en av listsidorna för instrumentpaneler och frågor.

Favoriter: Klicka på stjärnan till vänster om rubriken i frågor listom du vill favorita en fråga. Stjärnan blir gul.

Taggar: Du kan tagga frågor och instrumentpaneler med valfri meningsfull sträng till din organisation.

Lägg till en tagg

Lägg till taggar i frågeredigeraren.

1. Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation. Dialogrutan Frågeinformation visas.

2. Om frågan inte har några taggar tillämpade, visasLägg till några taggar i textrutan och where taggar kommer att visas. Om du vill skapa en ny tagg skriver du den i rutan. Om du vill ange flera taggar trycker du på fliken mellan poster.

   

3. Klicka på Spara för att tillämpa taggarna och stäng dialogrutan.

Remove taggar

1. Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation.
2. Klicka på X på den tagg du vill remove.
3. Stäng dialogrutan genom att klicka på Spara .

Visa frågeresultat

När en fråga har körts visas resultatet i fönstret under den. Nytt resultat table är PÅ för nya frågor. Om det behövs klickar du på listrutan för att inaktivera den. Bilderna i det här avsnittet använder det nya resultatet table.

Du kan interagera med och utforska dina frågeresultat med hjälp av resultatfönstret. Resultatfönstret innehåller följande funktioner för att utforska resultat:

Visualiseringar, filter och parameters

Klicka på för att lägga till en visualisering, ett filter eller en parameter. Följande alternativ visas:

Visualisering: Visualiseringar kan hjälpa dig att utforska resultatet set. Se visualiseringstyper för en komplett list av tillgängliga visualiseringstyper.

Filter: Med filter kan du limit resultatet set efter att en fråga har körts. Du kan använda filter för att selektivt visa olika delmängder av data. Mer information om hur du använder filter finns i Frågefilter .

Parameter: Parameters gör det möjligt för dig att limit resultatet set genom att ersätta values i en fråga under körning. Se Arbeta med förfrågan parameters för att lära dig hur du använder parameters.

Redigera, ladda ned eller lägga till på en instrumentpanel

Viktigt!

• Databricks rekommenderar att du använder AI/BI-instrumentpaneler (tidigare Lakeview-instrumentpaneler). Tidigare versioner av instrumentpaneler, som tidigare kallades Databricks SQL-instrumentpaneler, kallas nu för äldre instrumentpaneler. Databricks rekommenderar inte att du skapar nya äldre instrumentpaneler.

tidslinje för supportens slut:

• 7 april 2025: Det officiella stödet för den äldre versionen av instrumentpaneler upphör. Endast kritiska säkerhetsproblem och avbrott i tjänsten kommer att åtgärdas.

• 3 november 2025: Databricks kommer att börja arkivera äldre instrumentpaneler som inte har använts under de senaste sex månaderna. Arkiverade instrumentpaneler kommer inte längre att vara tillgängliga och arkiveringsprocessen sker löpande. Åtkomsten till aktivt använda instrumentpaneler förblir oförändrad.

  Databricks samarbetar med kunder för att utveckla migreringsplaner för aktiva äldre instrumentpaneler efter den 3 november 2025.

• 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 AI/BI-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.

Klicka på fliken i ett resultat om du vill visa fler alternativ.

1. Klicka på Redigera för att anpassa resultatet som visas i visualiseringen.
2. Klicka på Ta bort för att ta bort resultatfliken.
3. Klicka på Duplicera för att klona resultatfliken.
4. Klicka på Lägg till på instrumentpanelen för att kopiera frågan och visualiseringen till en ny instrumentpanel.
   • Den här åtgärden skapar en ny instrumentpanel som innehåller alla visualiseringar som är associerade med frågan. Mer information om hur du redigerar instrumentpanelen finns i Instrumentpaneler .
   • Du uppmanas att välja ett namn för den nya instrumentpanelen. Den nya instrumentpanelen sparas i din hemmapp.
   • Du kan inte lägga till resultat på en befintlig instrumentpanel.
5. Klicka på Lägg till på en äldre instrumentpanel för att lägga till resultatfliken på en ny eller befintlig äldre instrumentpanel.
6. Klicka på något av nedladdningsalternativen för att ladda ned resultat. Mer information och begränsningar finns i följande beskrivning.

Ladda ned resultat: Du kan ladda ned resultat som en CSV-, TSV- eller Excel-fil.

Du kan ladda ned upp till cirka 1 GB resultatdata från Databricks SQL 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 1 GB limit tillämpas på ett tidigare steg än den slutliga filnedladdningen.

Kommentar

Om du inte kan ladda ned en fråga har arbetsyteadministratören inaktiverat nedladdningen för din arbetsyta.

Tidigare körningar

Du kan visa tidigare körningar för frågan, inklusive den fullständiga frågesyntaxen. Tidigare körningar öppnas i skrivskyddat läge och innehåller knappar för att klona till ny fråga eller Återuppta redigering. Den här fliken visar inte schemalagda körningar.

Utforska resultat

Returnerade frågeresultat visas under frågan. Fliken Råresultat fylls i med de returnerade raderna. Du kan använda inbyggda filter för att sortera resultaten i stigande eller fallande ordning values. Du kan också använda filtret för att söka efter resultatrader som innehåller ett visst värde.

Du kan använda flikar i resultatfönstret för att lägga till visualiseringar, filter och parameters.

Filtrera list av sparade frågor i frågorna window

I frågorna windowkan du filtrera list av alla frågor efter list av frågor som du har skapat (Mina frågor), efter favoriter och efter taggar.

Automatisera uppdateringar

Du kan använda knappen Schemalägg för att set en automatisk kadens för frågekörningar. Automatiska uppdateringar kan hjälpa dig att hålla dina instrumentpaneler och rapporter uppdaterade med de senaste data. Schedueled-frågor kan också aktivera Databricks SQL-aviseringar, en särskild typ av schemalagd aktivitet som skickar meddelanden när ett värde når ett angivet tröskelvärde.

Se Schemalägg en fråga.

Se Vad är Databricks SQL-aviseringar?.

Dela frågor

Med knappen Dela kan du dela frågan med andra användare på din arbetsyta. När du delar väljer du mellan följande alternativ:

• Kör som ägare (ägarens credentials): Den här inställningen innebär att användarna kan se samma frågeresultat som frågeägaren. Detta gäller schemalagda eller manuella frågekörningar.
• Kör som visningsprogram (visningsprogram credentials): Den här inställningen begränsar resultatet till visningsprogrammets tilldelade behörigheter.

Se Konfigurera frågebehörigheter.

Gå vidare

Mer information om hur du arbetar med frågor med Azure Databricks-användargränssnittet finns i Komma åt och hantera sparade frågor .