Megosztás a következőn keresztül:


SQL-jegyzetfüzetek (előzetes verzió)

A Visual Studio Code MSSQL-bővítményében található SQL Notebookok natív Visual Studio Code Jupyter-jegyzetfüzetek használatával nyújtanak jegyzetfüzetalapú SQL-fejlesztést. Az interaktív SQL-lekérdezések végrehajtását a Markdown dokumentációs celláival kombinálva futtatható lekérdezésgyűjteményeket, dokumentumadatbázis-műveleteket és reprodukálható elemzéseket hozhat létre.

Jótanács

Az SQL Notebooks jelenleg előzetes verzióban érhető el, és a visszajelzések alapján változhat. Csatlakozzon a közösséghez a GitHub-vitafórumon , és ossza meg ötleteit vagy jelentési problémáit.

Features

Az SQL Notebooks a következő képességeket kínálja:

  • T-SQL-lekérdezések interaktív végrehajtása a jegyzetfüzet kódcelláiban az egyes cellák alatt megjelenő beágyazott eredményekkel.

  • Használja a natív Visual Studio Code Jupyter-jegyzetfüzetformátumot (.ipynb fájlokat) a meglévő jegyzetfüzet-eszközökkel való teljes kompatibilitás érdekében.

  • A lekérdezés eredményeinek megtekintése gazdag adatrácsban rendezéssel, szűréssel, cellakijelöléssel, null érték kiemelésével és másolási lehetőségekkel (beleértve a fejléceket tartalmazó másolást is).

  • Sql írása az IntelliSense használatával, beleértve a tábla- és oszlopnév-javaslatokat az aktív adatbázis-kapcsolat alapján.

  • Markdown-szövegcellákat adhat hozzá az SQL-kódcellákhoz a lekérdezések dokumentálásához, az eredmények megjegyzéséhez és narratív munkafolyamatok létrehozásához.

  • Csatlakoztassa az egyes jegyzetfüzeteket egy SQL Server-példányhoz, és váltson az ugyanazon a kiszolgálón található adatbázisok között.

  • Végezze el a cellákat külön-külön, vagy hajtsa végre az összes cellát sorrendben.

  • A GitHub Copilot használatával beágyazott lekérdezési javaslatokat tehet a kódcellákban, és csevegőalapú jegyzetfüzeteket hozhat létre természetes nyelvi leírásokból.

  • Az SQL-cellák és más nyelvi kernelek (például Python) kombinálása ugyanabban a jegyzetfüzetben a Jupyter-bővítmény telepítésével.

  • Exportálhatja és megoszthatja a jegyzetfüzeteket fájlként .ipynb , amelyeket mások megnyithatnak a Visual Studio Code-ban vagy bármely Jupyter-kompatibilis környezetben.

Előfeltételek

Az SQL Notebookok használata előtt győződjön meg arról, hogy a következő követelmények teljesülnek:

SQL-jegyzetfüzet létrehozása

Új SQL-jegyzetfüzetet többféleképpen is létrehozhat:

  • Nyissa meg a parancskatalógust (Windows és Linux rendszeren a Ctrl+Shift+P , macOS rendszeren pedig a Cmd+Shift+P ), írja be New Notebooka parancsot, és válassza ki a parancsot.

  • Nyissa meg a Fájl menüt, és válassza az Új fájl lehetőséget, majd válassza a Jupyter Notebook típust.

  • Kattintson a jobb gombbal egy adatbázisra az MSSQL-bővítmény Objektumkezelőjében , és válassza az Új jegyzetfüzet lehetőséget a helyi menüből.

Új jegyzetfüzet létrehozásakor válassza ki az MSSQL-kernelt a T-SQL-végrehajtás engedélyezéséhez a kódcellákban.

Kapcsolódás adatbázishoz

A lekérdezések futtatásához minden SQL-jegyzetfüzethez aktív adatbázis-kapcsolat szükséges. Amikor megnyit egy jegyzetfüzetet az MSSQL-kernellel, a bővítmény megkéri, hogy válasszon ki egy kapcsolati profilt, vagy hozzon létre egy újat.

Fontos

Minden jegyzetfüzet kernelenként egyetlen kiszolgálókapcsolatot támogat. Csatlakozhat egy SQL Server-példányhoz, és válthat az adott kiszolgálón található adatbázisok között, de nem csatlakozhat több kiszolgálóhoz ugyanazon a jegyzetfüzeten belül. Ha másik kiszolgálóval szeretne dolgozni, hozzon létre egy külön jegyzetfüzetet, vagy módosítsa a jegyzetfüzet kapcsolatát.

SQL-cellák írása és futtatása

Az SQL-kódcellák segítségével interaktívan írhat és hajthat végre T-SQL-lekérdezéseket a jegyzetfüzetben.

  1. Új kódcella hozzáadásához válassza a +Kód lehetőséget a jegyzetfüzet eszköztárában.

  2. Írja be a T-SQL-lekérdezést a cellába. A cella ugyanazt az SQL-szerkesztési felületet biztosítja, mint egy szabványos lekérdezésszerkesztő, beleértve az IntelliSense-t is, amely táblázat- és oszlopnévjavaslatokat tartalmaz a csatlakoztatott adatbázisból.

  3. A lekérdezés végrehajtásához válassza a Cella futtatása (a cella bal oldalán található lejátszás gomb) lehetőséget.

  4. Az eredmények közvetlenül a cella alatt jelennek meg egy gazdag adatrácsban.

