Suorita T-SQL-koodi Fabric Python -muistikirjoissa

T-SQL:n ja Pythonin yhdistelmä nykyaikaisissa tietotyönkuluissa tarjoaa tehokkaan ja joustavan lähestymistavan, jossa yhdistyvät molempien kielten vahvuudet. SQL on edelleen tehokkain ja luettavin tapa kysellä, suodattaa ja yhdistää strukturoitua dataa, kun taas Python on erinomainen tietojen muuntamisessa, tilastollisessa analyysissä, koneoppimisessa ja visualisoinnissa. Yhdistämällä T-SQL:n ja Pythonin datainsinöörit voivat käyttää molempien maailmojen parhaita puolia, jolloin he voivat rakentaa vankkoja putkistoja, jotka ovat tehokkaita, ylläpidettäviä ja pystyvät käsittelemään monimutkaisia tietojenkäsittelytehtäviä.

Microsoft Fabric Python -muistikirjoissa esittelimme uuden ominaisuuden nimeltä T-SQL-taikakomento. Tämän ominaisuuden avulla voit suorittaa T-SQL-koodia suoraan Python-muistikirjoissa täydellä syntaksin korostuksella ja koodin täydennyksellä. Tämä tarkoittaa, että voit kirjoittaa T-SQL-koodia Python-muistikirjaan, ja se suoritetaan ikään kuin se olisi T-SQL-solu. Tämä ominaisuus on hyödyllinen tietoinsinööreille, jotka haluavat käyttää T-SQL:n tehoa ja silti käyttää Python-muistikirjojen joustavuutta.

Tässä artikkelissa tutkimme T-SQL-taikakomentoa Microsoft Fabric -muistikirjoissa. Käsittelemme tämän komennon käyttöönottoa, käytettävän varaston määrittämistä ja T-SQL-kyselyiden tulosten sitomista Python-muuttujiin.

Tämä ominaisuus on käytettävissä Fabric Python -muistikirjoissa. Sinun on määritettävä muistikirjan kieleksi Python ja solutyypiksi T-SQL.

Important

Tämä ominaisuus on esikatseluvaiheessa.

T-SQL-taikakomennon käyttäminen Fabric-tietovaraston kyselyyn

Jos haluat ottaa T-SQL-taikakomennon käyttöön Fabric-muistikirjassasi, sinun on määritettävä %%tsql taikakomento solun alkuun. Tämä komento osoittaa, että solun koodia tulee käsitellä T-SQL-koodina.

Tässä esimerkissä käytämme T-SQL-taikakomentoa Fabric-tietovaraston kyselyyn. Komento ottaa seuraavat parametrit:

• Parametri -artifact määrittää käytettävän tietovaraston nimen. Solun T-SQL-koodi suoritetaan Fabricin määritettyä tietovarastoa vastaan.
• Parametri -type määrittää Kangas-nimikkeen tyypin. Käytä Fabric Data Warehousessa .Warehouse
• Parametri -bind määrittää sen muuttujan nimen, johon T-SQL-kyselyn tulokset sidotaan. Seuraavassa esimerkissä kyselyn tulokset tallennetaan Python-muuttujaan nimeltä df1. Jos sinun on käytettävä muunnosta df1-muuttujaan, voit tehdä sen käyttämällä Python-koodia seuraavassa solussa. Parametri -bind on valinnainen, mutta on suositeltavaa sitoa T-SQL-kyselyn tulokset Python-muuttujaan. Tämän parametrin avulla voit helposti käsitellä ja analysoida tuloksia Python-koodin avulla.
• Parametri -workspace on valinnainen, ja sitä käytetään, jos varasto sijaitsee eri työtilassa. Ilman tätä parametria muistikirja käyttää nykyistä työtilaa.

%%tsql -artifact dw1 -type Warehouse -bind df1
SELECT TOP (10) [GeographyID],
            [ZipCodeBKey],
            [County],
            [City],
            [State],
            [Country],
            [ZipCode]
FROM [dw1].[dbo].[Geography]

Jos sekä että parametrit -artifact-type ohitetaan, muistikirja käyttää nykyisen muistikirjan oletusvarastonimikettä.

T-SQL-taikakomennon käyttäminen SQL-tietokannan kyselyyn

