Dela via


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.

SQL-redigerarens användargränssnitt

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å Ikon för SQL-redigeraren 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.

SQL-lagerväljare

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 Körs
  • Start Startar
  • Stoppat 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.

Schemawebbläsaren som visar exempelkatalogen, nyctaxi-databasen, trips-tabellen och kolumnerna i den tabellen.

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 Uppdatera schemaikon 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.

  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 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.

    Komplettera alias automatiskt

  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 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å Automatisk slutförd aktiverad 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.

Dialogruta för frågor

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.

    Frågeresultat

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 Menyn Kebab 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 Menyn Kebab 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å Papperskorgen.
  2. Klicka på en fråga.
  3. Klicka på snabbmenyn Menyn Kebab 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å Menyn Kebab snabbmenyn för kebab bredvid frågan och klicka på Redigera frågeinformation.

    Snabbmeny

  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å Menyn Kebab 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.

    Lägga till taggar

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

Ta bort taggar

  1. Klicka på Menyn Kebab 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 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

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

Tillgängliga 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!

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

Alternativ för att anpassa, ladda ned resultat och lägga till i instrumentpaneler.

  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 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.

Posten visar varje gång frågan har körts, inklusive den specifika frågesyntaxen.

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.

Filtrera resultat med sökning

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

Punktdiagramvisualisering av data med alternativ för att skapa en ny visualisering, ett filter eller 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 visningsprogram (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 .