适用于 Visual Studio Code 的 PostgreSQL 扩展

适用于 Visual Studio Code （ms-ossdata.vscode-pgsql） 的 PostgreSQL 扩展将数据库开发工具直接引入编辑器中。 可以连接到本地、本地或云提供的 PostgreSQL 服务器、使用 IntelliSense 编写查询、浏览数据库对象、可视化查询计划和架构，以及管理Azure Database for PostgreSQL灵活的服务器资源，所有这些都无需离开 VS Code。 该扩展还可与 AI 助手集成，用于 AI 辅助的查询编写、分析和智能体驱动的工作流。

开始

如果不熟悉扩展，请从以下指南之一开始：

安装扩展

1. 打开Visual Studio代码。
2. 打开扩展视图（Ctrl+Shift+X，或在 macOS 上按 Cmd+Shift+X）。
3. 搜索 postgresql。
4. 通过Microsoft选择 PostgreSQL，然后选择“安装”。

主要功能

以下部分汇总了每个主要功能区域。 选择每个部分末尾的链接以获取完整文章。

连接对话框

连接对话框将你连接到本地、本地和云提供的 PostgreSQL 服务器，并提供对 Microsoft Entra ID 和 AWS IAM（RDS/Aurora）的集成身份验证支持。 单独输入连接参数、粘贴连接字符串，或浏览你的 Azure 订阅来查找 Azure Database for PostgreSQL 灵活服务器和 Azure HorizonDB（预览版）集群。

• 三种输入模式：参数，用于输入主机、端口、数据库和用户名等单个值；连接字符串，用于输入完整的连接字符串；或 浏览 Azure，以浏览你的 Azure 资产并选择具有 PostgreSQL 终结点的资源。
• 已保存的连接和最近连接：保存的配置文件显示在 “连接” 列表中，以便快速重复使用;最近使用的连接始终可用。
• 服务器组：使用颜色编码将连接组织到命名组中，以快速识别 连接 树中的连接。

有关详细信息，请参阅 “连接”和“标识 ”和 “高级连接”选项。

对象资源管理器

对象资源管理器提供连接的 PostgreSQL 服务器的可导航树视图。 展开服务器、数据库和架构以检查表、视图、函数、序列、类型、扩展、角色、表空间和事件触发器。

• 搜索：使用内置搜索在所有受支持的对象类型中按名称查找对象。
• 脚本：右键单击在查询编辑器中打开的任何对象以生成SELECT、CREATE、ALTER或DROPEXECUTE脚本。
• 深度刷新：刷新任何节点，以递归更新所有已展开的后代节点，从而在无需断开连接的情况下反映架构变更。

有关详细信息，请参阅 对象资源管理器。

查询编辑器和 IntelliSense

查询编辑器为 PostgreSQL SQL 提供了丰富的编辑图面。 IntelliSense 为表名、列名、函数、架构、关键字和 JOIN 子句提供基于上下文的自动补全。

• 运行查询 和 运行当前语句：运行完整的编辑器内容，或仅运行游标处的语句。
• 代码片段：插入常见的 SQL 模式，例如 CREATE TABLE， INSERT和 SELECT。
• 查询历史记录：访问以前从命令面板运行查询以重新运行或修改查询。

有关详细信息，请参阅 查询编辑器和 IntelliSense。

查询结果

结果显示在编辑器下方的 PostgreSQL 查询结果 面板中。 结果网格支持排序、筛选和列大小调整。

• 导出：将结果保存到 CSV、JSON 或Excel。
• 图表可视化：将结果可视化为折线图、条形图、饼图或散点图。
• 图形视图：Apache AGE 图形查询结果自动切换到节点和边缘视图。
• “消息”选项卡：查看行计数、执行时间和服务器消息。

有关详细信息，请参阅 查询编辑器和 IntelliSense。

查询计划可视化工具

查询计划可视化工具以多种交互格式显示 EXPLAIN 输出，以便可以识别性能瓶颈。

• 四种视图：树视图、Icicle 视图、表视图和源视图。
• 指标：检查每个节点的成本估算、实际行计数、执行时间和缓冲区使用情况。
• 导入计划：可视化保存的计划文件或编辑器内容，而无需实时数据库连接。
• Copilot 分析：选择“使用 Copilot 分析”（或在 Cursor 中选择“使用 AI 分析”），以获取 AI 生成的计划说明。

有关详细信息，请参阅 查询计划可视化工具。

架构可视化工具

