Delen via

SQL Notebooks (voorbeeldweergave)

SQL Notebooks in de MSSQL-extensie voor Visual Studio Code bieden notebookgebaseerde SQL-ontwikkeling met behulp van native Visual Studio Code Jupyter-notebooks. U kunt de uitvoering van interactieve SQL-query's combineren met Markdown-documentatiecellen om uitvoerbare queryverzamelingen, documentdatabasebewerkingen te bouwen en reproduceerbare analyse te delen.

Aanbeveling

SQL Notebooks is momenteel beschikbaar als preview-versie en kan worden gewijzigd op basis van feedback. Neem deel aan de community op GitHub-discussies om ideeën te delen of problemen te melden.

Features

SQL Notebooks biedt deze mogelijkheden:

  • Voer T-SQL-query's interactief uit in notebookcodecellen met inlineresultaten die onder elke cel worden weergegeven.

  • Gebruik de systeemeigen Visual Studio Code Jupyter-notebookindeling (.ipynb bestanden) voor volledige compatibiliteit met bestaande notebookhulpprogramma's.

  • Queryresultaten weergeven in een uitgebreid gegevensraster met sorteren, filteren, celselectie, null-waardemarkeringen en kopieeropties (inclusief kopiëren met kopteksten).

  • Schrijf SQL met IntelliSense, inclusief suggesties voor tabel- en kolomnamen op basis van uw actieve databaseverbinding.

  • Voeg Markdown-tekstcellen samen met SQL-codecellen toe aan documentquery's, aantekeningen toevoegen aan resultaten en verhalende werkstromen maken.

  • Verbind elk notebook met een SQL Server-exemplaar en schakel tussen databases op dezelfde server.

  • Voer cellen afzonderlijk uit of voer alle cellen opeenvolgend uit.

  • Gebruik GitHub Copilot voor inline querysuggesties in codecellen en het schrijven van chatgestuurde notebooks om volledige notebooks te genereren op basis van beschrijvingen van natuurlijke taal.

  • Combineer SQL-cellen met andere taalkernels (zoals Python) in hetzelfde notebook door de Jupyter-extensie te installeren.

  • Exporteer en deel notebooks als .ipynb bestanden die anderen kunnen openen in Visual Studio Code of een jupyter-compatibele omgeving.

Vereiste voorwaarden

Voordat u SQL Notebooks gebruikt, moet u ervoor zorgen dat aan de volgende vereisten wordt voldaan:

Een SQL-notebook maken

U kunt op verschillende manieren een nieuw SQL-notebook maken:

  • Open het opdrachtpalet (Ctrl+Shift+P in Windows en Linux of Cmd+Shift+P in macOS), typ New Notebooken selecteer de opdracht.

  • Ga naar het menu Bestand en selecteer Nieuw bestand en kies vervolgens het Jupyter Notebook-type.

  • Klik met de rechtermuisknop op een database in objectverkenner van de MSSQL-extensie en selecteer Nieuw notitieblok in het contextmenu.

Wanneer u een nieuw notebook maakt, selecteert u de MSSQL-kernel om T-SQL-uitvoering in codecellen in te schakelen.

Verbinding maken met een database

Elke SQL-notebook heeft een actieve databaseverbinding nodig om query's uit te voeren. Wanneer u een notebook opent met de MSSQL-kernel, wordt u door de extensie gevraagd een verbindingsprofiel te selecteren of een nieuw notitieblok te maken.

Belangrijk

Elk notebook ondersteunt één serververbinding per kernel. U kunt verbinding maken met één SQL Server-exemplaar en schakelen tussen databases op die server, maar u kunt geen verbinding maken met meerdere servers binnen hetzelfde notebook. Als u met een andere server wilt werken, maakt u een afzonderlijk notitieblok of wijzigt u de verbinding van het notitieblok.

SQL-cellen schrijven en uitvoeren

Met SQL-codecellen kunt u T-SQL-query's interactief in het notebook schrijven en uitvoeren.

  1. Selecteer + Code op de werkbalk van het notitieblok om een nieuwe codecel toe te voegen.

  2. Voer uw T-SQL-query in de cel in. De cel biedt dezelfde SQL-bewerkingservaring als een standaardquery-editor, waaronder IntelliSense met suggesties voor tabel- en kolomnamen uit de verbonden database.

  3. Selecteer Cel uitvoeren (de afspeelknop links van de cel) om de query uit te voeren.

  4. Resultaten worden direct onder de cel in een uitgebreid gegevensraster weergegeven.

