Del via

T-SQL-støtte i Microsoft Fabric-notatblokker

  • Artikkel

Med funksjonen T-SQL-notatblokk i Microsoft Fabric kan du skrive og kjøre T-SQL-kode i en notatblokk. Du kan bruke T-SQL-notatblokker til å behandle komplekse spørringer og skrive bedre markdown-dokumentasjon. Den tillater også direkte kjøring av T-SQL på tilkoblet lager eller SQL Analytics-endepunkt. Ved å legge til et datalager- eller SQL-analyseendepunkt i en notatblokk, kan T-SQL-utviklere kjøre spørringer direkte på det tilkoblede endepunktet. BI-analytikere kan også utføre spørringer på tvers av databaser for å samle innsikt fra flere lagre og SQL Analytics-endepunkter.

De fleste av de eksisterende notatblokkfunksjonalitetene er tilgjengelige for T-SQL-notatblokker. Disse omfatter diagramspørringsresultater, samtidig redigering av notatblokker, planlegging av regelmessige kjøringer og utføring av kjøring i dataintegreringssamlebånd.

Viktig

Denne funksjonen er i forhåndsvisning.

I denne artikkelen lærer du hvordan du:

  • Opprette en T-SQL-notatblokk
  • Legge til et datalager eller sql analytics-endepunkt i en notatblokk
  • Opprette og kjøre T-SQL-kode i en notatblokk
  • Bruk diagramfunksjonene til å representere spørringsresultater grafisk
  • Lagre spørringen som en visning eller en tabell
  • Kjør krysslagerspørringer
  • Hoppe over kjøringen av ikke-T-SQL-kode

Opprette en T-SQL-notatblokk

Du kan opprette en T-SQL-notatblokk på følgende måter for å komme i gang med denne opplevelsen:

  1. Opprett en T-SQL-notatblokk fra stoffarbeidsområdet: Velg Nytt element, og velg deretter notatblokk fra panelet som åpnes.

    Skjermbilde av oppretting av en ny notatblokk fra et arbeidsområde.

  2. Opprett en T-SQL-notatblokk fra et eksisterende lagerredigeringsprogram: Gå til et eksisterende lager, og velg Ny SQL-spørring, og deretter ny T-SQL-spørringsnotatblokk.

    Skjermbilde av åpen notatblokk fra DW SQL Editor.

Når notatblokken er opprettet, angis T-SQL som standardspråk. Du kan legge til datalager- eller SQL-analyseendepunkter fra gjeldende arbeidsområde i notatblokken.

Legge til et datalager- eller SQL-analyseendepunkt i en notatblokk

Hvis du vil legge til et Data Warehouse- eller SQL Analytics-endepunkt i en notatblokk, velger du +Datakilder-knappen fra redigeringsprogrammet for notatblokken og velger Lagre. Velg datalageret eller SQL Analytics-endepunktet du vil koble til, fra datahubpanelet .

Skjermbilde av å legge til datalager eller sql-endepunkt i notatblokken.

Angi et primærlager

Du kan legge til flere lagre eller SQL Analytics-endepunkter i notatblokken, og ett av dem er angitt som primær. Det primære lageret kjører T-SQL-koden. Hvis du vil angi det, går du til objektutforskeren, velger ... ved siden av lageret og velger Angi som primær.

Skjermbilde av innstilling av primærlager.

For alle T-SQL-kommandoer som støtter tredelt navngivning, brukes primærlageret som standardlager hvis det ikke er angitt noe lager.

Opprette og kjøre T-SQL-kode i en notatblokk

Hvis du vil opprette og kjøre T-SQL-kode i en notatblokk, legger du til en ny celle og angir T-SQL som cellespråk.

Skjermbilde som viser hvordan du oppretter en t-sql-kodecelle.

Du kan autogenerere T-SQL-kode ved hjelp av kodemalen fra hurtigmenyen til objektutforskeren. Følgende maler er tilgjengelige for T-SQL-notatblokker:

  • Velg topp 100
  • Opprett tabell
  • Opprett som valgt
  • Fjern
  • Slipp og opprett

Skjermbilde av å vise t-sql-kodemalen.

Du kan kjøre én T-SQL-kodecelle ved å velge Kjør-knappen på celleverktøylinjen eller kjøre alle celler ved å velge Kjør alle-knappen på verktøylinjen.

