Aracılığıyla paylaş

Fabric Python not defterlerinde T-SQL kodu çalıştırma

T-SQL ve Python'ın modern veri iş akışlarındaki karışımı, her iki dilin güçlü yanlarını bir araya getiren güçlü ve esnek bir yaklaşım sunar. SQL, yapılandırılmış verileri sorgulamanın, filtrelemenin ve birleştirmenin en verimli ve okunabilir yolu olmaya devam ederken Python veri dönüştürme, istatistiksel analiz, makine öğrenmesi ve görselleştirme konusunda üstünlük sağlar. Veri mühendisleri, T-SQL ve Python'ı birleştirerek her iki dünyanın da en iyi özelliklerini kullanarak verimli, sürdürülebilir ve karmaşık veri işleme görevlerini işleyebilen sağlam işlem hatları oluşturmalarına olanak tanır.

Microsoft Fabric Python not defterlerinde T-SQL magic komutu adlı yeni bir özellik kullanıma sunulmuştur. Bu özellik, T-SQL kodunu tam söz dizimi vurgulama ve kod tamamlama ile doğrudan Python not defterlerinde çalıştırmanıza olanak tanır. Bu, Python not defterine T-SQL kodu yazabileceğiniz ve T-SQL hücresiymiş gibi yürütüleceği anlamına gelir. Bu özellik, Python not defterlerinin esnekliğini kullanmaya devam ederken T-SQL'in gücünü kullanmak isteyen veri mühendisleri için kullanışlıdır.

Bu makalede, Microsoft Fabric not defterlerinde T-SQL sihirli komutunu inceleyeceğiz. Bu komutu etkinleştirme, kullanılacak ambarı belirtme ve T-SQL sorgularının sonuçlarını Python değişkenlerine bağlama konularını ele alacağız.

Bu özellik, Fabric Python defterleri için kullanılabilir. Dili not defterinde Python olarak, hücre türünü de T-SQL olarak ayarlamanız gerekir.

Important

Bu özellik önizleme aşamasındadır.

Fabric veri ambarını sorgulamak için T-SQL sihirli komutunu kullanma

Fabric not defterinizde T-SQL sihirli komutunu etkinleştirmek için hücrenizin başında %%tsql sihirli komutunu ayarlamanız gerekir. Bu komut, söz konusu hücredeki kodun T-SQL kodu olarak ele alınması gerektiğini gösterir.

Bu örnekte, Fabric Veri Ambarı'nı sorgulamak için T-SQL özel komutunu kullanıyoruz. komutu aşağıdaki parametreleri alır:

  • -artifact parametresi, kullanılacak veri ambarının adını belirtir. Hücredeki T-SQL kodu, Fabric'te belirtilen veri ambarına karşı yürütülür.
  • parametresi, -type Doku öğesinin türünü belirtir. Fabric Veri Ambarı için Warehouse kullanın.
  • parametresi, -bind T-SQL sorgusunun sonuçlarını bağlamak için değişkenin adını belirtir. Aşağıdaki örnekte, sorgunun sonuçları adlı df1bir Python değişkeninde depolanır. df1 değişkenine herhangi bir dönüştürme uygulamanız gerekiyorsa, sonraki hücrede Python kodunu kullanarak bunu yapabilirsiniz. -bind parametresi isteğe bağlıdır, ancak T-SQL sorgusunun sonuçlarının bir Python değişkenine bağlanması önerilir. Bu parametre Python kodunu kullanarak sonuçları kolayca işlemenize ve analiz etmenizi sağlar.
  • -workspace parametresi isteğe bağlıdır ve ambar farklı bir çalışma alanında bulunuyorsa kullanılır. Bu parametre olmadan not defteri geçerli çalışma alanını kullanır.
%%tsql -artifact dw1 -type Warehouse -bind df1
SELECT TOP (10) [GeographyID],
            [ZipCodeBKey],
            [County],
            [City],
            [State],
            [Country],
            [ZipCode]