A jegyzetfüzet összes cellájának egymás utáni futtatásához válassza az Összes futtatása lehetőséget a jegyzetfüzet eszköztárán.

Jótanács

A Ctrl+Enter (Windows és Linux) vagy a Cmd+Enter (macOS) billentyűkombinációval futtassa az aktuális cellát, és maradjon rajta. A Shift+Enter használatával futtassa az aktuális cellát, és lépjen tovább a következőre.

Lekérdezés eredményei

Az SQL-jegyzetfüzetekben található lekérdezési eredmények ugyanazt a gazdag adatrács-élményt biztosítják, amely a standard lekérdezésszerkesztőben érhető el:

  • Rendezés: Válasszon ki egy oszlopfejlécet az eredmények növekvő vagy csökkenő rendezéséhez.
  • Szűrés: Az oszlopfejlécek szűrőikonjának használatával szűrheti az eredményadatokat.
  • Cellakijelölés: Jelölje ki az egyes cellákat vagy cellatartományokat az eredményrácson.
  • Nullkiemelés: NULL az értékek vizuálisan ki vannak emelve az eredményrácson az egyszerű azonosítás érdekében.
  • Másolási beállítások: Kattintson a jobb gombbal a kijelölt cellákra a Másolás, a Másolás fejlécekkel és az Összes beállítás kiválasztásához .

Adjon hozzá Markdown cellákat

Markdown-cellákkal formázott szöveget, címsorokat, listákat és hivatkozásokat adhat hozzá az SQL-kódcellákhoz. Ezekkel dokumentálhatja a lekérdezéseket, elmagyarázhatja az üzleti logikát, vagy megjegyzéseket fűzhet a várt eredményekhez.

  1. Új szövegcella hozzáadásához válassza a + Markdown lehetőséget a jegyzetfüzet eszköztárában.

  2. Gépelje be a Markdown tartalmát. Beíráskor megjelenik egy előnézet.

  3. A cellán kívül kattintva jelenítse meg a Markdown szöveget.

Jelölje ki ismét a cellát a szerkesztési módba való visszatéréshez.

Több kernel használata

Az MSSQL-bővítmény az SQL-kernelt a dobozon kívülre biztosítja. A jegyzetfüzeteket további nyelvi kernelekkel bővítheti a Jupyter bővítmény telepítésével, amely csomagban támogatja a Pythont és más kerneleket. Az SQL-adat lekérdezéseket kombinálhatja a Python-adatfeldolgozási és vizualizációs cellákkal ugyanabban a jegyzetfüzetben.

GitHub Copilot-integráció

A GitHub Copilot az SQL Notebookokkal együttműködve segít a lekérdezések írásában és a jegyzetfüzetek létrehozásában. A GitHub Copilot bővítmény telepítésekor a következőt kapja:

  • Beágyazott javaslatok: Az SQL-kódcellák beírása során a GitHub Copilot az adatbázis-környezet és a környező Markdown-cellák alapján javasolja a lekérdezések befejezését.

  • Csevegésalapú jegyzetfüzet-létrehozás: A GitHub Copilot Chat használatával teljes jegyzetfüzeteket hozhat létre váltakozó Markdown- és SQL-cellákkal. Írja le a végrehajtani kívánt elemzést, és a GitHub Copilot létrehozza a teljes jegyzetfüzet-struktúrát.

Megnyithatja például a GitHub Copilot-csevegést, és a következőhöz hasonló parancssort használhat:

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.

A GitHub Copilot létrehozza a Markdown-dokumentációs cellákat és a T-SQL-kódcellákat, amelyeket ezután egyenként vagy egyszerre futtathat az Összes futtatása funkcióval.

Adatbázisok váltása

Ha másik adatbázisra szeretne váltani ugyanazon a kiszolgálókapcsolaton belül:

  1. Válassza ki a jegyzetfüzet kapcsolati állapotterületén megjelenő adatbázisnevet.

  2. Válasszon egy másik adatbázist a legördülő listából.

Az összes későbbi cellavégrehajtás az újonnan kiválasztott adatbázist használja.

Megjegyzés:

Ha másik kiszolgálóra szeretne váltani, módosítania kell a jegyzetfüzet kapcsolati profilját. Érdemes lehet külön jegyzetfüzetet létrehozni minden olyan kiszolgálóhoz, amellyel dolgoznia kell.

Korlátozások

Egykiszolgálós kapcsolat jegyzetfüzetenként: Jelenleg minden jegyzetfüzet egy SQL Server-példányhoz csatlakozik. Ezen a kiszolgálón is válthat adatbázisokat, de nem tud csatlakozni egy másik kiszolgálóhoz ugyanazon a jegyzetfüzeten belül.

Visszajelzés és támogatás

Ha vannak ötletei, visszajelzései, vagy szeretne kapcsolatba lépni a közösséggel, csatlakozzon a beszélgetéshez a következő címen https://aka.ms/vscode-mssql-discussions: . Hiba bejelentéséhez látogasson el https://aka.ms/vscode-mssql-bugide. Ha új funkciót szeretne kérni, lépjen a lapra https://aka.ms/vscode-mssql-feature-request.