通过


排查SQL Server部署Azure扩展问题

applies to:SQL Server

在开始之前,请注意日志位置。

日志文件位置

扩展日志

扩展日志文件位于:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\

日志文件名称取决于 SQL Server 的 Azure 扩展版本,对于 SQL Server 的 Azure 扩展名的最新版本,日志文件为:

unifiedagent.log

对于版本 1.1.24724.69 及更早版本的扩展,日志文件为:

ExtensionLog_0.log

部署程序日志

部署程序日志位于:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\<extension version>\deployer.log

请将 <extension version> 替换为您的扩展版本。 例如:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\1.1.0.0\deployer.log

创建已启用 Arc 的SQL Server资源失败可能是由几个问题引起的。

扩展安装失败

转到连接的服务器并检查部署程序日志。 你应该会看到以下消息。

[YY/MM/DDDD HH:MM:SS UTC] [INFO]          Status of service 'SqlServerExtension' before attempting start: Stopped
[YY/MM/DDDD HH:MM:SS UTC] [INFO]          Status of service 'SqlServerExtension' after attempting start: Stopped

如果看不到此消息,则表示扩展未正确安装。 请尝试以下步骤。

  1. 检查事件日志,查看是否有什么内容阻止了安装。 请尝试从以下文件夹安装 SqlServerExtension.msi C:\Packages\Plugins\Microsoft.AzureData.WindowsAgent.SqlServer{version}。 安装 UI 可能会提供错误详细信息。

  2. 关闭服务应用、服务器管理器并使用 连接方法 重试以安装扩展,并查看这是否有帮助。

扩展已安装但未启动

检查日志文件中是否有应用程序错误。

服务器 - 手动删除了 Azure Arc ARM 资源

检查扩展日志中是否有以下记录:

[YY/MM/DDDD HH:MM:SS PM UTC] [ERROR]   [UploadServiceProvider]      [ExtensionHandlerStatusQueryError] ArcSqlInstancesRequest request is null, not sending data to RP.

这意味着计算机不再被识别为连接的服务器。 将服务器载入 Azure Arc,然后重试其中一个 connection 方法来安装扩展。

服务器托管标识权限不足

检查扩展日志中是否有以下记录:

[INFO] [UploadServiceProvider] [ExtensionHandlerArcUploadServicesNotifications] [AzureUpload] Arc post request failed with error: Forbidden message: {"ErrorDescription":{"ErrorCode":6,"Message":"The user has no access to the provided Azure resource."},"ResponseUrl":null}

确保已将计算机的托管标识分配给 Azure Connected SQL Server Onboarding 角色。 请参阅当计算机已连接到启用了 Arc 的服务器时角色分配说明。

用户未将已启用 Arc 的 SQL Server 资源迁移到新的资源提供程序

检查扩展日志中是否有以下记录:

[YY/MM/DDDD HH:MM:SS PM UTC] [INFO] [UploadServiceProvider] [ExtensionHandlerArcUploadServicesNotifications] [AzureUpload] Arc for Sql Server upload response status: InternalServerError.`

请确保将已启用 Arc 的SQL Server资源迁移到 Microsoft.AzureArcData

如果扩展长时间停滞在奇怪的状态(正在创建/删除)

断开您的 SQL Server 实例与 Azure Arc 的连接

已删除的资源仍显示在Azure门户中

注释

在你删除SQL Server - Azure Arc 资源后,该资源可能会在 Azure 门户中出现一段时间。 此行为是预期行为,由Azure 资源管理器缓存引起。 缓存刷新后,资源通常会消失。 如果资源仍显示在几个小时后,可以通过查询Azure Resource Graph或使用Azure CLI来验证它是否已成功删除。 无需执行进一步操作 — 资源不起作用,删除后不会产生费用。