数据库代理帮助应用所有者和数据库管理员检测、调查并响应 Azure SQL 数据库 和 Azure Database for PostgreSQL 灵活服务器中支持的性能问题。
使用数据库代理来:
- 检测支持的数据库性能状况。
- 复习问题摘要、证据和指导。
- 跟踪调查过程、问题结案及复发情况。
在预览期间,您使用数据库代理的位置取决于数据库引擎:
- Azure SQL 数据库:可在 Fabric Database Hub 中使用。 Visual Studio Code 支持即将上线。
- Azure Database for PostgreSQL 灵活服务器:在 Visual Studio Code 中以有限预览形式提供。 Fabric 数据库中心的支持即将上线。
Database Agents 使用您现有的身份、Azure 资源权限和数据库权限。 它不会授予额外访问权限,也不会绕过您现有的审批和变更管理要求。
Important
Database Agents 处于预览阶段。 它会调查受支持的问题并提供指导。 你不能直接从某个问题应用数据库更改。 所有场景都需要通过您授权的数据库工作流进行人工响应。
Note
适用于 Azure Database for PostgreSQL 灵活服务器的数据库代理目前以有限预览形式在 Visual Studio Code 中提供。 访问权限有限,需要批准。 要请求访问权限, 请填写数据库代理有限预览参与表单。
数据库代理的工作原理
数据库代理为选定的数据库和服务器创建引导式操作流:
- 检测受支持的数据库状况。
- 调查 状况并收集证据。
- 根据问题类型指导或推荐下一步响应。
- 跟踪调查和问题状态,直至关闭或再次发生。
所有问题都为手动响应提供了指导。 现有的数据库权限和操作控制仍将继续适用。
数据库代理如何运用 AI
数据库代理可在没有大型语言模型(LLM)的情况下检测并调查 Azure SQL 数据库 问题。 这一核心调查不占用 Copilot 的容量。
对于高 CPU 和长期查询问题,你可以选择使用 上下文 AI 辅助 来探索证据。 上下文式人工智能使用LLM和管理员分配的Copilot容量。
每一次 Azure Database for PostgreSQL 调查均采用 AI 辅助。 数据库代理使用大型语言模型(LLM)来诊断该状况并建议人工响应。 AI 模型处理在 美国数据区 中为美国区域(美国中南部 和 美国西部 3)运行,并在 欧盟数据区 中为 瑞典中部 运行。
在有限预览期间,您无需为 PostgreSQL 数据库代理调查付费。 在正式发布前就开始计费,Microsoft 会在开始计费前提前通知已注册客户。
开始
在启用数据库代理之前,请确认以下先决条件。
Prerequisites
- 使用具有访问您想要监控的 Azure SQL 数据库的身份登录 Fabric。
- 使用支持的 Azure SQL 数据库。
- 如果数据库是无服务器的,请确认其已唤醒,以便数据库代理能够评估它。
- 确认数据库位于与 Fabric 租户主区域关联的受支持区域。
- 在“启用 Microsoft SQL 性能监控”中完成适用的 Azure SQL 数据库 设置。
- 确认您拥有数据库读取权限以查看问题。
- 确认您在保存代理时,对所选的每个数据库对应的 Azure 资源具有基于 Azure 角色的访问控制(Azure RBAC)写入权限。
Important
Azure Database for PostgreSQL 的数据库代理处于有限预览阶段。 在启用此功能之前,必须 通过参与表单请求访问权限 并接收审批。
- 安装 Visual Studio Code 以及 Visual Studio Code 的 PostgreSQL 扩展(版本 1.32.0 或更高)。 Fabric 数据库中心中对 PostgreSQL 数据库代理的支持即将推出。
- 在支持的有限预览区域内,使用 PostgreSQL 16 或更高版本的运行 Azure Database for PostgreSQL 灵活服务器:美国中南部、美国西部 3 或瑞典中部。
- 使用具有访问 Azure 服务器资源权限的身份登录 Visual Studio Code(包括配置代理时对服务器资源的 Azure RBAC 写入权限),以及用于连接服务器的 PostgreSQL 凭据。
有关完整安装说明,请参阅《启用并激活数据库代理》或《在 Visual Studio Code 中使用数据库代理》。
打开数据库代理
- Open Database Hub。
- 选择 “管理代理”。
- 选择 “数据库代理设置”。
在数据库代理设置中,您可以选择 Azure SQL 数据库,查看其代理策略,并保存配置。 Visual Studio Code 中对 Azure SQL 数据库 的支持即将推出。
在有限预览期间,您可以通过 Visual Studio Code 访问 PostgreSQL 数据库代理(即将在 Fabric Database Hub 中提供支持):
- 打开 Visual Studio Code,并在活动栏中选择 PostgreSQL 图标以打开“连接”。
- 在“服务器”下,右键单击您连接的 Azure Database for PostgreSQL 灵活服务器。
- 选择 “数据库代理 ”以配置代理,或选择 “仪表板 ”以查看正在进行的调查和问题。
有关完整的 Visual Studio Code 工作流程,请参阅《在 Visual Studio Code 中使用数据库代理》。
1. 检测支持检测的问题
数据库代理根据已保存的代理策略评估选定的数据库和服务器。
Azure SQL 数据库 支持的问题场景包括:
- CPU 使用率过高。
- 内存占用高。
- 高 I/O。
- 长时间运行的查询。
- 阻塞查询。
- 缺少索引。
- 删除未使用的或重复的索引。
- 查询计划回归。
支持的 Azure Database for PostgreSQL 问题场景包括:
| Scenario | 条件数据库代理进行调查 |
|---|---|
| 连接耗尽 | 角色连接限制和会话囤积。 |
| 死元组膨胀 | 死元组累积、纯堆元组(HOT)更新退化以及频繁更新导致的索引膨胀。 |
| CPU使用率高 | 索引类型不匹配、过时统计信息以及未索引的查询。 |
| 事务中空闲 | 处于事务空闲状态的会话保留快照。 |
| 锁争用 | 行锁和表锁。 |
| 查询计划回归 | Gather 瓶颈、连接类型错选、有损位图重新检查以及被遗弃的支持索引。 |
| 排序溢出和内存压力 | 来自完整聚合、哈希连接、大排序和并行查询的溢出。 |
启用数据库、服务器或场景后,产生新问题大约需要 15 分钟。 问题创建可以更快完成。
另外,启用性能监控可能需要大约 15 分钟才能同步到数据库列表和配置中,然后才能注册数据库。 数据库代理无法在数据库注册前检测或创建相关问题。
2. 审查调查和证据
打开一个议题以了解检测到的状态并决定下一步该怎么做。 根据问题类型及其当前状态,数据库代理可以提供:
- 状况摘要。
- 采集到的证据。
- 建议。
- 手动响应的指导。
- 当前问题状态及历史。
捕获的证据描述了检测到时的状况。 在采取行动前,请先查看当前状态和可用证据。
对于高 CPU 和长时间运行的查询问题,上下文 AI 辅助会使用额外技能帮助你探索证据。 推荐操作中的提示按钮打开带有问题上下文的 Copilot 窗格;“解释原因”内嵌显示说明;“分析慢查询”则为捕获的查询提供内嵌建议。 此协助使用管理员分配的 Copilot 容量,不应用数据库更改。
有关这些可选的调查步骤,请参阅 使用上下文 AI 进行调查。
由于 PostgreSQL 调查由 AI 辅助,摘要、分析、 推荐措施 (包括 推荐更改、 为何安全以及 回滚 SQL)和 预期结果 均由 LLM 生成。 在 Visual Studio Code 的服务器仪表板上,您还可以选择“询问 Copilot 关于此部分的问题”,以探索 GitHub Copilot 对话助手 中的问题。 在采取行动前,将诊断以及任何建议的 SQL 语句或服务器参数更改与实际服务器进行验证。
有关详细的审查指导,请参阅 数据库代理性能问题审查指南。
3. 决定如何回应
推荐的手动响应取决于问题场景。 数据库代理程序不会执行响应。
遵循指导并手动响应
所有问题都提供调查结果和手动修复的指导。
查看证据和指导,重新检查当前状况,并通过您授权的数据库工作流程完成相应响应。 响应后确认当前状态。 如果完成后问题仍处于打开状态,请关闭它。
有关响应和验证指导,请参阅“审查数据库代理性能问题”。
4. 跟踪问题状态
数据库代理在调查该状况或确定该状况不再需要关注时,会更新问题。
在 Database Hub 中,问题状态如下:
- 活动: 该状况需要关注。
- 调查: Database Agents 正在收集或分析证据。
- 调查完成: 指导可得。 手动执行响应。
- 失败: 调查未能成功完成。
- 已关闭: 该问题已不再活跃,仍可在历史记录中查看。
在 Visual Studio Code 服务器的控制面板上,数据库代理会在调查横幅中显示当前调查进度,并跟踪每个问题从Detected和Diagnosed直到解决,例如在完成更改后选择标记为已手动应用,或在不需要任何操作时选择忽略问题。
调查失败并不意味着数据库或服务器更改失败。 Database Agents 不会在没有您操作的情况下自动执行数据库或服务器更改。
对于可重试的错误,调查会自动重试最多三次。 当调查达到 失败 或 调查完成时,刷新或重新打开问题不会重新生成缺失的详细信息。 确认数据库或服务器上的读取权限,如果缺少调查细节,请联系 Microsoft 支持部门。
5. 审查问题历史和复发情况
问题可以在您完成手动响应或监控确定该状况已清除后关闭。 无论哪种情况,最终状态都是“关闭”。 查看问题历史和实时数据库或服务器状态以了解结果。 关闭一个问题本身并不能证明工作负载已经恢复。
如果某个条件在问题关闭后再次出现,数据库代理会创建一个新问题,并将该已关闭的问题保留在历史中。
负责任地使用 Database Agents
Database Agent 的发现和建议需要进行操作员审核。
数据库代理不能替代:
- 数据库认证与授权。
- 现有审批流程。
- 变更管理需求。
- 生产验证。
- 对数据库更改的人工问责。
支持的数据库和服务器
数据库代理支持 Azure SQL 数据库,包括无服务器数据库和超大规模数据库。
目前,数据库代理不支持:
- Azure SQL elastic pools.
- One-vCore 无服务器数据库。
- Azure SQL 托管实例。
- Azure 虚拟机中的 SQL Server.
- 已启用 Azure Arc 的 SQL Server
数据库代理支持 Azure Database for PostgreSQL 灵活服务器,运行 PostgreSQL 16 或更高版本,涵盖灵活服务器计算层级(包括 Burstable、General Purpose 和 Memory Optimized)及部署配置。 对 Azure HorizonDB 的支持即将上线。
PostgreSQL 支持目前以有限预览形式在 Visual Studio Code 中提供,Fabric 数据库中心的支持也即将推出。 访问权限有限,需要批准。 要请求访问权限, 请填写数据库代理有限预览参与表单。
公开预览的局限性
- Surface 可用性:Fabric 数据库中心目前支持 Azure SQL 数据库;Visual Studio Code 支持即将上线。
- 区域可用性:数据库必须位于与 Fabric 租户主区域关联的受支持区域。 不支持跨区域注册。
- Surface availability: PostgreSQL 数据库代理目前仅以有限预览形式在 Visual Studio Code 中提供。 Fabric 数据库中心的支持即将上线。
- 有限的预览区域和数据区域: PostgreSQL 支持最初适用于 美国中南部、 美国西部 3 区和 瑞典中部的服务器,而 AI 处理则用于 美国数据区 和 欧盟数据区。
- 问题可用性: 新启用的数据库、服务器或场景大约需要 15 分钟才能产生新问题。
- 手动响应: 通过您授权的数据库工作流程审核建议并执行更改。
- 预览行为: 在预览过程中,支持的问题、配置和区域可能会发生变化。
有关完整列表和恢复步骤,请参阅 数据库代理的限制与故障排除。
Troubleshoot
数据库或服务器未出现
确认该数据库受支持,位于支持区域内,并且对您的身份可见。 如果数据库是无服务器的,请确认它已唤醒。 确认启用 Microsoft SQL 性能监控,并允许大约 15 分钟时间将启用功能传递到数据库列表和配置中。 如果数据库仍未显示,请联系 Microsoft 支持部门。
确认您已获得有限预览的批准,已安装 Visual Studio Code 的 PostgreSQL 扩展(版本 1.32.0 或更高),且该灵活服务器运行 PostgreSQL 16 或更高版本,正在运行(未停止),处于受支持的有限预览区域(South Central US、West US 3 或 Sweden Central),并且服务器 Dashboard 上已加载 Azure 元数据(Fetch Metadata)。 请注意,PostgreSQL 数据库代理尚未在 Fabric 数据库中心中提供(即将推出)。 如果服务器或代理仍未出现在 Visual Studio Code 中,请联系 Microsoft 支持部门。
代理配置无法保存
保存时,会验证代理以及您对每个所选数据库或服务器的 Azure 资源写入权限。 如果任一选定的数据库或服务器在权限检查中失败,整个保存将失败。 从选择中移除您缺乏权限的资源,并保存剩余配置。 有关其他错误或持续失败,请参见“代理无法保存或未变为活动状态”。
没有出现新问题项
至少等待 15 分钟,确认源条件仍然有效,确认相应的代理策略选项已启用,然后刷新问题列表。
无法加载数据库或服务器列表
确认您的身份能够读取已为租户保存的资源。 使用能够访问已配置资源的身份重试。
区域服务中断后数据库代理不会恢复
您无需重新配置或重新启用数据库代理。 服务恢复后,刷新 Database Hub 或 Visual Studio Code 并重试操作。 如果数据库代理未恢复,请联系 Microsoft 支持部门。