Voit myös käyttää T-SQL-taikakomentoa SQL-tietokannan kyselyyn Fabricissa. Syntaksi on samanlainen kuin tietovaraston kysely, mutta parametrin arvoksi -typeSQLDatabaseon määritettävä . Parametri -bind määrittää sen muuttujan nimen, johon T-SQL-kyselyn tulokset sidotaan.

Seuraavassa esimerkissä kyselyn tulos tallennetaan Python-muuttujaan nimeltä df2.

%%tsql -artifact sqldb1 -type SQLDatabase -bind df2
SELECT TOP (10) [AddressID]
      ,[AddressLine1]
      ,[AddressLine2]
      ,[City]
      ,[StateProvince]
      ,[CountryRegion]
      ,[PostalCode]
      ,[rowguid]
      ,[ModifiedDate]
  FROM [SalesLT].[Address];

T-SQL-taikakomennon käyttäminen lakehouse SQL -analytiikan päätepisteen kyselyyn

Voit myös käyttää T-SQL-taikakomentoa SQL-analytiikan päätepisteen kyselyyn. Syntaksi on samanlainen kuin tietovaraston kysely, mutta parametrin arvoksi -typeLakehouseon määritettävä . Parametri -bind määrittää sen muuttujan nimen, johon T-SQL-kyselyn tulokset sidotaan.

Seuraavassa esimerkissä kyselyn tulos tallennetaan Python-muuttujaan nimeltä df3.

%%tsql -artifact lakehouse1 -type Lakehouse -bind df3
SELECT TOP (10) [ProductID],
      [Name],
      [ProductNumber],
      [Color],
      [StandardCost],
      [ListPrice]
FROM [lakehouse1].[dbo].[Product];

T-SQL-taikakomennon käyttäminen rivimagiana

Sen sijaan, että ajaisit T-SQL:n täydessä koodisolussa %%tsql, voit ajaa T-SQL:n yhdellä rivillä rivitaikuuden %tsql avulla. Kuitenkin sinun täytyy ensin luoda sessioyhteys.

Important

Ennen rivitaikuuden käyttöä %tsql sinun täytyy suorittaa cell %%tsql magic -komento parametrilla -session , jolla SQL magic -konteksti voidaan alustaa. Ilman tätä asetusta ajaminen %tsql johtaa SQLMagicContextInitializationException.

Viivataikuuden edellytykset

1. Aloita istunto: Solussa, jossa käytetään taikakomentoa %%tsql , sisällytä parametri -session yhteyden kontekstin luomiseksi. Esimerkkejä:

   %%tsql -artifact ContosoDWH -type Warehouse -session
   SELECT TOP(10) * FROM [ContosoDWH].[dbo].[Geography];
   

2. Käytä rivimagiaa: Kun istunto on aloitettu, voit käyttää %tsql sitä seuraavissa soluissa. Viivataikuus käyttää vaiheessa 1 luotua yhteyttä ilman, että sinun tarvitsee määritellä -artifact ja -type uudelleen. Esimerkkejä:

   df = %tsql SELECT TOP(10) * FROM [ContosoDWH].[dbo].[Geography];
   

Python-muuttujien viittaaminen T-SQL:ssä

Voit myös viitata Python-muuttujiin T-SQL-koodissa. Voit tehdä tämän käyttämällä symbolia {} , jota seuraa Python-muuttujan nimi. Jos sinulla on esimerkiksi Python-muuttuja nimeltä count, voit viitata siihen seuraavasti T-SQL-koodissasi:

count = 10

df = %tsql SELECT TOP({count}) * FROM [dw1].[dbo].[Geography];

Jos haluat nähdä koko syntaksin, käytä komentoa %tsql? . Tämä komento näyttää T-SQL-taikakomennon ohjetiedot, mukaan lukien käytettävissä olevat parametrit ja niiden kuvaukset.

Note

Voit suorittaa täydet DML- ja DDL-komennot tietovarastossa tai SQL-tietokannassa, mutta vain luku -kyselyn lakehouse sql -päätepisteessä.

Aiheeseen liittyvä sisältö

Lisätietoja Fabric-muistikirjoista on seuraavissa artikkeleissa.

• Questions? Kysy Fabric-yhteisöltä.
• Suggestions? Edistä ideoita Fabricin parantamiseksi.