Visual Studio Code 的 MSSQL 擴充套件中的 SQL 筆記本，提供基於筆記本的 SQL 開發，使用原生的 Visual Studio Code Jupyter 筆記本。 你可以將互動式 SQL 查詢執行與 Markdown 文件儲存格結合，建立可執行的查詢集合、文件資料庫操作，並共享可重現的分析。
小提示
SQL Notebooks 目前處於預覽階段，可能會根據回饋做出調整。 歡迎加入 GitHub Discussions 社群，分享想法或回報問題。
Features
SQL Notebooks 提供以下功能：
在筆記本程式碼格中互動式執行 T-SQL 查詢，每個格下方會顯示內嵌結果。
使用原生的 Visual Studio Code Jupyter 筆記本格式（
.ipynb檔案），以完全相容現有筆記本工具。以豐富的資料網格查看查詢結果，具備排序、篩選、儲存格選擇、空值高亮及複製選項（包括帶有標頭的複製）。
用 IntelliSense 撰寫 SQL，並根據你目前的資料庫連線，提供資料表和欄位名稱建議。
在 SQL 程式碼儲存格旁加入 Markdown 文字儲存格，用以記錄查詢、註解結果並建立敘事式工作流程。
將每台筆記本連接到 SQL Server 實例，並在同一伺服器上的資料庫間切換。
可以單獨運行細胞，或依序執行所有細胞。
使用 GitHub Copilot 在程式碼單元中提供即時查詢建議，並透過聊天驅動的筆記本創作功能，從自然語言描述生成完整的筆記本。
透過安裝 Jupyter 擴充功能，將 SQL 儲存格與其他語言核心（如 Python）合併在同一本筆記本中。
將筆記本匯出並分享為
.ipynb檔案，讓其他人可以在 Visual Studio Code 或任何與 Jupyter 相容的環境中開啟。
先決條件
在使用 SQL 筆記本之前，請確保以下需求已達成：
已安裝 Visual Studio Code 的 MSSQL 擴充功能。 關於安裝步驟，請參閱 Visual Studio Code 的 MSSQL 擴充功能 概述。
透過 MSSQL 擴充功能建立主動式資料庫連線。 關於連接步驟，請參見 快速入門：使用 Visual Studio Code 的 MSSQL 擴充功能連接並查詢資料庫。
（可選）若要在 Visual Studio Code 中的同一本筆記本中使用其他核心（例如 Python 和 SQL），可以使用 Jupyter 擴充功能。
建立 SQL 筆記本
你可以用幾種方式建立新的 SQL 筆記本：
打開 指令面板 （Windows 和 Linux 為 Ctrl+Shift+P，macOS 為 Cmd+Shift+P ），輸入
New Notebook，並選擇該指令。到 檔案 選單，選擇 新檔案，然後選擇 Jupyter 筆記本類型。
在 MSSQL 擴充套件的 物件總管 中右鍵點擊資料庫，然後從右鍵選單選擇 新筆記本 。
當你建立新筆記本時，選擇 MSSQL 核心以啟用 T-SQL 在程式碼區執行。
連線至資料庫
每個 SQL 筆記本都需要一個主動的資料庫連線來執行查詢。 當你用 MSSQL 核心開啟筆記本時，擴充功能會提示你選擇連線設定檔或建立新設定檔。
這很重要
每台筆記型電腦支援每個核心的單一伺服器連線。 你可以連接一個 SQL Server 實例並在該伺服器上的資料庫間切換，但無法在同一個筆記本內連接多個伺服器。 如果要用不同的伺服器，可以建立一個獨立的筆記本或更換該筆記本的連線。
撰寫並執行 SQL 儲存格
SQL 程式碼單元讓你能在筆記本內互動式地撰寫並執行 T-SQL 查詢。
在筆記本工具列中選擇 + Code 以新增一個程式碼儲存格。
在儲存格中輸入你的 T-SQL 查詢。 該儲存格提供與標準查詢編輯器相同的 SQL 編輯體驗，包括 IntelliSense，並可從連接的資料庫中提供資料表與欄位名稱建議。
選擇 執行儲存格 （儲存格左側的播放按鈕）來執行查詢。
結果會直接顯示在儲存格下方的豐富資料網格中。
要依序執行筆記本中的所有儲存格，請在筆記本工具列中選擇 「全部執行 」。
小提示
使用 Ctrl+Enter （Windows 和 Linux）或 Cmd+Enter （macOS）來執行當前儲存格並保持在該儲存格上。 使用 Shift Enter+ 鍵執行當前儲存格並繼續到下一個儲存格。
查詢結果
SQL 筆記本中的查詢結果提供與標準查詢編輯器相同的豐富資料網格體驗：
- 排序：選擇欄位標頭以排序結果的升序或降序。
- 篩選：使用欄位標頭上的篩選圖示來篩選結果資料。
- 格子選擇：在結果網格中選擇單一格子或範圍。
-
空標示：
NULL數值會在結果網格中視覺化標示，方便辨識。 - 複製選項：右鍵點擊選取的儲存格以進入 「複製」、「 帶標頭複製」和 「全部選取 選項」。
新增 Markdown 儲存格
你可以使用 Markdown 儲存格，在 SQL 程式碼儲存格旁邊加入格式化文字、標題、清單和連結。 用它們來記錄你的查詢、解釋商業邏輯，或是對預期結果的註解。
在筆記本工具列中選擇 + Markdown 來新增文字儲存格。
輸入你的 Markdown 內容。 你打字時會顯示預覽畫面。
選擇儲存格外以呈現 Markdown 文字。
再次選取儲存格以返回編輯模式。
使用多個核心
MSSQL 擴充套件提供現成可用的 SQL 核心。 你可以透過安裝 Jupyter 擴充程式來擴展筆記本功能，該擴充程式支援 Python 及其他語言核心。 你可以在同一本筆記本中結合 SQL 資料查詢與 Python 的資料處理及視覺化儲存格。
GitHub Copilot 整合
GitHub Copilot 支援 SQL 筆記本，幫助你撰寫查詢和產生筆記本。 當你安裝 GitHub Copilot 擴充功能時，你會得到：
內嵌建議：當你輸入 SQL 程式碼儲存格時，GitHub Copilot 會根據你的資料庫上下文及周圍的 Markdown 儲存格建議查詢完成。
以聊天為驅動的筆記本創作：使用 GitHub Copilot Chat 生成完整筆記本，交替使用 Markdown 與 SQL 儲存格。 描述你想做的分析，GitHub Copilot 會建立完整的筆記本結構。
例如，你可以打開 GitHub Copilot Chat，並使用如下提示：
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 會產生 Markdown 文件儲存格和 T-SQL 程式碼儲存格，你可以用 Run All 單獨或一次全部執行。
切換資料庫
在同一伺服器連線內切換到不同資料庫：
選擇筆記本連接狀態區顯示的資料庫名稱。
從下拉選單中選擇不同的資料庫。
所有後續的儲存格執行都會使用新選取的資料庫。
備註
要切換到其他伺服器，你需要更改筆記本的連線設定。 考慮為每個需要使用的伺服器建立一個獨立的筆記本。
局限性
每台筆記型電腦的單一伺服器連線：目前，每台筆記型電腦連接一個 SQL Server 實例。 你可以在那台伺服器上切換資料庫，但無法在同一台筆記本內連接到第二台伺服器。
意見反應與支援
如果您有想法、反饋或想與社區互動，請加入討論 https://aka.ms/vscode-mssql-discussions。 若要回報錯誤，請造訪 https://aka.ms/vscode-mssql-bug。 若要要求新功能，請移至 https://aka.ms/vscode-mssql-feature-request。