適用於 Visual Studio Code 與 Cursor 的 PostgreSQL 擴充功能

Visual Studio Codems-ossdata.vscode-pgsql 的 PostgreSQL 擴充功能()直接將資料庫開發工具帶入你的編輯器。 你可以連接本地、本地或雲端提供的 PostgreSQL 伺服器,使用 IntelliSense 撰寫查詢,探索資料庫物件,視覺化查詢計畫與結構,並管理 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器資源,全部皆不離開編輯器。 該擴充功能也與 AI 助理整合,可用於 AI 輔助查詢撰寫、分析及由代理驅動的工作流程。

Note

延伸部分也在 Cursor 運行。 PostgreSQL 的 AI 功能在兩個編輯器中均支援,並遵循各自編輯器的原生 AI 體驗:Visual Studio Code 包含@pgsql聊天參與者與代理模式及 MCP 伺服器註冊,而游標則使用 Connect AI(代理模式)或 MCP 伺服器註冊。

開始

如果你是擴充功能新手,建議先從以下指南開始:

Goal Guide
執行第一個查詢 快速入門:連線並查詢 PostgreSQL
找到適合你工作的文章 常見工作流程
設定身份、TLS 或已儲存的設定檔 連線與身分

安裝擴充套件

Editor 擴充功能 Marketplace
Visual Studio Code Visual Studio Marketplace
Cursor 開啟 Open VSX Registry
  1. 開啟 Visual Studio Code 或 Cursor。
  2. 開啟 擴充功能 檢視(Ctrl+Shift+X或 Cmd+Shift+X 在 macOS 上)。
  3. 搜尋 postgresql。
  4. 選擇 Microsoft 的 PostgreSQL,然後選擇 安裝。

在游標中,從 Open VSX 登錄檔安裝擴充功能。

Tip

安裝後, 活動列中會出現一個 PostgreSQL 圖示。 選擇它以開啟 PostgreSQL 檢視,管理連線並探索資料庫物件。

關鍵功能

以下章節將總結每個主要特徵區域。 請選擇每個章節末尾的連結以閱讀完整文章。

連線對話方塊

[連線] 對話方塊可讓您連線到本機、內部部署及雲端提供的 PostgreSQL 伺服器,並整合對 Microsoft Entra ID 與 AWS IAM(RDS/Aurora)驗證的支援。 分別輸入連線參數、貼上連線字串,或瀏覽您的 Azure 訂閱,以探索 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器和 Azure HorizonDB(預覽版)叢集。

  • 三種輸入模式:針對個別值(如 host、port、database、username)的 參數;Connection String 用於輸入完整的 連接字串;或瀏覽 Browse Azure 以瀏覽您的 Azure 資產並選擇具有 PostgreSQL 端點的資源。
  • 已儲存與最近連線:已儲存的設定檔會顯示在 連線 清單中,方便快速重複使用;近期使用過的連線隨時可用。
  • 伺服器群組:將連線整理成具名群組,並以色彩編碼在 連線樹狀結構中快速識別連線。

詳情請參閱 「連線與身份 」及 「進階連線選項」。

物件瀏覽器

物件總管提供已連接的 PostgreSQL 伺服器的可瀏覽樹狀檢視圖。 擴充伺服器、資料庫與結構,以檢查資料表、檢視、函式、序列、型別、擴充、角色、表空間及事件觸發器。

  • 搜尋:利用內建搜尋功能,依名稱搜尋所有支援的物件類型。
  • 腳本:以滑鼠右鍵點擊任何物件,即可產生 SELECT、DROP、CREATE、ALTER 或 EXECUTE 腳本,並在查詢編輯器中開啟。
  • 深度刷新:刷新任意節點以遞迴更新所有展開的子節點,反映結構變更且不中斷連線。

詳情請參見 物件瀏覽器。

查詢編輯器與 IntelliSense

查詢編輯器為 PostgreSQL SQL 提供了豐富的編輯介面。 IntelliSense 提供資料表名稱、欄位名稱、函式、結構、關鍵字及連接子句的上下文感知補全功能。

  • 執行查詢 與 執行目前語句:可執行完整編輯器內容,或僅執行游標所在位置的語句。
  • 程式碼片段:插入常見的 SQL 模式,如 CREATE TABLE、 INSERT、 SELECT。
  • 查詢歷史:從命令面板存取先前執行的查詢,以重新執行或修改它們。

詳情請參見 查詢編輯器與 IntelliSense。

查詢結果

結果會出現在編輯器下方的 PostgreSQL 查詢結果 面板中。 結果網格支援排序、篩選及欄位調整大小。

  • 匯出:將結果儲存為 CSV、JSON 或 Excel。
  • 圖表視覺化:將結果視覺化為折線圖、長條圖、圓餅圖或散佈圖。
  • 圖形檢視:Apache AGE 圖形查詢結果會自動切換為節點與邊檢視。
  • 訊息索引標籤:檢視列數、執行時間及伺服器訊息。

詳情請參見 查詢編輯器與 IntelliSense。

查詢計畫視覺化工具

