Freigeben über

SQL-Notizbücher (Vorschau)

SQL-Notizbücher in der MSSQL-Erweiterung für Visual Studio Code stellen die notizbuchbasierte SQL-Entwicklung mit nativen Visual Studio Code Jupyter-Notizbüchern bereit. Sie können die interaktive SQL-Abfrageausführung mit Markdown-Dokumentationszellen kombinieren, um ausgeführte Abfragesammlungen, Dokumentdatenbankvorgänge zu erstellen und reproduzierbare Analysen zu teilen.

Tipp

SQL-Notizbücher befinden sich derzeit in der Vorschau und können sich je nach Feedback ändern. Treten Sie der Community bei GitHub-Diskussionen bei, um Ideen zu teilen oder Probleme zu melden.

Funktionen

SQL-Notizbücher bieten folgende Funktionen:

  • Führen Sie T-SQL-Abfragen interaktiv in Notizbuchcodezellen aus, wobei die Inlineergebnisse unterhalb jeder Zelle angezeigt werden.

  • Verwenden Sie das systemeigene Visual Studio Code Jupyter-Notizbuchformat (.ipynb Dateien) für die vollständige Kompatibilität mit vorhandenen Notizbuchtools.

  • Anzeigen von Abfrageergebnissen in einem umfangreichen Datenraster mit Sortierung, Filterung, Zellauswahl, Hervorhebung von Nullwerten und Kopieroptionen (einschließlich Kopieren mit Kopfzeilen).

  • Schreiben Sie SQL mit IntelliSense, einschließlich Tabellen- und Spaltennamenvorschlägen basierend auf Ihrer aktiven Datenbankverbindung.

  • Fügen Sie Markdown-Textzellen zusammen mit SQL-Codezellen zu Dokumentabfragen hinzu, kommentieren Sie Ergebnisse, und erstellen Sie narrative Workflows.

  • Verbinden Sie jedes Notizbuch mit einer SQL Server-Instanz, und wechseln Sie zwischen Datenbanken auf demselben Server.

  • Führen Sie Zellen einzeln aus, oder führen Sie alle Zellen sequenziell aus.

  • Verwenden Sie GitHub Copilot für Inlineabfragevorschläge in Codezellen und chatgesteuerte Notizbucherstellung, um vollständige Notizbücher aus beschreibungen natürlicher Sprache zu generieren.

  • Kombinieren Sie SQL-Zellen mit anderen Sprachkernkernen (z. B. Python) im selben Notizbuch, indem Sie die Jupyter-Erweiterung installieren.

  • Exportieren und Freigeben von Notizbüchern als .ipynb Dateien, die andere in Visual Studio Code oder einer beliebigen Jupyter-kompatiblen Umgebung öffnen können.

Voraussetzungen

Bevor Sie SQL-Notizbücher verwenden, stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind:

Erstellen eines SQL-Notebooks

Sie können ein neues SQL-Notizbuch auf verschiedene Arten erstellen:

  • Öffnen Sie die Befehlspalette (Strg+Umschalt+P unter Windows und Linux oder Cmd+Umschalt+P unter macOS), geben Sie einen Befehl ein, und wählen Sie ihn aus.

  • Wechseln Sie zum Menü "Datei ", und wählen Sie " Neue Datei" und dann den Typ "Jupyter-Notizbuch" aus.

  • Klicken Sie im Objekt-Explorer der MSSQL-Erweiterung mit der rechten Maustaste auf eine Datenbank, und wählen Sie im Kontextmenü " Neues Notizbuch " aus.

Wenn Sie ein neues Notizbuch erstellen, wählen Sie den MSSQL-Kernel aus, um die T-SQL-Ausführung in Codezellen zu aktivieren.

Herstellen einer Verbindung mit einer Datenbank

Jedes SQL-Notizbuch benötigt eine aktive Datenbankverbindung zum Ausführen von Abfragen. Wenn Sie ein Notizbuch mit dem MSSQL-Kernel öffnen, werden Sie von der Erweiterung aufgefordert, ein Verbindungsprofil auszuwählen oder ein neues zu erstellen.

Von Bedeutung

Jedes Notizbuch unterstützt eine einzelne Serververbindung pro Kernel. Sie können eine Verbindung mit einer SQL Server-Instanz herstellen und zwischen Datenbanken auf diesem Server wechseln, aber Sie können keine Verbindung mit mehreren Servern innerhalb desselben Notizbuchs herstellen. Um mit einem anderen Server zu arbeiten, erstellen Sie ein separates Notizbuch, oder ändern Sie die Verbindung des Notizbuchs.

Schreiben und Ausführen von SQL-Zellen

Mithilfe von SQL-Codezellen können Sie T-SQL-Abfragen interaktiv innerhalb des Notizbuchs schreiben und ausführen.

  1. Wählen Sie +Code in der Notizbuchsymbolleiste aus, um eine neue Codezelle hinzuzufügen.

  2. Geben Sie Ihre T-SQL-Abfrage in die Zelle ein. Die Zelle bietet die gleiche SQL-Bearbeitungsoberfläche wie ein Standardabfrage-Editor, einschließlich IntelliSense mit Tabellen- und Spaltennamenvorschlägen aus der verbundenen Datenbank.

  3. Wählen Sie "Zelle ausführen" (die Schaltfläche "Wiedergeben" links neben der Zelle) aus, um die Abfrage auszuführen.

  4. Ergebnisse werden direkt unterhalb der Zelle in einem Rich-Data-Raster angezeigt.

