Dela via

T-SQL-stöd i Microsoft Fabric-notebook-filer

  • Artikel

Med funktionen T-SQL Notebook i Microsoft Fabric kan du skriva och köra T-SQL-kod i en notebook-fil. Du kan använda T-SQL-notebook-filer för att hantera komplexa frågor och skriva bättre markdown-dokumentation. Det möjliggör också direkt körning av T-SQL på det anslutna lagret eller SQL-analysslutpunkten. Genom att lägga till en datalager- eller SQL-analysslutpunkt i en notebook-fil kan T-SQL-utvecklare köra frågor direkt på den anslutna slutpunkten. BI-analytiker kan också köra frågor mellan databaser för att samla in insikter från flera lager och SQL-analysslutpunkter.

De flesta av de befintliga notebook-funktionerna är tillgängliga för T-SQL-notebook-filer. Dessa inkluderar diagramfrågeresultat, samtidig autentisering av notebook-filer, schemaläggning av regelbundna körningar och utlösande körning inom Dataintegration pipelines.

Viktigt!

Den här funktionen är i förhandsversion.

I den här artikeln kan du se hur du:

  • Skapa en T-SQL-notebook-fil
  • Lägga till en datalager- eller SQL-analysslutpunkt i en notebook-fil
  • Skapa och köra T-SQL-kod i en notebook-fil
  • Använd diagramfunktionerna för att grafiskt representera frågeresultat
  • Spara frågan som en vy eller en tabell
  • Köra frågor mellan lager
  • Hoppa över körningen av icke-T-SQL-kod

Skapa en T-SQL-notebook-fil

För att komma igång med den här upplevelsen kan du skapa en T-SQL-notebook-fil på följande sätt:

  1. Skapa en T-SQL-anteckningsbok från Fabric-arbetsytan: välj Nytt objektoch välj sedan Anteckningsbok från panelen som öppnas.

    Skärmbild av hur du skapar en ny notebook-fil från en arbetsyta.

  2. Skapa en T-SQL-anteckningsbok från en befintlig lagerredigerare: gå till ett befintligt lager och välj Ny SQL-frågai det övre navigeringsfliksområdet och ny T-SQL-frågeanteckningsbok.

    Skärmbild av öppna notebook-filer från DW SQL-redigeraren.

När notebook-filen har skapats anges T-SQL som standardspråk. Du kan lägga till datalager- eller SQL-analysslutpunkter från den aktuella arbetsytan i notebook-filen.

Lägga till en datalager- eller SQL-analysslutpunkt i en notebook-fil

Om du vill lägga till en datalager- eller SQL-analysslutpunkt i en notebook-fil väljer du knappen + Datakällor i notebook-redigeraren och väljer Lager. Välj det informationslager eller den SQL-analysslutpunkt som du vill ansluta till i panelen datahubben .

Skärmbild av att lägga till informationslager eller SQL-slutpunkt i anteckningsboken.

Ange ett primärt lager

Du kan lägga till flera lager eller SQL-analysslutpunkter i notebook-filen, där en av dem har angetts som primär. Det primära lagret kör T-SQL-koden. Om du vill ange det går du till objektutforskaren, väljer ... bredvid lagret och väljer Ange som primär.

Skärmbild av inställning av primärt lager.

För alla T-SQL-kommandon som stöder namngivning i tre delar används det primära lagret som standardlager om inget lager anges.

Skapa och köra T-SQL-kod i en notebook-fil

Om du vill skapa och köra T-SQL-kod i en notebook-fil lägger du till en ny cell och anger T-SQL som cellspråk.

Skärmbild som visar hur du skapar en t-sql-kodcell.

Du kan skapa T-SQL-kod automatiskt med hjälp av kodmallen från objektutforskarens snabbmeny. Följande mallar är tillgängliga för T-SQL-notebook-filer:

  • Välj de 100 främsta
  • Skapa tabell
  • Skapa som välj
  • Ta bort
  • Släpp och skapa

