本文适用于需要为选定的 Azure SQL 数据库或 Azure Database for PostgreSQL 灵活服务器启用并激活 Database Agents 的数据库管理员。
Important
Database Agents 处于预览阶段。 使用支持的数据库和服务器作用域,并在为生产工作负载启用之前,先审查贵组织的运营需求。
Note
Azure Database for PostgreSQL 灵活服务器的数据库代理目前仅在 Visual Studio Code 中以有限预览形式提供。 访问权限有限,需要批准。 要请求访问权限, 请填写数据库代理有限预览参与表单。 Fabric 数据库中心中对 PostgreSQL 数据库代理的支持即将推出。
Prerequisites
- 使用受支持的 Azure SQL Database,包括支持的无服务器或超大规模数据库。 不支持 One-vCore 无服务器数据库。
- 使用具有数据库访问权限的身份登录 Fabric。
- 确认数据库位于与 Fabric 租户主区域关联的受支持区域。
- 在“为 Microsoft SQL 启用性能监控”中完成适用的设置。 按照 Azure SQL 数据库 的说明操作。 如果数据库是无服务器的,请确认它已唤醒。
- 在保存代理时,您需要对每个选择的 Azure 数据库拥有基于 Azure 角色的访问控制(Azure RBAC)写权限。 此权限与执行 SQL 更改的权限不同。
Important
Azure Database for PostgreSQL 的数据库代理处于有限预览阶段。 在启用此功能之前,必须 通过参与表单请求访问权限 并接收审批。
- 安装 Visual Studio Code 以及 Visual Studio Code 的 PostgreSQL 扩展(版本 1.32.0 或更高)。
- 在支持的有限预览区域(美国中南部、美国西部 3或瑞典中部)使用正在运行的 Azure Database for PostgreSQL 灵活服务器,且 PostgreSQL 版本为 16 或更高版本(包括 Burstable、通用或内存优化计算层)。
- 使用具有访问 Azure 服务器资源权限的身份登录 Visual Studio Code(包括配置代理时对服务器资源的 Azure RBAC 写入权限),以及用于连接服务器的 PostgreSQL 凭据。
Note
每一次PostgreSQL调查均由AI辅助,AI模型处理分别位于 美国数据区 (针对 美国中南部 和 美国西部3区)以及 欧盟数据区 (针对 瑞典中部)。 在有限预览期间,你不需要为调查付费。 正式发布前即开始计费,Microsoft 会在开始计费前提前通知已注册客户。
启用并激活数据库代理
首先,在 Fabric Database Hub 中启用数据库代理:
- 打开 Fabric 数据库中心。
- 在左上角选择“管理代理”。
- 选择 “数据库代理设置”。
- 打开启用。
- 选择“保存”。
此步骤启用数据库代理,但不会为任何数据库激活数据库代理。
启用性能监控后,请等待约 15 分钟,等待数据库列表和配置更新。 在这些信息可用之前,您无法将数据库加入。 问题检测不会在登记前开始。
选择一个或多个您希望数据库代理监控的数据库。
打开所选数据库的代理策略。
在 “启用”下,选择数据库代理提供调查和指导的操作类别或单个操作:
操作类别 Actions 阻塞和死锁 终止造成阻塞的会话(识别造成阻塞的会话) 查询性能 标记长期运行的查询; 强制执行最后已知的良好计划 索引优化 创建缺失的索引; 删除未使用的索引; 删除重复索引 资源压力与争用 标记高 CPU; 标记高内存; 标记高 I/O 选择应用。
选择 “保存” 以保存数据库配置。
保存会验证代理以及您对每个所选数据库的 Azure 资源写入权限。 如果任一选定数据库未通过该权限检查,整个保存将失败。 从选择中移除您没有权限的数据库,然后保存剩余配置。 有关其他保存失败,请参见 “代理无法保存或未激活”。
代理策略中的操作名称是 UI 标签。 启用操作不会授权或执行指定的数据库更改。 针对每种场景,请查看相关处置指南,并通过您授权的数据库工作流手动执行任何应对措施。
在有限预览期间,您可以直接在 Visual Studio Code 中配置并打开 PostgreSQL 数据库代理(Fabric 数据库中心支持即将上线):
- 在 Visual Studio Code 中,选择活动栏中的 PostgreSQL 图标,打开 连接。
- 在“服务器”下,添加或连接到您的 Azure Database for PostgreSQL 灵活服务器,并在提示时使用您的 Azure 账户登录。
- 右键单击已连接的服务器节点,选择“ 数据库代理 ”以配置并启用该服务器的数据库代理。
- 如果您打开仪表板并看到“已检测到 Azure Server”(或“Azure 元数据不完整”),请选择“获取元数据”,以便扩展解析服务器的 Azure 资源标识。
有关完整的 Visual Studio Code 工作流及截图,请参阅《在 Visual Studio Code 中使用数据库代理》。
核实结果
- 打开 数据库代理设置 并确认出现绿色 数据库代理处于激活状态 的消息。 此消息显示的是代理级别状态,而非每个数据库单独的激活状态。 在检查问题之前,请确认保存配置已无错误地完成。
- 保存配置后,等待大约 15 分钟,等待新问题出现,然后在数据库中心打开问题列表。 只有当 Database Agents 检测到已注册数据库中的某种状况时,问题才会出现。 这个 15 分钟的问题创建间隔与启用 SQL 性能监控后的初始传播延迟是分开的。
当您审查高 CPU 或长期存在的查询问题时,可以在决定是否手动回复之前 ,先用上下文 AI 进行调查 。
- 在 Visual Studio Code 的“连接>服务器”下右键单击服务器,选择“仪表板”。
- 确认服务器的 Azure 元数据已加载,并监视仪表板顶部的“调查”横幅。 启用服务器后,检测活动状态并发现问题可能需要长达15分钟。
限制和已知问题
- 目前,Azure SQL 数据库 的数据库代理可在 Fabric 数据库中心中使用(Visual Studio Code 支持即将上线)。
- 目前,数据库代理不支持Azure SQL弹性池、单个 vCore 无服务器数据库、Azure SQL 托管实例、Azure 虚拟机中的 SQL Server 或由 Azure Arc 启用的SQL Server。
- 数据库必须位于与 Fabric 租户主区域关联的受支持区域。
- 目前,PostgreSQL 的数据库代理仅在 Visual Studio Code 中提供;Fabric 数据库中心的支持即将推出。
- 目前,数据库代理仅支持 Azure Database for PostgreSQL 灵活服务器(PostgreSQL 16 及更高版本)。 对 Azure HorizonDB 的支持即将上线。
- PostgreSQL 支持目前以 有限预览 形式提供,适用于 美国中南部、 美国西部 3 区和 瑞典中部 的服务器(在美国数据 区 和 欧盟数据区支持人工智能处理)。 访问权限有限,需通过 数据库代理有限预览参与表单获得批准。
- 新启用的数据库、服务器或场景大约需要 15 分钟才能生成问题项。
- 通过授权工作流审核建议并应用任何数据库或服务器更改。
故障排除
有关当前设置和问题发现检查,请参阅 数据库代理的限制与故障排除。