Sdílet prostřednictvím

Poznámkové bloky SQL (Preview)

Poznámkové bloky SQL v rozšíření MSSQL pro Visual Studio Code poskytují vývoj SQL založený na poznámkových blocích pomocí nativních poznámkových bloků Jupyter editoru Visual Studio Code. Interaktivní spouštění dotazů SQL můžete kombinovat s buňkami dokumentace Markdownu k vytváření spustitelných kolekcí dotazů, operací databáze dokumentů a sdílení reprodukovatelné analýzy.

Návod

Poznámkové bloky SQL jsou aktuálně ve verzi Preview a můžou se měnit na základě zpětné vazby. Připojte se ke komunitě v diskuzích Na GitHubu a sdílejte nápady nebo nahlašujte problémy.

Features

Poznámkové bloky SQL nabízejí tyto možnosti:

  • Interaktivně spouštět dotazy T-SQL v buňkách kódu v interaktivním prostředí s výsledky zobrazujícími se pod každou buňkou.

  • Použijte původní formát Jupyter notebooku (.ipynb soubory) v editoru Visual Studio Code pro zajištění plné kompatibility s existujícími nástroji notebooku.

  • Umožňuje zobrazit výsledky dotazu v bohaté mřížce dat s řazením, filtrováním, výběrem buňky, zvýrazněním hodnoty null a možnostmi kopírování (včetně kopírování se záhlavími).

  • Napište SQL pomocí IntelliSense, včetně návrhů názvů tabulek a sloupců na základě aktivního připojení k databázi.

  • Přidejte textové buňky Markdownu spolu s buňkami kódu SQL k dokumentování dotazů, přidávání poznámek k výsledkům a vytváření pracovních postupů vyprávění.

  • Připojte každý notebook k instanci SQL Serveru a přepínejte mezi databázemi na stejném serveru.

  • Buňky můžete spustit jednotlivě nebo provést všechny buňky postupně.

  • Pomocí GitHub Copilotu můžete používat návrhy dotazů během psaní v buňkách kódu a vytváření poznámkových bloků pomocí chatu pro generování kompletních poznámkových bloků z popisů v přirozeném jazyce.

  • Pomocí instalace rozšíření Jupyter zkombinujte buňky SQL s jinými jazykovými jádry (například Python) ve stejném poznámkovém bloku.

  • Exportujte a sdílejte poznámkové bloky jako .ipynb soubory, které můžou ostatní otevřít v editoru Visual Studio Code nebo libovolném prostředí kompatibilním s Jupyterem.

Předpoklady

Před použitím poznámkových bloků SQL se ujistěte, že jsou splněny následující požadavky:

Vytvoření poznámkového bloku SQL

Nový poznámkový blok SQL můžete vytvořit několika způsoby:

  • Otevřete paletu příkazů (Ctrl+Shift+P ve Windows a Linuxu nebo Cmd+Shift+P v macOS), zadejte New Notebooka vyberte příkaz.

  • Přejděte do nabídky Soubor a vyberte Nový soubor a pak zvolte typ poznámkového bloku Jupyter.

  • V Průzkumníku objektů rozšíření MSSQL klikněte pravým tlačítkem na databázi a v místní nabídce vyberte Nový poznámkový blok .

Při vytváření nového poznámkového bloku vyberte jádro MSSQL a povolte provádění T-SQL v buňkách kódu.

Připojit k databázi

Každý poznámkový blok SQL potřebuje aktivní připojení k databázi ke spouštění dotazů. Když otevřete poznámkový blok s jádrem MSSQL, rozšíření vás vyzve k výběru profilu připojení nebo vytvoření nového.

Důležité

Každý poznámkový blok podporuje jedno připojení k serveru pro jedno jádro. Můžete se připojit k jedné instanci SQL Serveru a přepínat mezi databázemi na tomto serveru, ale nemůžete se připojit k více serverům ve stejném poznámkovém bloku. Pokud chcete pracovat s jiným serverem, vytvořte samostatný poznámkový blok nebo změňte připojení poznámkového bloku.

Psát a spouštět SQL buňky

Buňky kódu SQL umožňují interaktivně psát a spouštět dotazy T-SQL v poznámkovém bloku.

  1. Vyberte + Kód na panelu nástrojů poznámkového bloku a přidejte novou buňku kódu.

  2. Do buňky zadejte dotaz T-SQL. Buňka poskytuje stejné prostředí pro úpravy SQL jako standardní editor dotazů, včetně IntelliSense s návrhy názvů tabulek a sloupců z připojené databáze.

  3. Vyberte Spustit buňku (tlačítko přehrát vlevo od buňky) a spusťte dotaz.

  4. Výsledky se zobrazí přímo pod buňkou v bohaté datové mřížce.

