Ausführen von T-SQL-Code in Fabric Python-Notizbüchern

Die Mischung aus T-SQL und Python in modernen Datenworkflows bietet einen leistungsstarken und flexiblen Ansatz, der die Stärken beider Sprachen vereint. SQL bleibt die effizienteste und lesbarste Methode zum Abfragen, Filtern und Verknüpfen strukturierter Daten, während Python bei der Datentransformation, statistischen Analyse, maschinellem Lernen und Visualisierung exceliert. Durch die Kombination von T-SQL und Python können Datentechniker das Beste aus beiden Welten nutzen, sodass sie robuste Pipelines erstellen können, die effizient, wartungsfähig und in der Lage sind, komplexe Datenverarbeitungsaufgaben zu verarbeiten.

In Microsoft Fabric Python-Notizbüchern haben wir ein neues Feature namens T-SQL magic command eingeführt. Mit diesem Feature können Sie T-SQL-Code direkt in Python-Notizbüchern mit vollständiger Syntaxmarkierung und Codeabschluss ausführen. Dies bedeutet, dass Sie T-SQL-Code in einem Python-Notizbuch schreiben können und wie eine T-SQL-Zelle ausgeführt werden. Dieses Feature ist nützlich für Datentechniker, die die Leistungsfähigkeit von T-SQL nutzen möchten, während sie weiterhin die Flexibilität von Python-Notizbüchern nutzen möchten.

In diesem Artikel untersuchen wir den T-SQL-Zauberbefehl in Microsoft Fabric-Notizbüchern. Wir behandeln, wie Sie diesen Befehl aktivieren, angeben, welches Lager verwendet werden soll, und wie die Ergebnisse von T-SQL-Abfragen an Python-Variablen gebunden werden.

Dieses Feature ist für Fabric Python-Notizbücher verfügbar. Sie müssen die Sprache auf Python im Notizbuch und den Zelltyp auf T-SQL festlegen.

Important

Dieses Feature befindet sich in der Vorschauphase.

Verwenden des T-SQL-Zauberbefehls zum Abfragen von Fabric Data Warehouse

Um den T-SQL-Zauberbefehl in Ihrem Fabric-Notizbuch zu aktivieren, müssen Sie den %%tsql magischen Befehl am Anfang Ihrer Zelle festlegen. Dieser Befehl gibt den Code in dieser Zelle an, der als T-SQL-Code behandelt werden soll.

In diesem Beispiel verwenden wir den T-SQL-Zauberbefehl, um ein Fabric Data Warehouse abzufragen. Der Befehl verwendet die folgenden Parameter:

• Der -artifact Parameter gibt den Namen des zu verwendenden Data Warehouse an. Der T-SQL-Code in der Zelle wird für das angegebene Data Warehouse in Fabric ausgeführt.
• Der -type Parameter gibt den Typ des Fabric-Elements an. Verwenden Sie Warehousefür Fabric Data Warehouse .
• Der -bind Parameter gibt den Namen der Variablen an, an die die Ergebnisse der T-SQL-Abfrage gebunden werden sollen. Im folgenden Beispiel werden die Ergebnisse der Abfrage in einer Python-Variablen gespeichert, die namens df1 ist. Wenn Sie eine Transformation auf die df1-Variable anwenden müssen, können Sie dazu Python-Code in der nächsten Zelle verwenden. Der -bind Parameter ist optional, es wird jedoch empfohlen, die Ergebnisse der T-SQL-Abfrage an eine Python-Variable zu binden. Mit diesem Parameter können Sie die Ergebnisse mithilfe von Python-Code ganz einfach bearbeiten und analysieren.
• Der -workspace Parameter ist optional und wird verwendet, wenn sich das Lager in einem anderen Arbeitsbereich befindet. Ohne diesen Parameter verwendet das Notizbuch den aktuellen Arbeitsbereich.

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

