GitHub Copilot 如何與 MSSQL 擴充功能相配合

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 回應的建議。