你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

常见工作流

当你知道自己要完成的任务,但还不知道应从哪篇 PostgreSQL 扩展文档或哪个界面开始时,请使用此页面。 如果需要逐个功能浏览,请从适用于 Visual Studio Code 的 PostgreSQL 扩展开始。

选择与任务匹配的工作流

如果你希望... 从这里开始 然后继续...
连接并运行第一个查询 快速入门:连接和查询 PostgreSQL 连接和身份验证查询编辑器和 IntelliSense
探索不熟悉的数据库 对象资源管理器 架构可视化Copilot 集成
排查慢查询 查询编辑器和 IntelliSense 查询计划可视化工具Copilot集成服务器仪表板
管理 Azure Database for PostgreSQL 的灵活服务器 连接和标识 服务器仪表板Azure服务器管理创建 PostgreSQL 服务器
使用 Copilot 或与主机集成的 AI 工作流 Copilot集成 @pgsql聊天参与者代理模式MCP 服务器
使用基于终端的 PostgreSQL 工作流 在终端中使用 psql 查询编辑器和 IntelliSense

建立连接并运行第一个查询

首次安装扩展或验证服务器可访问时,请使用此路径。

  1. 先从 快速入门:连接并查询 PostgreSQL 开始,以最快速完成端到端设置。
  2. 如果需要保存的配置文件、Microsoft Entra ID身份验证、Amazon RDS/Aurora PostgreSQL 的 AWS IAM 身份验证或高级 SSL/TLS 设置,请继续访问连接和标识
  3. 连接正常工作后,移动到 查询编辑器和 IntelliSense 以打开 “新建查询”、“运行语句”和“ 检查 PostgreSQL 查询结果 ”面板中的输出。

探索不熟悉的数据库

在继承现有架构并需要在编写 SQL 之前了解结构时使用此路径。

  1. 对象资源管理器 开始,浏览 连接 树中的服务器、数据库、架构和对象。
  2. 如果需要快速查找特定对象,请使用对象资源管理器中的搜索对象,而不是手动展开树。
  3. 如果需要关系映射,请继续访问 架构可视化工具
  4. 如果您希望具备架构感知能力的 AI 帮助识别相关对象或起草下一条查询,请继续阅读Copilot 集成

分析并优化慢查询

当查询速度缓慢时使用此路径,需要了解 PostgreSQL 为何选择了特定计划,或者想要帮助缩小瓶颈。

  1. 查询编辑器和 IntelliSense 中重现语句。
  2. 打开 查询计划可视化工具 ,以在 树视图表视图Icicle 视图源视图中检查执行计划。
  3. 如果需要 AI 帮助,请使用Copilot集成分析查询性能、以查询为中心的编辑器操作或缓存计划的代理模式分析之间进行选择。
  4. 对于Azure托管的服务器,请打开“服务器”仪表板,将查询结果与 CPU 百分比、IOPS 和连接指标相关联。

管理 Azure Database for PostgreSQL 灵活服务器

如果要监视或管理Azure Database for PostgreSQL灵活服务器,而无需切换到每个步骤的 Azure 门户,请使用此路径。

  1. 连接和身份中设置连接和身份流程。
  2. 选择服务器节点上的 仪表板 以打开 服务器仪表板 并查看服务器详细信息、指标和快速操作。
  3. 继续前往Azure 服务器管理,以配置防火墙规则、参数、备份、日志和 Azure 特定管理。
  4. 需要新环境时,请使用“创建 PostgreSQL 服务器”来预配Azure Database for PostgreSQL灵活服务器或创建基于 Docker 的本地实例。

使用 Copilot 或与主机集成的 AI 工作流

如果想要在单个编辑器命令之外实现架构感知聊天、工具驱动的自动化或主机级 AI 集成,请使用此路径。

  1. Copilot 集成开始,为当前面临的任务选择合适的切入点。
  2. 当你想在 Copilot Ask 模式下进行架构感知聊天时,请转到 @pgsql 聊天参与者
  3. 如果希望Copilot连接、检查架构、运行查询以及完成多步骤数据库任务,请继续执行代理模式
  4. 如果你的主机支持自动 MCP 注册,并且你希望该扩展的 PostgreSQL 工具图面可用,请继续访问 MCP 服务器

使用原生 psql 功能

当你需要交互式终端会话\、元命令、COPY工作流,或在原生psql环境中执行脚本时,请使用此路径。

  1. 终端中的“使用 psql ”开始,从数据库节点打开 “使用 PSQL 进行连接 ”,或使用 PSQL 为保存 .sql 的文件运行运行文件。
  2. 如果你想在编辑器中使用 IntelliSense、可视化结果、图表、查询历史记录和导出选项,请返回查询编辑器和 IntelliSense