Merk

Hver kodecelle utføres i en egen økt, slik at variablene som er definert i én celle, ikke er tilgjengelige i en annen celle.

I samme kodecelle kan den inneholde flere linjer med kode. Brukeren kan velge en del av denne koden og bare kjøre de valgte. Hver kjøring genererer også en ny økt.

Skjermbilde som viser hvordan du kjører merket kodecelle.

Når koden er utført, utvider du meldingspanelet for å kontrollere utførelsessammendraget.

Skjermbilde som viser utførelsessammendraget.

Tabell-fanen viser postene fra det returnerte resultatsettet. Hvis kjøringen inneholder flere resultatsett, kan du bytte fra ett til et annet via rullegardinmenyen.

Skjermbilde som viser hvordan du bytter i resultatfanen.

Bruk diagramfunksjonene til å representere spørringsresultater grafisk

Ved å klikke på Undersøk kan du se diagrammene som representerer datakvaliteten og distribusjonen av hver kolonne

Skjermbilde som viser undersøk resultatet i et diagramskjema.

Lagre spørringen som en visning eller tabell

Du kan bruke Lagre som tabell-menyen til å lagre resultatene av spørringen i tabellen ved hjelp av CTAS-kommandoen . Hvis du vil bruke denne menyen, merker du spørringsteksten fra kodecellen og velger Lagre som tabell-menyen .

Skjermbilde som viser hvordan du lagrer spørringen som en tabell.

Skjermbilde av hvordan du lagrer en tabell som dialogboks.

På samme måte kan du opprette en visning fra den valgte spørringsteksten ved hjelp av Lagre som visning-menyen på kommandolinjen i cellen.

Skjermbilde som viser hvordan du oppretter en visning.

Skjermbilde som viser lagre som en visningsdialogboks.

Merk

  • Siden Menyen Lagre som tabell og Lagre som visning bare er tilgjengelig for den valgte spørringsteksten, må du merke spørringsteksten før du bruker disse menyene.

  • Opprettingsvisning støtter ikke tredelt navngivning, så visningen opprettes alltid i primærlageret ved å angi lageret som det primære lageret.

Krysslagerspørring

Du kan kjøre krysslagerspørring ved hjelp av tredelt navngiving. Den tredelte navngivningen består av databasenavnet, skjemanavnet og tabellnavnet. Databasenavnet er navnet på lageret eller SQL Analytics-endepunktet, skjemanavnet er navnet på skjemaet, og tabellnavnet er navnet på tabellen.

Skjermbilde som viser hvordan du kjører en krysslagerspørring.

Hoppe over kjøringen av ikke-T-SQL-kode

I samme notatblokk er det mulig å opprette kodeceller som bruker forskjellige språk. En PySpark-kodecelle kan for eksempel stå foran en T-SQL-kodecelle. I slike tilfeller kan brukeren velge å hoppe over kjøringen av en PySpark-kode for T-SQL-notatblokk. Denne dialogboksen vises når du kjører alle kodecellene ved å klikke Kjør alle-knappen på verktøylinjen.

Skjermbilde som viser hvordan du hopper over ikke-TSQL-kode.

Begrensninger for offentlig forhåndsvisning

  • Parametercelle støttes ennå ikke i T-SQL-notatblokken. Parameteren som sendes fra datasamlebåndet eller planleggeren, kan ikke brukes i T-SQL-notatblokken.
  • Nylig kjøring-funksjonen støttes ennå ikke i T-SQL-notatblokken. Du må bruke den gjeldende overvåkingsfunksjonen for datalager til å kontrollere kjøringsloggen for T-SQL-notatblokken. Hvis du vil ha mer informasjon, kan du se artikkelen Overvåk datalager .
  • Url-adressen for skjermen i kjøringen av datasamlebåndet støttes ennå ikke i T-SQL-notatblokken.
  • Øyeblikksbildefunksjonen støttes ennå ikke i T-SQL-notatblokken.
  • Støtte for git- og distribusjonssamlebånd støttes ennå ikke i T-SQL-notatblokken.

Relatert innhold

Hvis du vil ha mer informasjon om Fabric-notatblokker, kan du se følgende artikler.