GitHub Copilot 與 Visual Studio Code 的 MSSQL 擴充套件整合,揭示了多個由人工智慧(AI)協助 SQL 開發的表面。 每個表面都有不同的功能、不同的資料庫架構存取權限,以及不同的理想使用情境。 本文說明了哪個表面處理哪種情境,讓你能為每個任務選擇合適的工具。
重點摘要
-
@mssql聊天參與者、代理模式工具、結構設計器及資料 API 建構器在連接資料庫時皆具備結構感知能力。 - 查詢效能儀表板的聊天動作將查詢與時間範圍上下文交給 查詢存放區 代理程式工具,用於效能調查(預覽)。
-
內嵌補全(在
.sql檔案中輸入時出現的幽靈文字)直接來自 GitHub Copilot 的模型,且看不到你連接的資料庫結構。 - 在撰寫 SQL 時,若想提出符合結構的建議,請在聊天中使用
@mssql聊天參與者,而非內嵌幽靈文字。
GitHub Copilot 一眼就能浮現
| Surface | 由…提供 | 懂得 schema 嗎? | 最適合用於 |
|---|---|---|---|
聊天參與者 (@mssql) |
MSSQL 延伸模組 | 是的(連接資料庫) | 問題、說明、查詢編寫 |
| 代理模式工具 | MSSQL 擴充功能貢獻工具 | 是的(透過工具呼叫) | 多步驟工作流程、委派變更、查詢存放區 調查(預覽版) |
| 查詢效能儀表板聊天 (預覽版) | 儀表板交由代理程式工具管理 | 是的(透過工具呼叫) | 利用所擷取的效能資料調查所選查詢 |
| 規劃模式 | Visual Studio Code | 是的(根據 @mssql 上下文) |
撰寫 SQL 資料定義語言(DDL)前的推理 |
| 斜線指令 | MSSQL 延伸模組 | Yes | 常見任務的結構化提示 |
| 直線完備 | 直接使用 GitHub Copilot 模型 | No | 輸入時顯示的一般預設文字 |
| 使用 GitHub Copilot 的結構描述設計器 | 嵌入於 MSSQL 架構設計器中 | Yes | 視覺結構設計與 AI 協助 |
| 使用 GitHub Copilot 的資料 API 建構器 | 嵌入於 MSSQL 資料 API 建構器中 | Yes | REST、GraphQL 及模型上下文協定(MCP)端點的實體設定 |
聊天室參與者: @mssql
@mssql聊天參與者由 MSSQL 擴充功能貢獻。 當你在 GitHub Copilot Chat 檢視中輸入@mssql時,擴充功能會接收你的提示以及關於你目前資料庫連線的元資料。 該擴展可以:
- 讀取結構資訊(資料表、欄位、關係、儲存程序)
- 在發送給模型的提示中包含結構上下文
- 回傳引用資料庫中真實物件的回應
聊天參與者是獲得 模式感知 AI 協助的主要途徑。 當你在聊天中向 @mssql 發話時,它會支援提問模式和編輯模式的互動。
欲了解情境導向的攻略,請參見快速入門:與@mssql參與者聊天(詢問模式)。
代理模式工具
代理模式讓 GitHub Copilot 能自主規劃並執行工作。 MSSQL 擴充功能提供一組工具(例如 connect、 、 list_databasesrun_query),代理模式可以代表您呼叫。 核准需求依工具而異:查詢存放區 的診斷讀取不會要求確認,而強制或解除強制執行計畫則需要審查與確認。
與聊天參與者(需要明確 @mssql 說明)不同,代理模式會在擴充功能啟用時自動接收 MSSQL 擴充功能的工具。 你可以寫自然語言提示,例如「連接我的 LocalDev 檔案並顯示 AdventureWorks 中的表格」,代理模式則會選擇要調用哪些工具。
代理模式透過其工具具備 結構感知 能力。 每次工具呼叫都會從你連接的資料庫回傳真實資料。
完整工具參考與範例提示,請參見快速入門:使用 GitHub Copilot Agent 模式。
查詢效能儀表板交接(預覽版)
查詢效能儀表板使用 查詢存放區 資料來顯示查詢排名、執行歷史、等待時間、比較及計畫。 它的 聊天 動作並不是像 Schema Designer 或 Data API 建置器那樣獨立的嵌入式聊天管線。 它會以代理模式開啟 GitHub Copilot Chat,並傳送提示,標示所選查詢的伺服器、資料庫、已儲存的連線設定檔、查詢存放區 查詢 ID 及時間範圍。
提示明確引用了 #mssql_query_store_analyze_query。 該工具可擷取查詢文字與執行時統計、計畫統計、執行歷史、等待時間,以及主要儲存計畫的摘要。 提示要求先做簡短評估,接著問下一步要調查什麼,並要求在套用變更前獲得確認。
在代理模式下,Copilot 可以使用額外的 查詢存放區 工具尋找熱門查詢、讀取歷史或等待、摘要計畫,並重新開啟查詢儀表板。 這些工具能擷取擷取的效能證據,而非僅依賴結構上下文、貼上的 SQL 或手動附加的計畫。 現有連線或已儲存的連線設定檔提供目標與認證;資料庫權限仍然適用。
如需操作說明,請參閱「調查 查詢存放區 效能」。 有關可用工具及其運作行為,請參閱 查詢存放區 效能工具。
計畫模式
計畫模式是 Visual Studio Code 的一項功能,讓 GitHub Copilot 在不進行任何變更的情況下,針對請求進行推理。 當你切換到聊天模式到計畫模式時,GitHub Copilot 會產生一份書面計畫(通常儲存為 plan.md),你可以在交給代理模式或 Schema Designer 執行前先檢視。
計畫模式非常適合資料庫設計。 自然語言的產品需求文件會在撰寫任何 SQL DDL 之前,轉化為一個經過縝密推導的資料模型,其中包含資料表、連接表、外鍵的指向以及各項約束。
如需將計畫模式與產品需求文件(PRD)配對的導覽,請參見 快速入門:使用計畫模式以規格驅動的資料庫設計。
行內補全
行內補全是在編輯器中輸入時出現的 預覽文字。 在 .sql 檔案中,這些建議是直接來自 GitHub Copilot 模型。
行內補全 無法查看你連接的資料庫結構。 Visual Studio Code 的內嵌補全應用程式介面(API)實際上是單一提供者:啟用 GitHub Copilot 時,第三方擴充功能(包括 MSSQL 擴充功能)無法提供具備結構感知的幽靈文字。 對於符合結構的 SQL 建議,請改用聊天參與者。@mssql
這是平台行為,不是 MSSQL 擴充功能的限制。 它適用於所有想要貢獻內嵌 SQL 補全的第三方擴充。 如需更深入了解內嵌建議究竟提供哪些功能,請參閱 快速入門:在 SQL 檔案中使用 GitHub Copilot 內嵌建議。
內建 GitHub Copilot 的結構設計器
MSSQL 擴充套件的 Schema Designer 直接將 GitHub Copilot 嵌入其畫布中。 這是與聊天和客服模式 不同的流程 。 Schema Designer 擁有自己的提示基礎架構和套用結構上下文的方式。 你可以請 GitHub Copilot 從選定程式碼建立表格、新增關聯、產生測試資料或匯入外部產物,並即時觀看視覺化圖表更新。
GitHub Copilot 的 Schema Designer 是對結構有感知的,因為它直接在你連接的資料庫上運作。
關於情境驅動範例,請參見快速入門:以視覺化方式設計包含 GitHub Copilot 情境的結構。
內建 GitHub Copilot 的資料 API 建構器
Data API 建構畫布也嵌入了 GitHub Copilot 聊天表板。 你可以用自然語言來設定實體、權限和輸出類型(REST、GraphQL、MCP)。 與 Schema Designer 類似,此表面具備 schema 感知功能,並使用自己的提示管線。
完整工作流程請參閱 資料 API 建構器。
自訂指令適用於各表面
無論你使用哪種表面,GitHub Copilot 都會套用你為專案撰寫的任何自訂指令。 指令檔案(.github/instructions/*.instructions.md)會讓 GitHub Copilot 了解你團隊的慣例,並會注入到每個其 applyTo glob 符合的請求中。
這表示你的命名慣例、檔案範本和資料型態偏好會影響詢問模式、代理模式、計畫模式以及內嵌完成。 關於如何設定,請參考快速入門:使用自訂指令將 GitHub Copilot 與你的 T-SQL 慣例對齊。
隱私權和資料處理
每個介面都會經由 GitHub Copilot 的隱私保護代理伺服器傳送。 提示和完成圖不會被儲存,也不會用來訓練模型。 詳情請參閱限制與已知問題及 GitHub Copilot 信任中心。
分享您的體驗
為了幫助我們精煉並改進 GitHub Copilot 的 MSSQL 擴充功能,請使用以下 GitHub 議題範本提交您的回饋: GitHub Copilot 回饋
提交意見反應時,請考慮包括:
測試過的情境:請告訴我們你專注於哪些領域,例如結構描述建立、查詢產生、安全性、本地化。
哪些部分效果良好:描述任何感覺順暢、有幫助或超出預期的經驗。
問題或錯誤:包含任何問題、不一致或令人困惑的行為。 螢幕快照或螢幕錄製特別有用。
改進建議:分享改善易用性、擴大覆蓋範圍或強化 GitHub Copilot 回應的建議。