架构可视化工具生成交互式实体关系图。 表以可拖动节点的形式显示，节点内列出了各列，外键关系则显示为连接边。

• 颜色编码的架构：每个架构接收不同的颜色，以便快速识别。
• 图例切换：显示或隐藏架构图例以最大化关系图空间。

有关详细信息，请参阅 架构可视化工具。

服务器仪表板

服务器仪表板显示任何连接的服务器的连接属性、服务器版本和 SSL 状态。 对于 Azure Database for PostgreSQL 灵活服务器，还会显示 Azure Monitor 指标。 通过“调查”选项卡，可以深入了解服务器活动的特定区域。

• 概述：按类别监视 CPU、内存、存储、连接、IOPS 和其他指标。
• 查询：查看按执行时间、调用计数或其他指标排名靠前的 SQL 语句，并向下钻取到单个查询详细信息。
• 等待：使用排名表和随时间推移的图表分析等待事件。
• 会话：查看活动会话、阻塞树和锁活动。
• 工具栏操作：连接、断开连接、打开新的查询编辑器、启动架构可视化工具、打开 AI 聊天，或从仪表板工具栏启动Azure管理操作。

有关详细信息，请参阅 服务器仪表板。

Azure服务器管理

在不离开 VS Code 的情况下管理Azure Database for PostgreSQL灵活的服务器资源。

• 启动、停止和重启：从 连接 树或仪表板控制服务器生命周期。
• 防火墙规则：查看和更新网络访问规则。
• 参数：浏览和修改参数。
• 克隆服务器：复制现有服务器配置。

有关详细信息，请参阅Azure服务器管理。

服务器创建

直接从 VS Code 预配新的 PostgreSQL 服务器。

• Docker：在 Docker 容器中创建本地 PostgreSQL 服务器，用于开发和测试。
• Azure Database for PostgreSQL 灵活服务器：逐步完成引导式设置，配置区域、计算层级、存储和身份验证。
• Azure HorizonDB （预览版）：使用可配置的 vCore 和可选的 AI 功能预配云原生高度可缩放的 PostgreSQL 群集。

有关详细信息，请参阅 创建 PostgreSQL 服务器。

Copilot集成

该扩展可与在聊天、编辑器操作和多步骤工具工作流中使用的 AI 助手集成。

• @pgsql聊天参与者：在 GitHub Copilot 对话助手 面板中询问有关数据库的自然语言问题、生成查询或获取 PostgreSQL 概念方面的帮助。 仅限于 Visual Studio Code。 详情请参阅 @pgsql chat participant。
• 编辑器操作：在编辑器中右键单击 SQL 以解释查询、重写查询以进行优化，或者从 AI 查询操作 子菜单分析其执行计划。 在 Visual Studio Code 和 Cursor 中均可用。
• 代理模式：AI 代理直接调用 PostgreSQL 工具，将 AI 推理与实时数据库操作相结合。 在 Visual Studio Code 和 Cursor 中均可用。 有关详细信息，请参阅 代理模式。

有关所有 AI 功能的概述，请参阅Copilot集成。

MCP 服务器

该扩展注册了一个模型上下文协议（MCP）服务器，向受支持的 AI 宿主提供 PostgreSQL 工具，包括连接管理、架构浏览、查询执行和查询计划可视化。 外部 AI 工具可以通过此注册以编程方式与 PostgreSQL 连接进行交互。

有关详细信息，请参阅 MCP 服务器。

在终端中使用 psql

打开一个已连接到连接树中任意数据库的psql终端会话，或直接从编辑器上下文菜单通过psql运行.sql文件。 这使你能够完全访问原生 psql 功能，例如 \ 元命令、COPY 以及交互式脚本。

有关详细信息，请参阅 终端中的“使用 psql”。

Oracle 到 PostgreSQL 的迁移

AI 辅助迁移工作流可帮助你将 Oracle 数据库架构和对象转换为与 PostgreSQL 兼容的 SQL。

• 引导迁移：连接到 Oracle 源，选择要迁移的对象，并查看转换后的输出。
• AI 辅助转换：Microsoft Foundry 模型将 Oracle 特定的语法、数据类型和过程代码转换为 PostgreSQL 等效项。

有关详细信息，请参阅 Oracle 到 PostgreSQL 的迁移。

受支持的操作系统

反馈和支持

若要报告 bug 或请求功能，请在 vscode-pgsql GitHub 存储库上提出问题。

相关内容

• 快速入门：连接和查询 PostgreSQL
• 连接和标识
• 查询编辑器和 IntelliSense
• Copilot集成