Wenn sowohl der -artifact-Parameter als auch der -type-Parameter übersprungen werden, verwendet das Notizbuch das Standardlagerobjekt im aktuellen Notizbuch.

Verwenden des T-SQL-Zauberbefehls zum Abfragen der SQL-Datenbank

Sie können auch den T-SQL-Zauberbefehl verwenden, um eine SQL-Datenbank in Fabric abzufragen. Die Syntax ähnelt dem Abfragen eines Data Warehouses, aber der -type Parameter muss auf SQLDatabase. festgelegt werden. Der -bind Parameter gibt den Namen der Variablen an, an die die Ergebnisse der T-SQL-Abfrage gebunden werden sollen.

Im folgenden Beispiel wird das Ergebnis der Abfrage in einer Python-Variablen namens df2 gespeichert.

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

Verwenden des T-SQL-Zauberbefehls zum Abfragen des SQL-Analyseendpunkts in Lakehouse

Sie können auch den T-SQL-Zauberbefehl verwenden, um einen SQL-Analyseendpunkt abzufragen. Die Syntax ähnelt dem Abfragen eines Data Warehouses, aber der -type Parameter muss auf Lakehouse. festgelegt werden. Der -bind Parameter gibt den Namen der Variablen an, an die die Ergebnisse der T-SQL-Abfrage gebunden werden sollen.

Im folgenden Beispiel wird das Ergebnis der Abfrage in einer Python-Variablen namens df3 gespeichert.

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

Verwendung des T-SQL-Magiebefehls als Zeilenmagie

Anstatt T-SQL in einer vollständigen Codezelle mit %%tsqlauszuführen, können Sie T-SQL in einer einzigen Zeile mit %tsql als Linienzauber ausführen. Sie müssen jedoch zuerst eine Sitzungsverbindung herstellen.

Important

Bevor Sie die Zeilenmagie %tsql verwenden, müssen Sie einen Zell-Magie-Befehl %%tsql mit dem Parameter -session ausführen, um den SQL-Magie-Kontext zu initialisieren. Das Ausführen von %tsql ohne diese Konfiguration führt zu einer SQLMagicContextInitializationException.

Voraussetzungen für Linienmagie

1. Initialisieren Sie die Sitzung: Schließen Sie in einer Zelle, die den %%tsql magischen Befehl verwendet, den Parameter -session ein, um den Verbindungskontext herzustellen. Beispiel:

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

2. Verwenden Sie Zeilenmagie: Nach der Initialisierung der Sitzung können Sie %tsql in den folgenden Zellen verwenden. Die Funktion „Line Magic“ wird die in Schritt 1 hergestellte Verbindung verwenden, ohne dass Sie -artifact und -type erneut angeben müssen. Beispiel:

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

Verweisen auf Python-Variablen in T-SQL

Sie können auch auf Python-Variablen im T-SQL-Code verweisen. Verwenden Sie dazu das {} Symbol gefolgt vom Namen der Python-Variablen. Wenn Sie beispielsweise eine Python-Variable namens counthaben, können Sie wie folgt in Ihrem T-SQL-Code darauf verweisen:

count = 10

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

Verwenden Sie den %tsql? Befehl, um die vollständige Syntax anzuzeigen. Dieser Befehl zeigt die Hilfeinformationen für den T-SQL-Zauberbefehl an, einschließlich der verfügbaren Parameter und deren Beschreibungen.

Note

Sie können die vollständigen DML- und DDL-Befehle für das Data Warehouse oder die SQL-Datenbank ausführen, jedoch nur eine schreibgeschützte Abfrage gegen den SQL-Endpunkt des Lakehouse durchführen.

Verwandte Inhalte

Weitere Informationen zu Fabric-Notebooks finden Sie in den folgenden Artikeln.

• Questions? Versuchen Sie, die Fabric-Community zu fragen.
• Suggestions? Tragen Sie Ideen bei, um Fabric zu verbessern.