Skärmbild av att visa t-sql-kodmallen.

Du kan köra en T-SQL-kodcell genom att välja knappen Kör i cellverktygsfältet eller köra alla celler genom att välja knappen Kör alla i verktygsfältet.

Kommentar

Varje kodcell körs i en separat session, så variablerna som definieras i en cell är inte tillgängliga i en annan cell.

I samma kodcell kan den innehålla flera kodrader. Användaren kan välja en del av koden och bara köra de markerade. Varje körning genererar också en ny session.

Skärmbild som visar hur du kör den markerade kodcellen.

När koden har körts expanderar du meddelandepanelen för att kontrollera körningssammanfattningen.

Skärmbild som visar körningssammanfattningen.

Fliken Tabell listar posterna från den returnerade resultatuppsättningen. Om körningen innehåller flera resultatuppsättningar kan du växla från en till en annan via den nedrullningsbara menyn.

Skärmbild som visar hur du växlar på resultatfliken.

Använd diagramfunktionerna för att grafiskt representera frågeresultat

Genom att klicka på Inspektera kan du se de diagram som representerar datakvaliteten och distributionen för varje kolumn

Skärmbild som visar inspektera resultatet i ett diagramformulär.

Spara frågan som en vy eller tabell

Du kan använda menyn Spara som tabell för att spara resultatet av frågan i tabellen med hjälp av CTAS-kommandot . Om du vill använda den här menyn väljer du frågetexten från kodcellen och väljer Menyn Spara som tabell .

Skärmbild som visar hur du sparar frågan som en tabell.

Skärmbild på hur du sparar en tabell som dialogruta.

På samma sätt kan du skapa en vy från den valda frågetexten med hjälp av menyn Spara som vy i cellkommandofältet.

Skärmbild som visar hur du skapar en vy.

Skärmbild som visar dialogrutan Spara som en vy.

Kommentar

  • Eftersom menyn Spara som tabell och Spara som endast är tillgängliga för den valda frågetexten måste du välja frågetexten innan du använder de här menyerna.

  • Skapa vy stöder inte namngivning i tre delar, så vyn skapas alltid i det primära lagret genom att lagret anges som primärt lager.

Fråga mellan lager

Du kan köra frågor mellan lager med hjälp av namngivning i tre delar. Namngivning i tre delar består av databasnamnet, schemanamnet och tabellnamnet. Databasnamnet är namnet på lagret eller SQL-analysslutpunkten, schemanamnet är namnet på schemat och tabellnamnet är namnet på tabellen.

Skärmbild som visar hur du kör en fråga mellan lager.

Hoppa över körningen av icke-T-SQL-kod

I samma notebook-fil är det möjligt att skapa kodceller som använder olika språk. Till exempel kan en PySpark-kodcell föregå en T-SQL-kodcell. I sådana fall kan användaren välja att hoppa över körningen av PySpark-kod för T-SQL Notebook. Den här dialogrutan visas när du kör alla kodceller genom att klicka på knappen Kör alla i verktygsfältet.

Skärmbild som visar hur du hoppar över icke-TSQL-kod.

Begränsningar för offentlig förhandsversion

  • Parametercellen stöds ännu inte i T-SQL Notebook. Parametern som skickas från pipelinen eller schemaläggaren kan inte användas i T-SQL Notebook.
  • Funktionen Senaste körning stöds ännu inte i T-SQL Notebook. Du måste använda den aktuella övervakningsfunktionen för informationslager för att kontrollera körningshistoriken för T-SQL-notebook-filen. Mer information finns i artikeln Övervaka informationslager .
  • Övervaknings-URL:en i pipelinekörningen stöds ännu inte i T-SQL-notebook-filen.
  • Funktionen för ögonblicksbilder stöds ännu inte i T-SQL-notebook-filen.
  • Stöd för Git och distributionspipelines finns ännu inte i T-SQL-notebook.

Relaterat innehåll

Mer information om Fabric-notebook-filer finns i följande artiklar.