Bicep中如何让数据库模块等待SQL Server模块就绪？

问题原因 #

你遇到的是典型的异步资源就绪延迟问题：Bicep自动推断的依赖仅保证SQL Server资源完成创建流程，但Azure SQL Server在资源创建完成后还需要额外时间完成初始化就绪，此时直接创建数据库会因服务器未完全就绪而失败。

解决方案 #

1. 显式添加模块依赖

显式声明数据库模块依赖于SQL Server模块，确保数据库部署在服务器模块完全完成后启动。

服务器模块示例（sql-server.bicep）：

param serverName string
param adminLogin string
param adminPassword string
param location string = resourceGroup().location

resource sqlServer 'Microsoft.Sql/servers@2022-08-01-preview' = {
  name: serverName
  location: location
  properties: {
    administratorLogin: adminLogin
    administratorLoginPassword: adminPassword
  }
}

output serverName string = sqlServer.name

数据库模块示例（sql-database.bicep）：

param serverName string
param databaseName string
param location string = resourceGroup().location

resource sqlDatabase 'Microsoft.Sql/servers/databases@2022-08-01-preview' = {
  name: '${serverName}/${databaseName}'
  location: location
  properties: {
    // 配置数据库属性，比如SKU、备份策略等
  }
}

主文件中添加显式依赖：

module sqlServer './sql-server.bicep' = {
  name: 'deploy-sql-server'
  params: {
    serverName: 'sql-test-d-e2-001'
    adminLogin: 'sqladmin'
    adminPassword: 'StrongPass123!'
  }
}

module sqlDatabase './sql-database.bicep' = {
  name: 'deploy-sql-database'
  params: {
    serverName: sqlServer.outputs.serverName
    databaseName: 'my-user-db' // 注意：不要创建系统数据库master，需使用自定义用户数据库名称
  }
  dependsOn: [sqlServer] // 显式指定依赖
}

2. 引用SQL Server的就绪属性

通过引用SQL Server的fullyQualifiedDomainName属性（该属性仅在服务器完全就绪后才会生成），强制Bicep等待服务器就绪后再部署数据库。

修改sql-server.bicep添加输出：

output serverFqdn string = sqlServer.properties.fullyQualifiedDomainName

在主文件中引用该输出：

module sqlDatabase './sql-database.bicep' = {
  name: 'deploy-sql-database'
  params: {
    serverName: sqlServer.outputs.serverName
    databaseName: 'my-user-db'
    serverFqdn: sqlServer.outputs.serverFqdn // 引用就绪属性触发等待
  }
}

3. 将资源合并到同一模块

如果业务逻辑允许，将SQL Server和数据库放在同一个Bicep文件中，利用Bicep内部资源的父子依赖关系，确保数据库在服务器完全就绪后创建：

param serverName string = 'sql-test-d-e2-001'
param adminLogin string
param adminPassword string
param databaseName string = 'my-user-db'
param location string = resourceGroup().location

resource sqlServer 'Microsoft.Sql/servers@2022-08-01-preview' = {
  name: serverName
  location: location
  properties: {
    administratorLogin: adminLogin
    administratorLoginPassword: adminPassword
  }
}

resource sqlDatabase 'Microsoft.Sql/servers/databases@2022-08-01-preview' = {
  parent: sqlServer
  name: databaseName
  location: location
  properties: {
    sku: {
      name: 'GP_Gen5_2'
      tier: 'GeneralPurpose'
    }
  }
}

额外提示 #

你的报错中提到创建master数据库，这是Azure SQL Server的系统数据库，不需要手动创建，建议使用自定义名称的用户数据库，避免不必要的冲突。

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