Wenn Sie alle Zellen im Notizbuch sequenziell ausführen möchten, wählen Sie " Alle ausführen " in der Notizbuchsymbolleiste aus.

Tipp

Verwenden Sie Strg+Eingabetaste (Windows und Linux) oder Cmd+Enter (macOS), um die aktuelle Zelle auszuführen und darauf zu bleiben. Verwenden Sie Umschalttaste+Enter, um die aktuelle Zelle auszuführen und zum nächsten zu wechseln.

Abfrageergebnisse

Abfrageergebnisse in SQL-Notizbüchern bieten die gleiche umfangreiche Datenrasteroberfläche, die im Standardabfrage-Editor verfügbar ist:

  • Sortieren: Wählen Sie eine Spaltenüberschrift aus, um die Ergebnisse aufsteigend oder absteigend zu sortieren.
  • Filtern: Verwenden Sie das Filtersymbol für Spaltenüberschriften, um Ergebnisdaten zu filtern.
  • Zellauswahl: Markieren Sie einzelne Zellen oder Zellbereiche im Ergebnisraster.
  • Null-Hervorhebung: Werte werden im Ergebnisraster visuell hervorgehoben, um eine einfache Identifizierung zu ermöglichen.
  • Kopieroptionen: Klicken Sie mit der rechten Maustaste auf ausgewählte Zellen, um auf "Kopieren", "Mit Kopfzeilen kopieren" und " Alle auswählen " zuzugreifen.

Hinzufügen von Markdownzellen

Sie können Markdown-Zellen verwenden, um formatierten Text, Überschriften, Listen und Links zusammen mit Ihren SQL-Codezellen hinzuzufügen. Verwenden Sie sie, um Ihre Abfragen zu dokumentieren, geschäftslogik zu erläutern oder Notizen zu erwarteten Ergebnissen hinzuzufügen.

  1. Wählen Sie +Markdown in der Notizbuchsymbolleiste aus, um eine neue Textzelle hinzuzufügen.

  2. Geben Sie Ihren Markdown-Inhalt ein. Während der Eingabe wird eine Vorschau angezeigt.

  3. Markieren Sie außerhalb der Zelle, um den Markdown-Text zu rendern.

Wählen Sie die Zelle erneut aus, um zum Bearbeitungsmodus zurückzukehren.

Verwenden mehrerer Kernel

Die MSSQL-Erweiterung stellt den SQL-Kernel sofort bereit. Sie können Ihre Notizbücher mit mehr Sprachkernkernen erweitern, indem Sie die Jupyter-Erweiterung installieren, die Unterstützung für Python und andere Kernels bündelt. Sie können SQL-Datenabfragen mit Python-Datenverarbeitungs- und Visualisierungszellen im selben Notizbuch kombinieren.

GitHub Copilot-Integration

GitHub Copilot arbeitet mit SQL-Notizbüchern zusammen, um Abfragen zu schreiben und Notizbücher zu generieren. Wenn Sie die GitHub Copilot-Erweiterung installieren, erhalten Sie Folgendes:

  • Inline-Vorschläge: Während Sie in SQL-Codezellen schreiben, schlägt GitHub Copilot Abfrageabschlüsse basierend auf dem Datenbankkontext und den umgebenden Markdown-Zellen vor.

  • Chatgesteuerte Notizbucherstellung: Verwenden Sie GitHub Copilot Chat, um vollständige Notizbücher mit abwechselnden Markdown- und SQL-Zellen zu generieren. Beschreiben Sie die Analyse, die Sie ausführen möchten, und GitHub Copilot erstellt die vollständige Notizbuchstruktur.

Sie können beispielsweise GitHub Copilot Chat öffnen und eine Eingabeaufforderung wie folgt verwenden:

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

GitHub Copilot generiert die Markdown-Dokumentationszellen und T-SQL-Codezellen, die Sie dann einzeln oder alle gleichzeitig mit Run All ausführen können.

Wechseln von Datenbanken

So wechseln Sie innerhalb derselben Serververbindung zu einer anderen Datenbank:

  1. Wählen Sie den Datenbanknamen aus, der im Verbindungsstatusbereich des Notizbuchs angezeigt wird.

  2. Wählen Sie eine andere Datenbank aus der Dropdownliste aus.

Alle nachfolgenden Zellausführungen verwenden die neu ausgewählte Datenbank.

Hinweis

Um zu einem anderen Server zu wechseln, müssen Sie das Verbindungsprofil des Notizbuchs ändern. Erwägen Sie das Erstellen eines separaten Notizbuchs für jeden Server, mit dem Sie arbeiten müssen.

Einschränkungen

Einzelserververbindung pro Notizbuch: Derzeit stellt jedes Notizbuch eine Verbindung mit einer SQL Server-Instanz dar. Sie können Datenbanken auf diesem Server wechseln, aber keine Verbindung mit einem zweiten Server innerhalb desselben Notizbuchs herstellen.

Feedback und Support

Wenn Sie Ideen oder Feedback haben oder sich mit der Community austauschen möchten, nehmen Sie an der Diskussion teil https://aka.ms/vscode-mssql-discussions. Um einen Fehler zu melden, besuchen Sie https://aka.ms/vscode-mssql-bug. Um ein neues Feature anzufordern, wechseln Sie zu https://aka.ms/vscode-mssql-feature-request.

Verwandte Inhalte

  • Last updated on