Freigeben über

Unterstützung für T-SQL in Microsoft Fabric-Notebooks

  • Artikel

Mit dem T-SQL-Notebookfeature in Microsoft Fabric können Sie T-SQL-Code in einem Notebook schreiben und ausführen. Sie können T-SQL-Notebooks verwenden, um komplexe Abfragen zu verwalten und eine bessere Markdowndokumentation zu schreiben. Außerdem ermöglichen sie die direkte Ausführung von T-SQL im verbundenen Warehouse oder SQL-Analyseendpunkt. Durch Hinzufügen eines Data Warehouse oder SQL-Analyseendpunkts zu einem Notebook können T-SQL-Entwickler Abfragen direkt auf dem verbundenen Endpunkt ausführen. BI-Analysten können außerdem datenbankübergreifende Abfragen durchführen, um Erkenntnisse aus mehreren Warehouses und SQL-Analyseendpunkten zu sammeln.

Die meisten vorhandenen Notebookfunktionen sind für T-SQL-Notebooks verfügbar. Dazu gehören das Darstellen von Abfrageergebnissen in Diagrammen, Notebooks für die gemeinsame Dokumenterstellung, Planen regelmäßiger Ausführungen und Auslösen der Ausführung in Datenintegrationspipelines.

Wichtig

Dieses Feature befindet sich in Vorschau.

In diesem Artikel werden folgende Vorgehensweisen behandelt:

  • Erstellen eines T-SQL-Notebooks
  • Hinzufügen eines Data Warehouse oder SQL-Analyseendpunkts zu einem Notebook
  • Erstellen und Ausführen von T-SQL-Code in einem Notebook
  • Verwenden der Diagrammfeatures zum grafischen Darstellen von Abfrageergebnissen
  • Speichern der Abfrage als Sicht oder Tabelle
  • Ausführen von warehouseübergreifenden Abfragen
  • Überspringen der Ausführung von Nicht-T-SQL-Code

Erstellen eines T-SQL-Notebooks

Um mit dieser Erfahrung zu beginnen, können Sie ein T-SQL-Notebook auf zwei Arten erstellen:

  1. Erstellen Sie ein T-SQL-Notebook auf der Data Warehouse-Homepage: Navigieren Sie zur Data Warehouse-Oberfläche, und wählen Sie Notebook aus.

    Screenshot: Erstellen des T-SQL-Notebookeintrags auf der DW-Startseite.

  2. Erstellen eines T-SQL-Notebooks aus einem vorhandenen Warehouse-Editor: Navigieren Sie im oberen Navigationsmenüband zu einem vorhandenen Warehouse, wählen Sie Neue SQL-Abfrage und dann Neues T-SQL-Abfragenotebook aus.

Screenshot: Öffnen des Notebooks im DW-SQL-Editor.

Nachdem das Notebook erstellt wurde, wird T-SQL als Standardsprache festgelegt. Sie können Data Warehouses oder SQL-Analyseendpunkte aus dem aktuellen Arbeitsbereich zu Ihrem Notebook hinzufügen.

Hinzufügen eines Data Warehouse oder SQL-Analyseendpunkts zu einem Notebook

Wenn Sie einem Notebook ein Data Warehouse oder einen SQL-Analyseendpunkt hinzufügen möchten, wählen Sie im Notebook-Editor die Schaltfläche + Datenquellen und dann Warehouses aus. Wählen Sie im Bereich data-hub das Data Warehouse oder den SQL-Analyseendpunkt aus, mit dem Sie eine Verbindung herstellen möchten.

Screenshot: Hinzufügen eines Data Warehouse oder SQL-Endpunkts zum Notebook.

Festlegen eines primären Warehouse

Sie können dem Notebook mehrere Warehouses oder SQL-Analyseendpunkte hinzufügen, wobei einer davon als primär festgelegt ist. Das primäre Warehouse führt den T-SQL-Code aus. Wechseln Sie zum Festlegen zum Objekt-Explorer, wählen Sie ... neben dem Warehouse aus, und wählen Sie Als primär festlegen aus.

Screenshot: Festlegen des primären Warehouse.

Für jeden T-SQL-Befehl, der die dreiteilige Benennung unterstützt, wird das primäre Warehouse als Standardwarehouse verwendet, wenn kein Warehouse angegeben wird.

Erstellen und Ausführen von T-SQL-Code in einem Notebook

Um T-SQL-Code in einem Notebook zu erstellen und auszuführen, fügen Sie eine neue Zelle hinzu, und legen Sie T-SQL als Zellsprache fest.

Screenshot: Erstellen einer T-SQL-Codezelle.

Sie können T-SQL-Code automatisch mithilfe der Codevorlage aus dem Kontextmenü des Objekt-Explorers generieren. Die folgenden Vorlagen sind für T-SQL-Notebooks verfügbar:

  • Top 100 auswählen
  • Tabelle erstellen
  • Als Auswahl erstellen
  • Drop
  • DROP und CREATE

Screenshot: Anzeigen der T-SQL-Codevorlage.