查詢計畫視覺化工具以 EXPLAIN 多種互動格式呈現輸出,幫助你辨識效能瓶頸。

  • 四種檢視:樹狀檢視、冰柱檢視、表格檢視和來源檢視。
  • 指標:檢視成本估算、實際資料列數、執行時間及每個節點的緩衝區使用量。
  • 匯入計畫:在沒有即時資料庫連線的情況下,視覺化已儲存的計畫檔案或編輯器內容。
  • Copilot 分析:選擇 「使用 Copilot 分析」(或在 Cursor 中選擇 「使用 AI 分析」),以獲得 AI 生成的計畫說明。

詳情請參見 查詢計畫視覺化工具。

結構視覺化工具

結構視覺化器會產生互動式實體關係圖。 資料表呈現為可拖曳的節點,欄位列在其中,外鍵關聯則以連接邊的形式顯示。

  • 以顏色區分的結構描述:每個結構描述都會獲得獨特的顏色,方便快速辨識。
  • 圖例切換:顯示或隱藏綱要圖例以最大化圖表空間。

詳情請參見 Schema visualizer。

伺服器儀表板

伺服器儀表板會顯示任何連接伺服器的連線屬性、伺服器版本和 SSL 狀態。 對於 適用於 PostgreSQL 的 Azure 資料庫 flexible servers,它也會顯示 Azure 監視器 的指標。 調查分頁讓你能深入伺服器活動的特定區域。

  • 概覽:監控 CPU、記憶體、儲存空間、連線、IOPS 及其他按類別分組的指標。
  • 查詢:檢視依執行時間、呼叫次數或其他指標排序的熱門 SQL 語句,並深入檢視個別查詢細節。
  • 等待時間:使用排名表與加時圖表分析等待事件。
  • 工作階段:檢查正在進行的工作階段、封鎖樹狀結構,以及鎖定活動情形。
  • 工具列操作:連線、斷開、開啟新的查詢編輯器、啟動結構視覺化工具、開啟 AI 聊天,或從儀表板工具列啟動 Azure 管理操作。

詳情請參閱 伺服器儀表板。

Azure 伺服器管理

管理 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器資源,無需離開 VS Code。

  • 啟動、停止與重新啟動:從 連線 樹狀結構或儀表板控制伺服器生命週期。
  • 防火牆規則:檢視並更新網路存取規則。
  • 參數:瀏覽並修改參數。
  • 複製伺服器:複製現有伺服器設定。

詳情請參見 Azure 伺服器管理。

伺服器建立

直接從 VS Code 配置新的 PostgreSQL 伺服器。

  • Docker:在 Docker 容器中建立本地 PostgreSQL 伺服器,用於開發與測試。
  • 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器:引導您完成設定,設定區域、運算層級、儲存體與驗證。
  • Azure HorizonDB(預覽版):配置一個雲端原生、高度可擴展的 PostgreSQL 叢集,具備可配置的 vCore 及可選的 AI 功能。

詳情請參見 建立 PostgreSQL 伺服器。

Copilot 整合

該擴充功能能與 AI 助理整合,涵蓋聊天、編輯器操作及多步驟工具工作流程。

  • @pgsql聊天室參與者:在 GitHub Copilot Chat 面板中提出關於資料庫的自然語言問題、產生查詢,或尋求 PostgreSQL 概念的協助。 只支援 Visual Studio Code。 詳情請參見 @pgsql聊天參與者。
  • 編輯器操作:在編輯器中右鍵點擊 SQL 以解釋查詢、重寫查詢以進行最佳化,或從 AI 查詢動作 子選單分析執行計畫。 可於 Visual Studio Code 和 Cursor 中使用。
  • 代理模式:AI 代理直接調用 PostgreSQL 工具,結合 AI 推理與即時資料庫操作。 可於 Visual Studio Code 和 Cursor 中使用。 詳情請參見 特工模式。

欲了解所有 AI 功能的概述,請參見 Copilot 整合。

MCP 伺服器

該擴充套件註冊了一個模型情境協定(MCP)伺服器,該伺服器向支援的 AI 主機開放 PostgreSQL 工具,包括連線管理、結構探索、查詢執行及查詢計畫視覺化。 外部 AI 工具可以透過此註冊程式化與你的 PostgreSQL 連結互動。

詳情請參見 MCP 伺服器。

在終端機裡使用 psql

開啟已連接到任何psql 樹狀結構中的終端機工作階段,或直接從編輯器的上下文選單透過.sql執行psql檔案。 這讓你能完整使用原生 psql 功能,如 \ 元指令(meta-commands)和 COPY互動腳本。

詳情請參見 「在終端機中使用 psql」。

Oracle 遷移至 PostgreSQL

AI 輔助的遷移工作流程協助您將 Oracle 資料庫架構與物件轉換為相容 PostgreSQL 的 SQL。

  • 引導式遷移:連接至 Oracle 來源,選擇要遷移的物件,並檢視轉換後的輸出。
  • AI 輔助轉換:Microsoft Foundry 模型將 Oracle 專屬語法、資料型態及程序程式碼轉換為 PostgreSQL 對應項目。

詳情請參見 從 Oracle 遷移至 PostgreSQL。

支援的作業系統

作業系統 Architecture 注意事項
Windows 作業系統 x64、Arm64 Arm64 需要 Windows 11。
macOS x64、Arm64 -
Linux x64、Arm64 需要 glibc 2.35 或更高版本。

意見反應與支援

若要回報錯誤或請求功能,請在 vscode-pgsql GitHub 倉庫提出問題。