FROM [dw1].[dbo].[Geography]

Veri ambarı ile tsql magic komutunu gösteren ekran görüntüsü.

Her iki -artifact ve -type parametresi de atlanırsa, not defteri mevcut not defterindeki varsayılan depo öğesini kullanır.

SQL veritabanını sorgulamak için T-SQL magic komutunu kullanma

SQL Fabric ortamındaki bir SQL veritabanını sorgulamak için T-SQL magic komutunu da kullanabilirsiniz. Söz dizimi, veri ambarını sorgulamaya benzer, ancak -type parametresi SQLDatabase olarak ayarlanmalıdır. parametresi, -bind T-SQL sorgusunun sonuçlarını bağlamak için değişkenin adını belirtir.

Aşağıdaki örnekte, sorgunun sonucu adlı df2bir Python değişkeninde depolanır.

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

sql veritabanı ile tsql magic komutunu gösteren ekran görüntüsü.

Lakehouse SQL analiz uç noktasını sorgulamak için T-SQL magic komutunu kullanma

Sql analiz uç noktasını sorgulamak için T-SQL magic komutunu da kullanabilirsiniz. Söz dizimi, veri ambarını sorgulamaya benzer, ancak -type parametresi Lakehouse olarak ayarlanmalıdır. parametresi, -bind T-SQL sorgusunun sonuçlarını bağlamak için değişkenin adını belirtir.

Aşağıdaki örnekte, sorgunun sonucu adlı df3bir Python değişkeninde depolanır.

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

Satır sihri olarak T-SQL magic komutunu kullanma

T-SQL'i %%tsql tam kod hücresinde çalıştırmak yerine, T-SQL'i %tsql satır sihir olarak tek bir satırda çalıştırabilirsiniz. Ancak, önce bir oturum bağlantısı kurmanız gerekir.

Important

Çizgi büyüsünü %tsql kullanmadan önce, SQL büyü bağlamını başlatmak için -session parametresiyle bir %%tsql hücre büyü komutu çalıştırmalısınız. Bu kurulum olmadan %tsql'yi çalıştırmak bir SQLMagicContextInitializationException ile sonuçlanır.

Çizgi sihri önkoşulları

  1. Oturumu başlatın: %%tsql sihirli komutunu kullanan bir hücrede, bağlantı bağlamını oluşturmak için `-session` adlı parametreyi ekleyin. Örneğin:

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

  2. Çizgi büyüsünü kullan: Oturumu başlatdıktan sonra aşağıdaki hücrelerde kullanabilirsiniz %tsql . Satır sihri, 1. adımda kurulan bağlantıyı tekrar -artifact ve -type belirtmenize gerek kalmadan kullanır. Örneğin:

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

Satır büyüsü ile tsql magic komutunu gösteren ekran görüntüsü.

T-SQL'de Python değişkenlerine başvurma

T-SQL kodunda Python değişkenlerine de başvurabilirsiniz. Bunu yapmak için simgeyi {} ve ardından Python değişkeninin adını kullanın. Örneğin, adlı countbir Python değişkeniniz varsa, T-SQL kodunuzda aşağıdaki gibi başvurabilirsiniz:

count = 10

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

Başvuru python değişkeni ile tsql magic komutunu gösteren ekran görüntüsü.

Söz diziminin tamamını görmek için komutunu kullanın %tsql? . Bu komut, kullanılabilir parametreler ve açıklamaları da dahil olmak üzere T-SQL sihirli komutunun yardım bilgilerini görüntüler.

Note

Veri ambarı veya SQL veritabanında tam DML ve DDL komutlarını çalıştırabilirsiniz, ancak lakehouse sql uç noktasında yalnızca salt okunur sorgu çalıştırabilirsiniz.

İlgili içerik

Doku not defterleri hakkında daha fazla bilgi için aşağıdaki makalelere bakın.

  • Last updated on