Pokud chcete postupně spouštět všechny buňky v poznámkovém bloku, vyberte možnost Spustit vše na panelu nástrojů poznámkového bloku.

Návod

Stisknutím kláves Ctrl+Enter (Windows a Linux) nebo Cmd+Enter (macOS) spusťte aktuální buňku a zůstaňte na ní. Stisknutím klávesy Shift+Enter spusťte aktuální buňku a přejděte na další buňku.

Výsledky dotazu

Výsledky dotazů v SQL notebooků poskytují stejnou komplexní zkušenost s datovou mřížkou jako ve standardním editoru dotazů:

  • Řazení: Výběrem záhlaví sloupce se seřadíte výsledky vzestupně nebo sestupně.
  • Filtrování: Pomocí ikony filtru v záhlavích sloupců můžete filtrovat výsledná data.
  • Výběr buňky: Výběr jednotlivých buněk nebo oblastí buněk v mřížce výsledků
  • Zvýraznění hodnoty null: NULL hodnoty jsou vizuálně zvýrazněny v mřížce výsledků pro snadnou identifikaci.
  • Možnosti kopírování: Po kliknutí pravým tlačítkem myši na vybrané buňky se dostanete k možnostem Kopírovat, Kopírovat se záhlavími a Vybrat vše .

Přidání buněk Markdownu

Pomocí buněk Markdownu můžete vedle buněk kódu SQL přidat formátovaný text, nadpisy, seznamy a odkazy. Můžete je použít k dokumentování dotazů, vysvětlení obchodní logiky nebo přidání poznámek k očekávaným výsledkům.

  1. Pokud chcete přidat novou textovou buňku, vyberte na panelu nástrojů poznámkového bloku + Markdown .

  2. Zadejte obsah Markdownu. Při psaní se zobrazí náhled.

  3. Kliknutím mimo buňku zobrazíte text Markdownu.

Znovu vyberte buňku a vraťte se do režimu úprav.

Použití více jader

Rozšíření MSSQL poskytuje jádro SQL jako standardní součást. Poznámkové bloky můžete rozšířit o více jazykových jader instalací rozšíření Jupyter, které spojuje podporu Pythonu a dalších jader. Dotazy na data SQL můžete kombinovat se zpracováním dat Pythonu a buňkami vizualizace ve stejném poznámkovém bloku.

Integrace GitHub Copilotu

GitHub Copilot spolupracuje s poznámkovými bloky SQL, které vám pomůžou psát dotazy a generovat poznámkové bloky. Když nainstalujete rozšíření GitHub Copilot, získáte:

  • Vložené návrhy: Při psaní do buněk kódu SQL navrhuje GitHub Copilot dokončování dotazů na základě kontextu databáze a okolních buněk Markdownu.

  • Vytváření notebooků řízených chatem: Pomocí GitHub Copilot Chatu můžete vygenerovat kompletní notebooky se střídajícími se Markdown a SQL buňkami. Popište analýzu, kterou chcete provést, a GitHub Copilot vytvoří úplnou strukturu poznámkového bloku.

Můžete například otevřít GitHub Copilot Chat a použít výzvu, například:

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 vygeneruje buňky dokumentace k Jazyku Markdown a buňky kódu T-SQL, které pak můžete spustit jednotlivě nebo všechny najednou pomocí příkazu Spustit vše.

Přepínání databází

Přepnutí na jinou databázi ve stejném připojení k serveru:

  1. Vyberte název databáze zobrazený v oblasti stavu připojení poznámkového bloku.

  2. V rozevíracím seznamu vyberte jinou databázi.

Všechna následná spuštění buněk používají nově vybranou databázi.

Poznámka:

Chcete-li změnit server, musíte změnit profil připojení notebooku. Zvažte vytvoření samostatného poznámkového bloku pro každý server, se kterým potřebujete pracovat.

Omezení

Připojení k jednomu serveru na poznámkový blok: Každý poznámkový blok se v současné době připojuje k jedné instanci SQL Serveru. Na daném serveru můžete přepínat databáze, ale nemůžete se připojit k druhému serveru ve stejném poznámkovém bloku.

Názory a podpora

Pokud máte nápady, zpětnou vazbu nebo chcete zapojit komunitu, připojte se k diskuzi na adrese https://aka.ms/vscode-mssql-discussions. Pokud chcete nahlásit chybu, navštivte https://aka.ms/vscode-mssql-bugstránku . Pokud chcete požádat o novou funkci, přejděte na https://aka.ms/vscode-mssql-feature-request.

Související obsah

  • Last updated on