Microsoft.Sql/servers/databases 2014-04-01 - Bicep, ARM template & Terraform AzAPI reference

Bicep 资源定义

可以使用目标操作部署服务器/数据库资源类型：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Sql/servers/databases 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Sql/servers/databases@2014-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    collation: 'string'
    createMode: 'string'
    edition: 'string'
    elasticPoolName: 'string'
    maxSizeBytes: 'string'
    readScale: 'string'
    recoveryServicesRecoveryPointResourceId: 'string'
    requestedServiceObjectiveId: 'string'
    requestedServiceObjectiveName: 'string'
    restorePointInTime: 'string'
    sampleName: 'string'
    sourceDatabaseDeletionDate: 'string'
    sourceDatabaseId: 'string'
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

DatabaseProperties

|名称 |说明 |值 | |---- |----------- |------------ | |排序规则 |数据库的排序规则。如果 createMode 不是默认值，则忽略此值。 |string | |createMode |指定数据库创建模式。

默认值：常规数据库创建。

复制：将数据库创建为现有数据库的副本。 sourceDatabaseId 必须指定为源数据库的资源 ID。

OnlineSecondary/NonReadableSecondary：将数据库创建为现有数据库的辅助副本（可读或不可读）。 sourceDatabaseId 必须指定为现有主数据库的资源 ID。

PointInTimeRestore：通过还原现有数据库的时间点备份来创建数据库。 sourceDatabaseId 必须指定为现有数据库的资源 ID，并且必须指定 restorePointInTime。

恢复：通过还原异地复制的备份来创建数据库。 sourceDatabaseId 必须指定为可恢复的数据库资源 ID 才能还原。

还原：通过还原已删除数据库的备份来创建数据库。必须指定 sourceDatabaseId。如果 sourceDatabaseId 是数据库的原始资源 ID，则必须指定 sourceDatabaseDeletionDate。否则，sourceDatabaseId 必须是可还原删除的数据库资源 ID，并且将忽略 sourceDatabaseDeletionDate。还可以指定 restorePointInTime，以便从以前的时间点还原。

RestoreLongTermRetentionBackup：通过从长期保留保管库还原来创建数据库。 recoveryServicesRecoveryPointResourceId 必须指定为恢复点资源 ID。

DataWarehouse 版本不支持 Copy、NonReadableSecondary、OnlineSecondary 和 RestoreLongTermRetentionBackup。 |“Copy”
“Default”
“NonReadableSecondary”
“OnlineSecondary”
“PointInTimeRestore”
“Recovery”
“还原”
'RestoreLongTermRetentionBackup' | |版本 |数据库的版本。 DatabaseEditions 枚举包含所有有效版本。如果 createMode 为 NonReadableSecondary 或 OnlineSecondary，则忽略此值。

SKU 列表可能因区域和支持产品/服务而异。若要确定 Azure 区域中订阅可用的 SKU（包括 SKU 名称、层/版本、系列和容量），请使用 Capabilities_ListByLocation REST API 或以下命令之一：

azurecli az sql db list-editions -l <location> -o table ```` powershell
Get-AzSqlServerServiceObjective -Location <位置>
| 'Basic' 'Business' 'BusinessCritical' 'DataWarehouse' 'Free' 'GeneralPurpose' 'Hyperscale' 'Premium' 'PremiumRS' 'Standard' 'Stretch' 'System' 'System2' 'Web' | | elasticPoolName | The name of the elastic pool the database is in. If elasticPoolName and requestedServiceObjectiveName are both updated, the value of requestedServiceObjectiveName is ignored. Not supported for DataWarehouse edition. | string | | maxSizeBytes | The max size of the database expressed in bytes. If createMode is not Default, this value is ignored. To see possible values, query the capabilities API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) referred to by operationId: "Capabilities_ListByLocation." | string | | readScale | Conditional. If the database is a geo-secondary, readScale indicates whether read-only connections are allowed to this database or not. Not supported for DataWarehouse edition. | 'Disabled' 'Enabled' | | recoveryServicesRecoveryPointResourceId | Conditional. If createMode is RestoreLongTermRetentionBackup, then this value is required. Specifies the resource ID of the recovery point to restore from. | string | | requestedServiceObjectiveId | The configured service level objective ID of the database. This is the service level objective that is in the process of being applied to the database. Once successfully updated, it will match the value of currentServiceObjectiveId property. If requestedServiceObjectiveId and requestedServiceObjectiveName are both updated, the value of requestedServiceObjectiveId overrides the value of requestedServiceObjectiveName. The list of SKUs may vary by region and support offer. To determine the service objective ids that are available to your subscription in an Azure region, use the `Capabilities_ListByLocation` REST API. | string Constraints: Min length = 36 Max length = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$` | | requestedServiceObjectiveName | The name of the configured service level objective of the database. This is the service level objective that is in the process of being applied to the database. Once successfully updated, it will match the value of serviceLevelObjective property. The list of SKUs may vary by region and support offer. To determine the SKUs (including the SKU name, tier/edition, family, and capacity) that are available to your subscription in an Azure region, use the `Capabilities_ListByLocation` REST API or one of the following commands: ```azurecli az sql db list-editions -l <location> -o table 

'''powershell
Get-AzSqlServerServiceObjective -Location <位置>
```` |“Basic”
“DS100”
“DS1000”
“DS1200”
“DS1500”
“DS200”
“DS2000”
“DS300”
“DS400”
“DS500”
“DS600”
“DW100”
“DW1000”
“DW10000c”
“DW1000c”
“DW1200”
“DW1500”
“DW15000c”
“DW1500c”
“DW200”
“DW2000”
“DW2000c”
“DW2500c”
“DW300”
“DW3000”
“DW30000c”
“DW3000c”
“DW400”
“DW500”
“DW5000c”
“DW600”
“DW6000”
“DW6000c”
“DW7500c”
“ElasticPool”
“Free”
“P1”
“P11”
“P15”
“P2”
“P3”
“P4”
“P6”
“PRS1”
“PRS2”
“PRS4”
“PRS6”
“S0”
“S1”
“S12”
'S2'
'S3'
'S4'
'S6'
'S7'
'S9'
“System”
“System0”
“System1”
“System2”
“System2L”
“System3”
“System3L”
“System4”
“System4L” | |restorePointInTime |有條件的。如果 createMode 为 PointInTimeRestore，则此值是必需的。如果 createMode 为 Restore，则此值是可选的。指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。必须大于或等于源数据库的最早RestoreDate 值。 |string | |sampleName |指示创建此数据库时要应用的示例架构的名称。如果 createMode 不是默认值，则忽略此值。 DataWarehouse 版本不支持。 |“AdventureWorksLT”| |sourceDatabaseDeletionDate |有條件的。如果 createMode 为 Restore，并且 sourceDatabaseId 是已删除的数据库的原始资源 ID（而不是其当前可还原的已删除数据库 ID），则此值是必需的。指定删除数据库的时间。 |string | |sourceDatabaseId |有條件的。如果 createMode 为 Copy、NonReadableSecondary、OnlineSecondary、PointInTimeRestore、Recovery 或 Restore，则此值是必需的。指定源数据库的资源 ID。如果 createMode 为 NonReadableSecondary 或 OnlineSecondary，则源数据库的名称必须与要创建新数据库的名称相同。 |string | |zoneRedundant |此数据库是否为区域冗余，这意味着此数据库的副本将分布在多个可用性区域。 |bool |