Del via

T-SQL-understøttelse i Microsoft Fabric-notesbøger

Med T-SQL-notesbogfunktionen i Microsoft Fabric kan du skrive og køre T-SQL-kode i en notesbog. Du kan bruge T-SQL-notesbøger til at administrere komplekse forespørgsler og skrive bedre markdown-dokumentation. Det giver også mulighed for direkte udførelse af T-SQL på forbundet lager eller SQL-analyseslutpunkt. Ved at føje et Data Warehouse- eller SQL Analytics-slutpunkt til en notesbog kan T-SQL-udviklere køre forespørgsler direkte på det forbundne slutpunkt. BI-analytikere kan også udføre forespørgsler på tværs af databaser for at indsamle indsigt fra flere lagre og SQL-analyseslutpunkter.

De fleste af de eksisterende funktioner i notesbogen er tilgængelige for T-SQL-notesbøger. Disse omfatter diagrammering af forespørgselsresultater, samtidig redigering af notesbøger, planlægning af regelmæssige udførelser og udløsning af udførelse i dataintegrationspipelines.

I denne artikel lærer du, hvordan du:

  • Opret en T-SQL-notesbog
  • Føj et Data Warehouse- eller SQL Analytics-slutpunkt til en notesbog
  • Opret og kør T-SQL-kode i en notesbog
  • Brug diagramfunktionerne til grafisk at repræsentere forespørgselsresultater
  • Gem forespørgslen som en visning eller en tabel
  • Kør forespørgsler på tværs af lager
  • Spring udførelsen af ikke-T-SQL-kode over

Opret en T-SQL-notesbog

For at komme i gang med denne oplevelse kan du oprette en T-SQL-notesbog på følgende måder:

  1. Opret en T-SQL-notesbog fra Fabric-arbejdsområdet: Vælg Nyt element, og vælg derefter Notesbog i det panel, der åbnes.

    Skærmbillede af oprettelse af en ny notesbog fra et arbejdsområde.

  2. Opret en T-SQL-notesbog fra en eksisterende lagereditor: Naviger til et eksisterende lager, og vælg Ny SQL-forespørgselfra det øverste navigationsbånd, og derefter ny T-SQL-forespørgselsnotesbog.

    Skærmbillede af åben notesbog fra DW SQL-editor.

Når notesbogen er oprettet, angives T-SQL som standardsprog. Du kan føje data warehouse- eller SQL Analytics-slutpunkter fra det aktuelle arbejdsområde til din notesbog.

Tilføj et Data Warehouse- eller SQL Analytics-slutpunkt i en notesbog

Hvis du vil føje et Data Warehouse- eller SQL Analytics-slutpunkt til en notesbog, skal du vælge knappen + Datakilder i notesbogeditoren og vælge Warehouses. Vælg det data warehouse- eller SQL Analytics-slutpunkt, du vil oprette forbindelse til, i datahubpanelet .

Skærmbillede af tilføjelse af data warehouse eller SQL-slutpunkt i notesbogen.

Angiv et primært lager

Du kan føje flere lagre eller SQL Analytics-slutpunkter til notesbogen, hvor et af dem er angivet som det primære. Det primære lager kører T-SQL-koden. Hvis du vil angive den, skal du gå til Objektoversigt, vælge ... ud for lageret og vælge Angiv som primær.

Skærmbillede af indstilling af primært lagersted.

For alle T-SQL-kommandoer, der understøtter navngivning i tre dele, bruges primært lager som standardlager, hvis der ikke er angivet noget lager.

Opret og kør T-SQL-kode i en notesbog

Hvis du vil oprette og køre T-SQL-kode i en notesbog, skal du tilføje en ny celle og angive T-SQL som cellesproget.

Skærmbillede, der viser, hvordan du opretter en t-sql-kodecelle.

Du kan generere T-SQL-kode automatisk ved hjælp af kodeskabelonen fra objektoversigtens genvejsmenu. Følgende skabeloner er tilgængelige for T-SQL-notesbøger:

  • Vælg de øverste 100
  • Opret tabel
  • Opret som vælg
  • Ophæv
  • Slip og opret

Skærmbillede af visning af t-sql-kodeskabelonen.

Du kan køre én T-SQL-kodecelle ved at vælge knappen Kør på celleværktøjslinjen eller køre alle celler ved at vælge knappen Kør alle på værktøjslinjen.

Bemærk

Hver kodecelle udføres i en separat session, så de variabler, der er defineret i én celle, er ikke tilgængelige i en anden celle.

I den samme kodecelle kan den indeholde flere kodelinjer. Brugeren kan vælge en del af denne kode og kun køre de markerede. Hver udførelse genererer også en ny session.

Skærmbillede, der viser, hvordan du kører den valgte kodecelle.

Når koden er udført, skal du udvide meddelelsespanelet for at kontrollere udførelsesoversigten.