Sie können eine T-SQL-Codezelle ausführen, indem Sie die Schaltfläche Ausführen in der Zellensymbolleiste auswählen, oder Sie können alle Zellen ausführen, indem Sie die Schaltfläche Alle ausführen auf der Symbolleiste auswählen.

Hinweis

Jede Codezelle wird in einer separaten Sitzung ausgeführt, sodass die in einer Zelle definierten Variablen in einer anderen Zelle nicht verfügbar sind.

Innerhalb derselben Codezelle können mehrere Codezeilen enthalten sein. Der Benutzer kann einen Teil dieses Codes auswählen und nur die ausgewählten Elemente ausführen. Jede Ausführung generiert ebenfalls eine neue Sitzung.

Screenshot: Ausführen der ausgewählten Codezelle.

Erweitern Sie nach dem Ausführen des Codes den Meldungsbereich, um die Ausführungszusammenfassung zu überprüfen.

Screenshot der Ausführungszusammenfassung.

Auf der Registerkarte Tabelle werden die Datensätze aus dem zurückgegebenen Resultset aufgeführt. Wenn die Ausführung mehrere Resultsets enthält, können Sie über das Dropdownmenü von einem zu einem anderen wechseln.

Screenshot, der zeigt, wie Sie auf der Ergebnisregisterkarte wechseln.

Verwenden der Diagrammfeatures zum grafischen Darstellen von Abfrageergebnissen

Durch Klicken auf Überprüfen können Sie die Diagramme sehen, die die Datenqualität und -verteilung jeder Spalte darstellen.

Screenshot der Untersuchung des Ergebnisses in einem Diagramm.

Speichern der Abfrage als Sicht oder Tabelle

Sie können das Menü Als Tabelle speichern verwenden, um die Ergebnisse der Abfrage mithilfe des CTAS-Befehls in einer Tabelle zu speichern. Um dieses Menü zu verwenden, wählen Sie den Abfragetext in der Codezelle aus, und wählen Sie das Menü Als Tabelle speichern aus.

Screenshot: Speichern der Abfrage als Tabelle.

Screenshot zum Speichern einer Tabelle als Dialogfeld.

Ebenso können Sie eine Ansicht aus dem ausgewählten Abfragetext erstellen, indem Sie das Menü Als Ansicht speichern in der Zellenbefehlsleiste verwenden.

Screenshot, der zeigt, wie eine Sicht erstellt wird.

Screenshot des Dialogfelds „Als Ansicht speichern“.

Hinweis

  • Da die Menüs Als Tabelle speichern und Als Ansicht speichern nur für den ausgewählten Abfragetext verfügbar sind, müssen Sie den Abfragetext auswählen, bevor Sie diese Menüs verwenden.

  • „Ansicht erstellen“ unterstützt keine dreiteilige Benennung, sodass die Sicht immer im primären Warehouse erstellt wird, indem das Warehouse als primäres Warehouse festgelegt wird.

Warehouseübergreifende Abfrage

Sie können eine warehouseübergreifende Abfrage ausführen, indem Sie dreiteilige Benennungen verwenden. Die dreiteilige Benennung besteht aus dem Datenbanknamen, dem Schemanamen und dem Tabellennamen. Der Datenbankname ist der Name des Warehouse oder SQL-Analyseendpunkts, der Schemaname ist der Name des Schemas, und der Tabellenname ist der Name der Tabelle.

Screenshot: Ausführen einer warehouseübergreifenen Abfrage.

Überspringen der Ausführung von Nicht-T-SQL-Code

Innerhalb desselben Notebooks können Codezellen erstellt werden, die unterschiedliche Sprachen verwenden. Beispielsweise kann eine PySpark-Codezelle einer T-SQL-Codezelle vorausgehen. In diesem Fall kann der Benutzer die Ausführung von PySpark-Code für das T-SQL-Notebook überspringen. Dieses Dialogfeld wird angezeigt, wenn Sie alle Codezellen ausführen, indem Sie auf die Schaltfläche Alle ausführen auf der Symbolleiste klicken.

Screenshot: Überspringen von Nicht-T-SQL-Code.

Einschränkungen der öffentlichen Vorschauversion

  • Die Parameterzelle wird im T-SQL-Notebook noch nicht unterstützt. Der Parameter, der von der Pipeline oder vom Scheduler übergeben wird, kann nicht im T-SQL-Notebook verwendet werden.
  • Die Funktion Letzte Ausführung wird im T-SQL-Notebook noch nicht unterstützt. Sie müssen das aktuelle Data Warehouse-Überwachungsfeature verwenden, um den Ausführungsverlauf des T-SQL-Notebooks zu überprüfen. Weitere Informationen finden Sie im Artikel zum Überwachen von Data Warehouse.
  • Die Überwachungs-URL in der Pipelineausführung wird im T-SQL-Notebook noch nicht unterstützt.
  • Die Momentaufnahmefunktion wird im T-SQL-Notebook noch nicht unterstützt.
  • Die Git- und Bereitstellungspipeline werden im T-SQL-Notebook noch nicht unterstützt.

Zugehöriger Inhalt

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