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 不是 Default，則會忽略此值。 |string | |createMode |指定資料庫建立模式。

默認值：定期建立資料庫。

複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。

OnlineSecondary/NonReadableSecondary：建立資料庫做為現有資料庫的次要複本（可讀取或不可讀取的）。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。

PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。

復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。

還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。

RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。

DataWarehouse 版本不支援 Copy、NonReadableSecondary、OnlineSecondary 和 RestoreLongTermRetentionBackup。 |'Copy'
'Default'
'NonReadableSecondary'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
'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 不是 Default，則會忽略此值。 DataWarehouse 版本不支援。 |'AdventureWorksLT' | |sourceDatabaseDeletionDate |有條件的。如果 createMode 為 Restore，且 sourceDatabaseId 是已刪除的資料庫原始資源標識符，當它存在時，它就會成為已刪除的資料庫標識碼（與其目前可還原的已卸除資料庫標識符相反），則需要此值。指定刪除資料庫的時間。 |string | |sourceDatabaseId |有條件的。如果 createMode 為 Copy、NonReadableSecondary、OnlineSecondary、PointInTimeRestore、Recovery 或 Restore，則需要此值。指定源資料庫的資源識別碼。如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，源資料庫的名稱必須與所建立的新資料庫相同。 |string | |zoneRedundant |此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。 |bool |