Skærmbillede, der viser udførelsesoversigten.

Under fanen Tabel vises posterne fra det returnerede resultatsæt. Hvis udførelsen indeholder flere resultatsæt, kan du skifte fra én til en anden via rullemenuen.

Skærmbillede, der viser, hvordan du skifter i resultatfanen.

Brug diagramfunktionerne til grafisk at repræsentere forespørgselsresultater

Ved at klikke på Undersøg kan du se de diagrammer, der repræsenterer datakvaliteten og fordelingen af hver kolonne

Skærmbillede, der viser inspicere resultatet i en diagramformular.

Gem forespørgslen som en visning eller tabel

Du kan bruge menuen Gem som tabel til at gemme resultaterne af forespørgslen i tabellen ved hjælp af kommandoen CTAS . Hvis du vil bruge denne menu, skal du vælge forespørgselsteksten i kodecellen og vælge Gem som tabelmenu .

Skærmbillede, der viser, hvordan du gemmer forespørgslen som en tabel.

Skærmbillede af, hvordan du gemmer en tabel som dialogboks.

På samme måde kan du oprette en visning ud fra den valgte forespørgselstekst ved hjælp af menuen Gem som visning på cellens kommandolinje.

Skærmbillede, der viser, hvordan du opretter en visning.

Skærmbillede, der viser dialogboksen Gem som visning.

Bemærk

  • Da menuen Gem som tabel og Gem som visning kun er tilgængelig for den valgte forespørgselstekst, skal du vælge forespørgselsteksten, før du bruger disse menuer.

  • Opret visning understøtter ikke navngivning i tre dele, så visningen oprettes altid på det primære lager ved at angive lageret som det primære lager.

Forespørgsel på tværs af lager

Du kan køre forespørgsler på tværs af lagersteder ved hjælp af navngivning i tre dele. Navngivning i tre dele består af databasenavn, skemanavn og tabelnavn. Databasenavnet er navnet på lageret eller SQL Analytics-slutpunktet, skemanavnet er navnet på skemaet, og tabelnavnet er navnet på tabellen.

Skærmbillede, der viser, hvordan du kører en forespørgsel på tværs af lagersteder.

Spring udførelsen af ikke-T-SQL-kode over

I den samme notesbog er det muligt at oprette kodeceller, der bruger forskellige sprog. En PySpark-kodecelle kan f.eks. være foran en T-SQL-kodecelle. I så fald kan brugeren vælge at springe kørslen af en PySpark-kode for T-SQL-notesbogen over. Denne dialogboks vises, når du kører alle kodecellerne ved at klikke på knappen Kør alle på værktøjslinjen.

Skærmbillede, der viser, hvordan du springer ikke-TSQL-kode over.

Overvågning af udførelse af T-SQL-notesbog

Du kan overvåge udførelsen af T-SQL-notesbøger under fanen T-SQL i visningen Seneste kørsel. Du kan finde visningen Seneste kørsel ved at vælge menuen Kør i notesbogen.

Skærmbillede, der viser visningen af den seneste kørsel.

I kørselsvisningen T-SQL-historik kan du se en liste over kørende, fuldførte, annullerede og mislykkede forespørgsler op til de seneste 30 dage.

  • Brug rullelisten til at filtrere efter status eller afsendelsestid.
  • Brug søgelinjen til at filtrere efter bestemte nøgleord i forespørgselsteksten eller andre kolonner.

For hver forespørgsel angives følgende oplysninger:

Kolonnenavn Beskrivelse
Id for distribueret sætning Entydigt id for hver forespørgsel
Forespørgselstekst Tekst i den udførte forespørgsel (op til 8.000 tegn)
Afsendelsestidspunkt (UTC) Tidsstempel for, hvornår anmodningen blev modtaget
Varighed Den tid, det tog at udføre forespørgslen
Status Forespørgselsstatus (kører, lykkedes, mislykkedes eller annulleret)
Submitter Navnet på den bruger eller det system, der sendte forespørgslen
Sessions-id Id, der sammenkæder forespørgslen med en bestemt brugersession
Standard warehouse Navnet på det lager, der accepterer den sendte forespørgsel

Historiske forespørgsler kan tage op til 15 minutter, før de vises på listen, afhængigt af den samtidige arbejdsbelastning, der udføres.

Aktuelle begrænsninger

  • Parametercellen understøttes endnu ikke i T-SQL-notesbogen. Den parameter, der overføres fra pipelinen eller planlæggeren, kan ikke bruges i T-SQL-notesbogen.
  • Url-adressen til overvågning i pipelineudførelsen understøttes endnu ikke i T-SQL-notesbogen.
  • Snapshotfunktionen understøttes endnu ikke i T-SQL-notesbogen.

Relateret indhold

Du kan få flere oplysninger om Fabric-notesbøger i følgende artikler.

  • Last updated on