Als u alle cellen in het notebook opeenvolgend wilt uitvoeren, selecteert u Alles uitvoeren op de werkbalk van het notitieblok.

Aanbeveling

Gebruik Ctrl+Enter (Windows en Linux) of Cmd+Enter (macOS) om de huidige cel uit te voeren en op de cel te blijven. Gebruik Shift+Enter om de huidige cel uit te voeren en naar de volgende te gaan.

Queryresultaten

Queryresultaten in SQL Notebooks bieden dezelfde rijke ervaring van het gegevensraster als beschikbaar in de standaardquery-editor.

  • Sorteren: Selecteer een kolomkop om resultaten oplopend of aflopend te sorteren.
  • Filteren: Gebruik het filterpictogram op kolomkoppen om resultaatgegevens te filteren.
  • Celselectie: Selecteer afzonderlijke cellen of cellenbereiken in het resultatenraster.
  • Null-markering: NULL waarden worden visueel gemarkeerd in het resultatenraster voor eenvoudige identificatie.
  • Kopieeropties: klik met de rechtermuisknop op geselecteerde cellen voor toegang tot Kopiëren, Kopiëren met kopteksten en Selecteer alle opties.

Markdown-cellen toevoegen

U kunt Markdown-cellen gebruiken om opgemaakte tekst, koppen, lijsten en koppelingen naast uw SQL-codecellen toe te voegen. Gebruik deze om uw query's te documenteren, bedrijfslogica uit te leggen of notities over verwachte resultaten toe te voegen.

  1. Selecteer + Markdown op de werkbalk van het notitieblok om een nieuwe tekstcel toe te voegen.

  2. Typ uw Markdown-inhoud. Er wordt een voorbeeld weergegeven terwijl u typt.

  3. Selecteer buiten de cel om de Markdown-tekst weer te geven.

Selecteer de cel opnieuw om terug te keren naar de bewerkingsmodus.

Meerdere kernels gebruiken

De MSSQL-extensie biedt de SQL-kernel direct. U kunt uw notebooks uitbreiden met meer taalkernels door de Jupyter-extensie te installeren, die ondersteuning voor Python en andere kernels bundelt. U kunt SQL-gegevensquery's combineren met Python-gegevensverwerkings- en visualisatiecellen in hetzelfde notebook.

GitHub Copilot-integratie

GitHub Copilot werkt met SQL Notebooks om u te helpen bij het schrijven van query's en het genereren van notebooks. Wanneer u de GitHub Copilot-extensie installeert, krijgt u het volgende:

  • Inlinesuggesties: Terwijl je typt in SQL-codesecties, stelt GitHub Copilot query-aanvullingen voor op basis van je databasecontext en de omringende Markdown-cellen.

  • Creatie van chatgestuurde notebooks: Gebruik GitHub Copilot Chat om volledige notebooks te genereren met afwisselende Markdown- en SQL-cellen. Beschrijf de analyse die u wilt uitvoeren en GitHub Copilot maakt de volledige notebookstructuur.

U kunt bijvoorbeeld GitHub Copilot Chat openen en een prompt gebruiken zoals:

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 genereert de Markdown-documentatiecellen en T-SQL-codecellen, die u vervolgens afzonderlijk of allemaal tegelijk kunt uitvoeren met Alles uitvoeren.

Schakelen tussen databases

Als u wilt overschakelen naar een andere database binnen dezelfde serververbinding:

  1. Selecteer de databasenaam die wordt weergegeven in het verbindingsstatusgebied van het notitieblok.

  2. Kies een andere database in de vervolgkeuzelijst.

Alle volgende celuitvoeringen maken gebruik van de zojuist geselecteerde database.

Opmerking

Als u wilt overschakelen naar een andere server, moet u het verbindingsprofiel van het notitieblok wijzigen. Overweeg om een afzonderlijk notebook te maken voor elke server waarmee u moet werken.

Beperkingen

Eén serververbinding per notebook: Momenteel maakt elk notebook verbinding met één SQL Server-exemplaar. U kunt databases op die server overschakelen, maar geen verbinding maken met een tweede server binnen hetzelfde notebook.

Feedback en ondersteuning

Als u ideeën, feedback of contact wilt opnemen met de community, kunt u deelnemen aan de discussie op https://aka.ms/vscode-mssql-discussions. Als u een fout wilt melden, gaat u naar https://aka.ms/vscode-mssql-bug. Als u een nieuwe functie wilt aanvragen, gaat u naar https://aka.ms/vscode-mssql-feature-request.

Verwante inhoud

  • Last updated on