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.

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.

Ansluta till beräkning

Du måste ha minst CAN USE-behörigheter på ett SQL Warehouse 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 listan anger du text i textrutan.

Första gången du skapar en fråga visas listan över 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 listan kontaktar du arbetsyteadministratören.

Det valda SQL Warehouse 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 schemawebbläsaren i SQL-redigeraren tillgängliga databaser och tabeller. Du kan också bläddra bland dataobjekt från Katalogutforskaren.

Du kan navigera i Unity Catalog-styrda databasobjekt i Katalogutforskaren utan aktiv beräkning. Om du vill utforska data i hive_metastore och andra kataloger som inte styrs av Unity Catalog måste du koppla till beräkning med lämpliga privilegier. Se Datastyrning med Unity Catalog.

Kommentar

Om det inte finns några dataobjekt i schemaläsaren eller Katalogutforskaren kontaktar du arbetsyteadministratören.

Klicka längst upp i schemawebbläsaren för att uppdatera schemat. Du kan filtrera schemat genom att skriva filtersträngar i sökrutan.

Klicka på ett tabellnamn för att visa kolumnerna för tabellen.

Skapa en fråga

Du kan ange text för att skapa en fråga i SQL-redigeraren. Du kan infoga element från schemawebbläsaren för att referera till kataloger och tabeller.

• 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 till exempel ett giltigt slutförande på markörens plats är en kolumn föreslår komplettera automatiskt ett kolumnnamn. Om du skriver select * from table_name as t where t.identifierar autocomplete som t är ett alias för table_name och föreslår kolumnerna i table_name.

  

• (Valfritt) När du är klar med redigeringen klickar du på Spara.

Aktivera och inaktivera automatisk komplettering

Live autocomplete kan slutföra schematoken, frågesyntaxidentifierare (som SELECT och JOIN) och rubrikerna för frågefragment. Det är aktiverat som standard om inte databasschemat överskrider fem tusen token (tabeller eller kolumner).

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 väljer sedan Skapa ny fråga eller Öppna befintlig fråga. Klicka på Öppna befintlig fråga för att se din lista över sparade frågor. klicka på Mina frågor eller favoriter för att filtrera listan med 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. Välj 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 tabell i resultatfönstret.

   

Kommentar

Gräns 1000 är markerad som standard för alla frågor för att begränsa frågans retur till 1 000 rader. Om en fråga sparas med inställningen Gräns 1000 gäller den här inställningen för alla frågekörningar (inklusive i instrumentpaneler). Om du vill returnera alla rader för den här frågan kan du avmarkera LIMIT 1000 genom att klicka på listrutan Kör (1 000 ). Om du vill ange en annan gräns för 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 välj Flytta till papperskorgen.
• Bekräfta genom att klicka på Flytta till papperskorgen .

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

1. I listan Alla 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å Återställ.

Ange frågebeskrivning och visa frågeinformation

Så här anger du en 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: Om du vill favoritmarka en fråga klickar du på stjärnan till vänster om rubriken i listan Frågor. 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 visas Lägg till några taggar i textrutan där taggar 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.

Ta bort taggar

1. Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation.
2. Klicka på X på alla taggar som du vill ta bort.
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. Tabellen Nytt resultat ä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 den nya resultattabellen.

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 parametrar

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 resultatuppsättningen. Se Visualiseringstyper för en fullständig lista över tillgängliga visualiseringstyper.

Filter: Med filter kan du begränsa resultatuppsättningen när 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: Med parametrar kan du begränsa resultatet genom att ersätta värden i en fråga vid körning. Se Frågeparametrar för att lära dig hur du tillämpar parametrar.

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

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 resultatet. 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 gränsen på 1 GB 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 ordna om resultatet genom att stigande eller fallande värden. 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 parametrar.

Filtrera listan över sparade frågor i frågefönstret

I frågefönstret kan du filtrera listan över alla frågor efter listan över frågor som du har skapat (Mina frågor), efter favoriter och efter taggar.

Automatisera uppdateringar

Du kan använda knappen Schema för att ange 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 autentiseringsuppgifter): 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-vy (visningsuppgifter): 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 .