Azure SQL故障转移组Bicep重复部署挂起的排查求助

问题描述 #

首次用Bicep部署Azure SQL故障转移组可在1分钟内完成，但重复执行部署时进程持续挂起，已等待超16小时。回退至历史可用版本、删除故障转移组及关联SQL资源后重新创建，问题依旧：首次部署快速完成，再次执行即卡住。当前数据库无数据、结构简单。需要定位部署卡住的环节及排查方案。

涉及Bicep代码 #

param failoverGroupName string
param primarySqlServerName string
param secondarySqlServerName string
param databaseName string
param secondaryResourceGroup string

resource primary 'Microsoft.Sql/servers@2022-08-01-preview' existing = {
  name:  primarySqlServerName
}

resource secondary 'Microsoft.Sql/servers@2022-08-01-preview' existing = {
  name:  secondarySqlServerName
  scope: resourceGroup(secondaryResourceGroup)
}

resource sqlServerFailoverGroup 'Microsoft.Sql/servers/failoverGroups@2023-05-01-preview' = {
  name: failoverGroupName
  parent: primary
  properties: {
    databases: [
      resourceId('Microsoft.Sql/servers/databases', primarySqlServerName,databaseName)
    ]
    readWriteEndpoint: {
      failoverPolicy: 'Manual'
    }
    partnerServers: [
      {
        id: secondary.id
      }
    ]
  }
}

排查步骤 #

1. 定位部署卡住的具体环节 #

• Azure门户查看部署日志：进入目标资源组的「部署」页面，选中挂起的部署，查看「操作详情」。这里会展示每个资源的部署状态，找到长时间处于Running状态的操作，即为卡住的环节。
• Azure CLI查询部署操作：

  # 查看部署整体状态
  az deployment group show --name <部署名称> --resource-group <主资源组名> --query 'properties.provisioningState'
  # 查看详细操作步骤及状态
  az deployment group operation list --name <部署名称> --resource-group <主资源组名>
  

2. 检查故障转移组同步状态 #

• 门户查看复制状态：进入主SQL服务器的「故障转移组」页面，查看关联数据库的「复制状态」。若重复部署时同步任务处于等待或卡住状态，会导致部署挂起。
• CLI查询故障转移组详情：

  az sql failover-group show --name <故障转移组名> --server <主服务器名> --resource-group <主资源组名>
  

3. 排查资源锁与冲突操作 #

• 检查主/次SQL服务器、关联数据库是否存在资源锁（如删除锁），锁会阻止部署操作修改资源。
• 确认数据库是否有正在运行的后台操作（如备份、索引重建），此类操作可能与部署任务冲突。

4. 优化Bicep代码避免潜在问题 #

• 统一API版本：当前代码中服务器使用2022-08-01-preview，故障转移组使用2023-05-01-preview，统一为稳定版（如2023-08-01-preview或GA版本），避免预览版API兼容性问题。
• 引用现有数据库资源：替换手动拼接resourceId的方式，直接引用数据库资源，减少潜在的ID解析问题：

  param failoverGroupName string
  param primarySqlServerName string
  param secondarySqlServerName string
  param databaseName string
  param secondaryResourceGroup string
  
  resource primary 'Microsoft.Sql/servers@2023-08-01-preview' existing = {
    name: primarySqlServerName
  }
  
  resource secondary 'Microsoft.Sql/servers@2023-08-01-preview' existing = {
    name: secondarySqlServerName
    scope: resourceGroup(secondaryResourceGroup)
  }
  
  // 直接引用现有数据库资源
  resource primaryDb 'Microsoft.Sql/servers/databases@2023-08-01-preview' existing = {
    parent: primary
    name: databaseName
  }
  
  resource sqlServerFailoverGroup 'Microsoft.Sql/servers/failoverGroups@2023-08-01-preview' = {
    name: failoverGroupName
    parent: primary
    properties: {
      databases: [
        primaryDb.id
      ]
      readWriteEndpoint: {
        failoverPolicy: 'Manual'
      }
      partnerServers: [
        {
          id: secondary.id
        }
      ]
    }
  }
  

5. 排查Azure服务端异常 #

• 查看Azure状态页面，确认所在区域的SQL服务是否存在故障或维护。
• 若以上步骤无法定位问题，提交Azure支持工单，提供部署ID、故障转移组名称等信息，请求后台排查。

内容的提问来源于stack exchange，提问作者Don Chambers