Uruchamianie kodu T-SQL w notesach języka Python w Fabric

Połączenie języka T-SQL i Języka Python w nowoczesnych przepływach pracy danych oferuje zaawansowane i elastyczne podejście, które łączy mocne strony obu języków. Język SQL pozostaje najbardziej wydajnym i czytelnym sposobem wykonywania zapytań, filtrowania i łączenia danych ustrukturyzowanych, podczas gdy język Python wyróżnia się w przekształcaniu danych, analizie statystycznej, uczeniu maszynowym i wizualizacji. Łącząc język T-SQL i Python, inżynierowie danych mogą korzystać z najlepszych z obu światów, umożliwiając im tworzenie niezawodnych potoków, które są wydajne, konserwowane i zdolne do obsługi złożonych zadań przetwarzania danych.

W notatnikach języka Python w Microsoft Fabric wprowadziliśmy nową funkcję o nazwie polecenie magiczne T-SQL. Ta funkcja umożliwia uruchamianie kodu T-SQL bezpośrednio w notesach języka Python z pełnym wyróżnianiem składni i uzupełnianiem kodu. Oznacza to, że można napisać kod T-SQL w notesie języka Python i będzie wykonywany tak, jakby był to komórka języka T-SQL. Ta funkcja jest przydatna dla inżynierów danych, którzy chcą korzystać z możliwości języka T-SQL, jednocześnie korzystając z elastyczności notesów języka Python.

W tym artykule zapoznamy się z magicznym poleceniem języka T-SQL w notesach usługi Microsoft Fabric. Omówiono sposób włączania tego polecenia, określania magazynu do użycia oraz powiązania wyników zapytań T-SQL ze zmiennymi języka Python.

Ta funkcja jest dostępna dla notesów Fabric Python. Musisz ustawić język python w notesie, a typ komórki na T-SQL.

Important

Ta funkcja jest dostępna w wersji zapoznawczej.

Używanie polecenia magic języka T-SQL do wykonywania zapytań dotyczących magazynu danych usługi Fabric

Aby włączyć magiczne polecenie T-SQL w notesie usługi Fabric, musisz umieścić polecenie %%tsql na początku komórki. To polecenie wskazuje kod w tej komórce, który powinien być traktowany jako kod T-SQL.

W tym przykładzie używamy polecenia magic języka T-SQL do wykonywania zapytań względem usługi Fabric Data Warehouse. Polecenie przyjmuje następujące parametry:

Parametr -artifact określa nazwę magazynu danych do użycia. Kod T-SQL w komórce jest wykonywany względem określonego magazynu danych w sieci szkieletowej.
Parametr -type określa typ elementu sieci Fabric. W przypadku Fabric Data Warehouse użyj Warehouse.
Parametr -bind określa nazwę zmiennej, aby powiązać wyniki zapytania T-SQL z. W poniższym przykładzie wyniki zapytania są przechowywane w zmiennej języka Python o nazwie df1. Jeśli musisz zastosować dowolne przekształcenie do zmiennej df1, możesz to zrobić przy użyciu kodu języka Python w następnej komórce. Parametr -bind jest opcjonalny, ale zaleca się powiązanie wyników zapytania T-SQL ze zmienną języka Python. Ten parametr umożliwia łatwe manipulowanie wynikami i analizowanie ich przy użyciu kodu w języku Python.
Parametr -workspace jest opcjonalny i jest używany, jeśli magazyn znajduje się w innym obszarze roboczym. Bez tego parametru notebook używa bieżącego obszaru roboczego.

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

Jeśli zarówno parametr -artifact, jak i -type zostaną pominięte, notebook używa domyślnego elementu magazynu w aktualnym notebooku.

Używanie polecenia magic języka T-SQL do wykonywania zapytań dotyczących bazy danych SQL Database

Możesz również użyć polecenia magic języka T-SQL, aby wykonać zapytanie dotyczące bazy danych SQL w usłudze Fabric. Składnia jest podobna do zapytań do hurtowni danych, ale parametr -type musi być ustawiony na SQLDatabase. Parametr -bind określa nazwę zmiennej, aby powiązać wyniki zapytania T-SQL z.

W poniższym przykładzie wynik zapytania jest przechowywany w zmiennej języka Python o nazwie df2.

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

Używanie polecenia magic języka T-SQL do wykonywania zapytań względem punktu końcowego analizy SQL typu lakehouse

Możesz również użyć polecenia magic języka T-SQL, aby wykonać zapytanie dotyczące punktu końcowego analizy SQL. Składnia jest podobna do zapytań do hurtowni danych, ale parametr -type musi być ustawiony na Lakehouse. Parametr -bind określa nazwę zmiennej, aby powiązać wyniki zapytania T-SQL z.

W poniższym przykładzie wynik zapytania jest przechowywany w zmiennej języka Python o nazwie df3.

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

Używanie komendy magicznej języka T-SQL jako magia wiersza

Zamiast uruchamiać T-SQL w pełnej komórce kodu za pomocą %%tsql, można uruchomić T-SQL w jednym wierszu, używając %tsql jako polecenia linii. Należy jednak najpierw ustanowić połączenie sesji.

Important

Przed użyciem magii liniowej %tsql należy uruchomić magiczne polecenie komórki %%tsql z parametrem -session, aby zainicjować kontekst SQL magii. Uruchomienie %tsql bez tej konfiguracji może prowadzić do wystąpienia SQLMagicContextInitializationException.

Wymagania wstępne dotyczące magii linii

Rozpocznij sesję: w komórce używającej %%tsql polecenia magicznego dołącz parametr -session aby ustanowić kontekst połączenia. Przykład:
```
%%tsql -artifact ContosoDWH -type Warehouse -session
SELECT TOP(10) * FROM [ContosoDWH].[dbo].[Geography];
```
Użyj magii wiersza: po zainicjowaniu sesji można użyć %tsql w następujących komórkach. Komenda magiczna będzie używać połączenia ustanowionego w kroku 1 bez konieczności ponownego określania -artifact i -type. Przykład:
```
df = %tsql SELECT TOP(10) * FROM [ContosoDWH].[dbo].[Geography];
```

Odwoływanie się do zmiennych Pythona w T-SQL

Można również odwoływać się do zmiennych języka Python w kodzie języka T-SQL. W tym celu użyj symbolu {} , po którym następuje nazwa zmiennej języka Python. Jeśli na przykład masz zmienną języka Python o nazwie count, możesz odwoływać się do niej w następujący sposób w kodzie języka T-SQL:

count = 10

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

Aby wyświetlić pełną składnię %tsql? , użyj polecenia . To polecenie wyświetla informacje pomocy dotyczące polecenia magicznego języka T-SQL, w tym dostępne parametry i ich opisy.

Note

Pełne polecenia DML i DDL można uruchamiać względem magazynu danych lub bazy danych SQL, ale tylko zapytania tylko do odczytu względem punktu końcowego Lakehouse SQL.

Aby uzyskać więcej informacji na temat notesów sieci Szkieletowej, zobacz następujące artykuły.

Questions? Spróbuj poprosić społeczność sieci szkieletowej.
Suggestions? Wnoszenie pomysłów na ulepszenie Fabric.

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-11-19