Visual Studio Code 的 PostgreSQL 擴充套件

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

Note

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

開始

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

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

安裝擴充套件

  1. 打開 Visual Studio 程式碼。
  2. 開啟 擴充功能 檢視（Ctrl+Shift+X或 Cmd+Shift+X 在 macOS 上）。
  3. 搜尋 postgresql。
  4. 選擇 Microsoft 的 PostgreSQL，然後選擇 安裝。

Tip

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

關鍵功能

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

連線對話方塊

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

  • 三種輸入模式：參數，用於輸入主機、連接埠、資料庫和使用者名稱等個別值；連線字串，用於輸入完整的連線字串；或 瀏覽 Azure，以瀏覽您的 Azure 資源並選取具有 PostgreSQL 端點的資源。
  • 已儲存與近期連線：已儲存的設定檔會出現在 連線 清單中，方便快速重用;最近使用的連接點隨時可用。
  • 伺服器群組：將連線組織成命名群組並以顏色編碼，以便快速辨識 連線 樹中的連線。

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

物件瀏覽器

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

  • 搜尋：透過內建搜尋功能，依名稱在所有支援的物件類型中尋找物件。
  • 腳本操作：右鍵點擊任意物件即可產生 SELECT、 CREATE、 ALTER、 DROP或 EXECUTE 在查詢編輯器中開啟的腳本。
  • 深度重新整理：重新整理任意節點，以遞迴方式更新所有已展開的子孫節點，在不中斷連線的情況下反映結構描述變更。

詳情請參見 物件瀏覽器。

查詢編輯器與 IntelliSense

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

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

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

查詢結果

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

  • 匯出：將結果儲存為 CSV、JSON 或 Excel。
  • 圖表視覺化：將結果視覺化為線圖、柱狀圖、圓餅圖或散點圖。
  • 圖視圖：Apache AGE 圖查詢結果會自動切換為節點與邊視圖。
  • 訊息分頁：檢視列數、執行時間及伺服器訊息。

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

查詢計畫視覺化工具

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

  • 四種視圖：樹狀視圖、冰柱視圖、表格視圖和來源視圖。
  • 指標：檢查成本估算、實際列數、執行時間及每個節點的緩衝區使用情況。
  • 匯入計畫：無須資料庫即時連線，即可檢視已儲存的計畫檔案或編輯器內容。
  • Copilot 分析：選擇「用 Copilot 分析」（或游標中用 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

在 Connections 樹狀結構中，開啟已連線至任何資料庫的 psql 終端機工作階段，或直接從編輯器的內容選單透過 psql 執行 .sql 檔案。 這讓你能完整使用原生 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 倉庫提出問題。

相關內容

  • Last updated on