数据库代理与 Visual Studio Code 集成,因此您可以配置代理、审核 AI 辅助的性能调查、检查实时服务器状态,并在不离开编辑器的情况下执行手动响应。
Important
适用于 Azure Database for PostgreSQL 灵活服务器的数据库代理目前以有限预览形式在 Visual Studio Code 中提供。 访问权限有限,需要批准。 要请求访问权限, 请填写数据库代理有限预览参与表单。
在采取行动之前,将 AI 生成的诊断、SQL 语句和参数更改与实际服务器进行验证,并遵循组织的审批和变更管理工作流程。
Note
- Azure Database for PostgreSQL 灵活服务器:现已在 Visual Studio Code 中以有限预览形式提供。 Fabric 数据库中心中对 PostgreSQL 数据库代理的支持即将推出。
- Azure SQL 数据库:即将支持 Visual Studio Code。 今天,请使用Database Hub用于 Azure SQL 数据库。
Prerequisites
Important
Azure Database for PostgreSQL 的数据库代理处于有限预览阶段。 在启用此功能之前,必须 通过参与表单请求访问权限 并接收审批。
- 在受支持的有限预览区域(美国中南部、美国西部 3 或瑞典中部)使用 PostgreSQL 16 或更高版本的 Azure Database for PostgreSQL 灵活服务器。
- 安装 Visual Studio Code(模型上下文协议(MCP)代理工具建议使用版本 1.102.0 或更高版本)。
- 安装适用于 Visual Studio Code 的 PostgreSQL 扩展(版本 1.32.0 或更高)。
- 使用具有访问 Azure 服务器资源权限的 Microsoft Entra 身份登录(包括配置数据库代理时对服务器资源的 Azure RBAC 写入权限),以及 PostgreSQL 凭据和网络访问权限以连接和运行查询。
- (可选)在 Visual Studio Code 中安装 GitHub Copilot,以便使用 询问 Copilot 了解本节内容和代理模式工具。
为服务器打开数据库代理
在 PostgreSQL 扩展中连接您的 Azure Database for PostgreSQL 灵活服务器,以打开数据库代理或在服务器仪表板上查看发现项。
在 Visual Studio Code 中,选择活动栏中的 PostgreSQL 图标以打开连接。
在“服务器”下,添加或连接到您的 Azure Database for PostgreSQL 灵活服务器,并在提示时使用您的 Azure 账户登录。
右键单击已连接的服务器节点:
- 选择 “数据库代理” 以配置和管理服务器的数据库代理。
- 选择 Dashboard 以打开服务器 Dashboard 并查看正在进行的调查和问题。
如果仪表板工具栏显示“检测到 Azure 服务器”,请选择“获取元数据”,以便扩展解析服务器的 Azure 资源身份。 如果出现 Azure 元数据不完整,请在横幅通知中选择 获取元数据 以完成租户解析。
查看问题
您可以在 Visual Studio Code 中直接审查和管理服务器的 Dashboard 选项卡上的 PostgreSQL 数据库代理问题。
打开您的服务器的仪表板。 当数据库代理正在调查或检测到服务器上的问题时,仪表板顶部会出现“ 调查 ”横幅,显示问题数量——选择“ 查看 N 个问题中的第一个” 以直接跳转到发现结果。
展开问题以检查其严重程度、状态(如 DETECTED 或 DIAGNOSED)、检测时间戳以及 AI 生成的分析:
- 推荐操作 包括推荐 更改(包含生成的 SQL 和 在编辑器中打开 和 复制 控件)、为什么这样做是安全的、回滚 SQL(同样包含 在编辑器中打开 和 复制 控件)以及 查看完整详细信息。
- 预期结果 总结了预期的工作量改善,并提供了可折叠的 回滚计划。
- 问题底部的操作按钮允许您选择“审核操作”、“标记已手动应用”或“拒绝问题”。
要借助 AI 探索某个问题部分,请点击标题旁的闪光图标(询问 Copilot about this section),如 “推荐操作” 或 “预期结果”。 GitHub Copilot 聊天开头预先加载了结构化的问题详细信息,方便您提出后续问题,并查看实时服务器指标、会话或执行计划。
回应问题
捕获的证据反映了问题被诊断时服务器的状态,而 AI 生成的发现可能不完整或不正确。 在进行更改前,将每项建议都与实际服务器进行验证。
使用服务器仪表板(查询、等待和会话选项卡)或打开查询编辑器,确认检测到的情况是否仍在实时服务器上生效(例如,调用
pg_terminate_backend()前查询pg_stat_activity和pg_locks)。对于 SQL 更改(例如创建索引或运行
ANALYZE),请在 RECOMMENDED ACTION 的“推荐更改”SQL 块中选择“在编辑器中打开”或“复制”:-
EXPLAIN在验证查询或索引更改时,检查查询计划可视化工具中的输出。 - 检查锁和资源影响(例如,保持
CREATE INDEX CONCURRENTLY状态以避免阻止对活动表的写入),并准备好回滚 SQL。 - 通过您授权的数据库工作流手动运行已批准的语句。
-
如需服务器参数建议(如调优
work_mem或自动清理设置),请在“连接>服务器”下右键单击服务器,选择“服务器管理>服务器参数”。 如果静态参数更改需要重启,请在批准的维护窗口内使用服务器管理>重启服务器。重新检查实时服务器指标和查询计划,以确认工作负载已恢复。
返回到仪表板中的问题,然后选择 标记已手动应用 以记录您已完成修复;如果不需要更改,则选择 忽略问题。 你仍然可以查看已忽略的问题的忽略详情。
按数据库引擎划分的 Surface 可用性
在预览期间,Visual Studio Code 和 Fabric 数据库中心对数据库代理的支持因引擎而异:
| Engine | Visual Studio Code | Fabric数据库中心 |
|---|---|---|
| Azure Database for PostgreSQL flexible server | 现已通过 PostgreSQL 扩展(数据库代理 和 仪表板)提供(有限预览版) | 即将推出数据库代理(基线环境和指标监控功能可在“监控 Azure Database for PostgreSQL 灵活服务器”中提供) |
| Azure SQL 数据库 | 即将推出 | 现已在数据库中心提供(预览版) |