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 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-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 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 somt
är ett alias förtable_name
och föreslår kolumnerna itable_name
.(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 välja en annan plats. Klicka sedan 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:
Välj ett SQL-lager.
Markera en fråga i SQL-redigeraren (om flera frågor finns i frågefönstret).
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:
- I listan Alla frågor klickar du på .
- Klicka på en fråga.
- 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:
Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation.
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.
Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation. Dialogrutan Frågeinformation visas.
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.
Klicka på Spara för att tillämpa taggarna och stäng dialogrutan.
Ta bort taggar
- Klicka på snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation.
- Klicka på X på alla taggar som du vill ta bort.
- 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. Mer information om hur du tillämpar parametrar finns i Arbeta med frågeparametrar .
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.
- 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.
- Klicka på Redigera för att anpassa resultatet som visas i visualiseringen.
- Klicka på Ta bort för att ta bort resultatfliken.
- Klicka på Duplicera för att klona resultatfliken.
- 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.
- Klicka på Lägg till på en äldre instrumentpanel för att lägga till resultatfliken på en ny eller befintlig äldre instrumentpanel.
- 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 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 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 visningsprogram (visningsuppgifter): Den här inställningen begränsar resultatet till visningsprogrammets tilldelade behörigheter.
Se Konfigurera frågebehörigheter.