Microsoft.Sql servers/databases 2021-05-01-preview
- 最新
- 2024-05-01-preview
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2019-06-01-preview
- 2017-10-01-preview
- 2017-03-01-preview
- 2014-04-01
Bicep 資源定義
伺服器/資料庫資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Sql/servers/databases 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.Sql/servers/databases@2021-05-01-preview' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
autoPauseDelay: int
catalogCollation: 'string'
collation: 'string'
createMode: 'string'
elasticPoolId: 'string'
federatedClientId: 'string'
highAvailabilityReplicaCount: int
isLedgerOn: bool
licenseType: 'string'
longTermRetentionBackupResourceId: 'string'
maintenanceConfigurationId: 'string'
maxSizeBytes: int
minCapacity: int
readScale: 'string'
recoverableDatabaseId: 'string'
recoveryServicesRecoveryPointId: 'string'
requestedBackupStorageRedundancy: 'string'
restorableDroppedDatabaseId: 'string'
restorePointInTime: 'string'
sampleName: 'string'
secondaryType: 'string'
sourceDatabaseDeletionDate: 'string'
sourceDatabaseId: 'string'
sourceResourceId: 'string'
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
屬性值
DatabaseIdentity
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 識別類型 | 'None' 'UserAssigned' |
| userAssignedIdentities | 要使用的使用者指派身分識別的資源標識碼 | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
DatabaseProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| autoPauseDelay | 在幾分鐘后自動暫停資料庫的時間。 -1 值表示已停用自動暫停 | int |
| catalogCollation | 元資料目錄的定序。 | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| 整理 | 資料庫的定序。 | 字串 |
| createMode | 指定資料庫建立模式。 默認值：定期建立資料庫。 複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。 次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。 復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。 還原：藉由還原已刪除資料庫的備份來建立資料庫。 必須指定sourceDatabaseId。 如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。 否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。 |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | 包含此資料庫之彈性集區的資源標識碼。 | 字串 |
| federatedClientId | 用於每個資料庫跨租使用者的用戶端標識碼 CMK 案例 | 字串 約束： 最小長度 = 36 最大長度 = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| highAvailabilityReplicaCount | 與用來提供高可用性之資料庫相關聯的次要複本數目。 不適用於彈性集區內的超大規模資料庫。 | int |
| isLedgerOn | 這個資料庫是否為總賬資料庫，這表示資料庫中的所有數據表都是總賬數據表。 注意：建立資料庫之後，就無法變更此屬性的值。 | bool |
| licenseType | 要套用此資料庫的授權類型。 如果您需要授權，或擁有授權且符合 Azure Hybrid Benefit 資格，請 LicenseIncludedBasePrice。 |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | 與此資料庫建立作業相關聯的長期保留備份資源標識符。 | 字串 |
| maintenanceConfigurationId | 指派給資料庫的維護組態標識碼。 此組態會定義維護更新發生的期間。 | 字串 |
| maxSizeBytes | 以位元組表示的資料庫大小上限。 | int |
| minCapacity | 資料庫一律配置的最小容量，如果未暫停，則為 | int |
| readScale | 唯讀路由的狀態。 如果啟用，在其連接字串中將應用程式意圖設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。 不適用於彈性集區內的超大規模資料庫。 | 'Disabled' 'Enabled' |
| recoverableDatabaseId | 與此資料庫建立作業相關聯的可復原資料庫資源標識符。 | 字串 |
| recoveryServicesRecoveryPointId | 與此資料庫建立作業相關聯的恢復點資源標識碼。 | 字串 |
| requestedBackupStorageRedundancy | 要用來儲存此資料庫的備份的記憶體帳戶類型。 | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorableDroppedDatabaseId | 與這個資料庫建立作業相關聯的可還原卸除資料庫資源標識符。 | 字串 |
| restorePointInTime | 指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。 | 字串 |
| sampleName | 建立這個資料庫時要套用的範例架構名稱。 | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| secondaryType | 如果資料庫是輔助資料庫，則為次要類型。 有效值為 Geo 和 Named。 | 'Geo' 'Named' |
| sourceDatabaseDeletionDate | 指定刪除資料庫的時間。 | 字串 |
| sourceDatabaseId | 與這個資料庫建立作業相關聯的源資料庫資源標識符。 | 字串 |
| sourceResourceId | 與這個資料庫建立作業相關聯的來源資源標識符。 指定 sourceResourceId 時，sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate 不得指定，而 CreateMode 必須是 PointInTimeRestore、Restore 或 Recover。 當 createMode 是 PointInTimeRestore 時，sourceResourceId 必須是現有資料庫或現有 sql 集區的資源標識碼，而且必須指定 restorePointInTime。 當 createMode 為 Restore 時，sourceResourceId 必須是可還原卸除資料庫或可還原的已卸除 sql 集區的資源識別符。 當 createMode 為 Recover 時，sourceResourceId 必須是可復原資料庫或可復原 SQL 集區的資源標識碼。 此屬性允許跨只支援 DataWarehouse 版本的訂用帳戶進行還原。 當來源訂用帳戶屬於與目標訂用帳戶不同的租使用者時，“x-ms-authorization-auxiliary” 標頭必須包含來源租使用者的驗證令牌。 如需“x-ms-authorization-auxiliary” 標頭的詳細資訊，請參閱 /azure/azure-resource-manager/management/authenticate-multi-tenant |
字串 |
| zoneRedundant | 此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。 | bool |
DatabaseUserIdentity
| 名字 | 描述 | 價值 |
|---|
Microsoft.Sql/servers/databases
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 資料庫的 Azure Active Directory 身分識別。 | DatabaseIdentity |
| 位置 | 資源位置。 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 （必要） |
| 父母 | 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。 |
類型的資源符號名稱：伺服器 |
| 性能 | 資源屬性。 | DatabaseProperties |
| sku | 資料庫 SKU。 SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的 SKU（包括 SKU 名稱、層/版本、系列和容量），請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />powershellGet-AzSqlServerServiceObjective -Location <位置> ```` |
Sku |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
Sku
| 名字 | 描述 | 價值 |
|---|---|---|
| 能力 | 特定 SKU 的容量。 | int |
| 家庭 | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| 名字 | SKU 的名稱，通常是字母 + 數位碼，例如 P3。 | 字串 （必要） |
| 大小 | 特定 SKU 的大小 | 字串 |
| 層 | 特定 SKU 的階層或版本，例如基本、進階。 | 字串 |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
快速入門範例
下列快速入門範例會部署此資源類型。
| Bicep 檔案 | 描述 |
|---|---|
| 使用寫入 Log Analytics 稽核的 Azure SQL Server |
此樣本可讓您部署已啟用稽核的 Azure SQL 伺服器，以將稽核記錄寫入 Log Analytics （OMS 工作區） |
| 建立 SQL Server 和資料庫 | 此範本可讓您建立 SQL Database 和 Server。 |
| 使用透明加密 |
使用透明數據加密建立 SQL Server 和專用 SQL 集區（先前稱為 SQL DW）。 |
| 在 Azure 架構上部署體育分析 | 建立已啟用 ADLS Gen 2 的 Azure 記憶體帳戶、具有記憶體帳戶連結服務的 Azure Data Factory 實例（如果已部署的 Azure SQL Database），以及 Azure Databricks 實例。 部署範本和 ADF 實例受控識別的使用者 AAD 身分識別，將會在記憶體帳戶上授與記憶體 Blob 數據參與者角色。 還有一個選項可用來部署 Azure Key Vault 實例、Azure SQL Database 和 Azure 事件中樞（適用於串流使用案例）。 部署 Azure Key Vault 時，部署範本之使用者的 Data Factory 受控識別和 AAD 身分識別將會獲得 Key Vault 秘密使用者角色。 |
| 私人端點範例 | 此範本示範如何建立指向 Azure SQL Server 的私人端點 |
| 使用 SQL Database 布建 Web 應用程式 | 此範本會布建 Web 應用程式、SQL Database、自動調整設定、警示規則和 App Insights。 它會在資料庫的 Web 應用程式中設定連接字串。 |
| 使用 Azure SQL 在 Linux 上 |
此範本會使用官方 Sonarqube 映像，並在 Azure SQL Server 支援下，在 Azure App Service Web 應用程式 Linux 容器中部署 Sonarqube。 |
| 具有受控識別、SQL Server 和 的 Web 應用程式 | 針對應用程式 + 資料 + 受控識別 + 監視部署 Azure 基礎結構的簡單範例 |
ARM 樣本資源定義
伺服器/資料庫資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Sql/servers/databases 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.Sql/servers/databases",
"apiVersion": "2021-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"autoPauseDelay": "int",
"catalogCollation": "string",
"collation": "string",
"createMode": "string",
"elasticPoolId": "string",
"federatedClientId": "string",
"highAvailabilityReplicaCount": "int",
"isLedgerOn": "bool",
"licenseType": "string",
"longTermRetentionBackupResourceId": "string",
"maintenanceConfigurationId": "string",
"maxSizeBytes": "int",
"minCapacity": "int",
"readScale": "string",
"recoverableDatabaseId": "string",
"recoveryServicesRecoveryPointId": "string",
"requestedBackupStorageRedundancy": "string",
"restorableDroppedDatabaseId": "string",
"restorePointInTime": "string",
"sampleName": "string",
"secondaryType": "string",
"sourceDatabaseDeletionDate": "string",
"sourceDatabaseId": "string",
"sourceResourceId": "string",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
DatabaseIdentity
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 識別類型 | 'None' 'UserAssigned' |
| userAssignedIdentities | 要使用的使用者指派身分識別的資源標識碼 | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
DatabaseProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| autoPauseDelay | 在幾分鐘后自動暫停資料庫的時間。 -1 值表示已停用自動暫停 | int |
| catalogCollation | 元資料目錄的定序。 | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| 整理 | 資料庫的定序。 | 字串 |
| createMode | 指定資料庫建立模式。 默認值：定期建立資料庫。 複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。 次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。 復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。 還原：藉由還原已刪除資料庫的備份來建立資料庫。 必須指定sourceDatabaseId。 如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。 否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。 |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | 包含此資料庫之彈性集區的資源標識碼。 | 字串 |
| federatedClientId | 用於每個資料庫跨租使用者的用戶端標識碼 CMK 案例 | 字串 約束： 最小長度 = 36 最大長度 = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| highAvailabilityReplicaCount | 與用來提供高可用性之資料庫相關聯的次要複本數目。 不適用於彈性集區內的超大規模資料庫。 | int |
| isLedgerOn | 這個資料庫是否為總賬資料庫，這表示資料庫中的所有數據表都是總賬數據表。 注意：建立資料庫之後，就無法變更此屬性的值。 | bool |
| licenseType | 要套用此資料庫的授權類型。 如果您需要授權，或擁有授權且符合 Azure Hybrid Benefit 資格，請 LicenseIncludedBasePrice。 |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | 與此資料庫建立作業相關聯的長期保留備份資源標識符。 | 字串 |
| maintenanceConfigurationId | 指派給資料庫的維護組態標識碼。 此組態會定義維護更新發生的期間。 | 字串 |
| maxSizeBytes | 以位元組表示的資料庫大小上限。 | int |
| minCapacity | 資料庫一律配置的最小容量，如果未暫停，則為 | int |
| readScale | 唯讀路由的狀態。 如果啟用，在其連接字串中將應用程式意圖設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。 不適用於彈性集區內的超大規模資料庫。 | 'Disabled' 'Enabled' |
| recoverableDatabaseId | 與此資料庫建立作業相關聯的可復原資料庫資源標識符。 | 字串 |
| recoveryServicesRecoveryPointId | 與此資料庫建立作業相關聯的恢復點資源標識碼。 | 字串 |
| requestedBackupStorageRedundancy | 要用來儲存此資料庫的備份的記憶體帳戶類型。 | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorableDroppedDatabaseId | 與這個資料庫建立作業相關聯的可還原卸除資料庫資源標識符。 | 字串 |
| restorePointInTime | 指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。 | 字串 |
| sampleName | 建立這個資料庫時要套用的範例架構名稱。 | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| secondaryType | 如果資料庫是輔助資料庫，則為次要類型。 有效值為 Geo 和 Named。 | 'Geo' 'Named' |
| sourceDatabaseDeletionDate | 指定刪除資料庫的時間。 | 字串 |
| sourceDatabaseId | 與這個資料庫建立作業相關聯的源資料庫資源標識符。 | 字串 |
| sourceResourceId | 與這個資料庫建立作業相關聯的來源資源標識符。 指定 sourceResourceId 時，sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate 不得指定，而 CreateMode 必須是 PointInTimeRestore、Restore 或 Recover。 當 createMode 是 PointInTimeRestore 時，sourceResourceId 必須是現有資料庫或現有 sql 集區的資源標識碼，而且必須指定 restorePointInTime。 當 createMode 為 Restore 時，sourceResourceId 必須是可還原卸除資料庫或可還原的已卸除 sql 集區的資源識別符。 當 createMode 為 Recover 時，sourceResourceId 必須是可復原資料庫或可復原 SQL 集區的資源標識碼。 此屬性允許跨只支援 DataWarehouse 版本的訂用帳戶進行還原。 當來源訂用帳戶屬於與目標訂用帳戶不同的租使用者時，“x-ms-authorization-auxiliary” 標頭必須包含來源租使用者的驗證令牌。 如需“x-ms-authorization-auxiliary” 標頭的詳細資訊，請參閱 /azure/azure-resource-manager/management/authenticate-multi-tenant |
字串 |
| zoneRedundant | 此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。 | bool |
DatabaseUserIdentity
| 名字 | 描述 | 價值 |
|---|
Microsoft.Sql/servers/databases
| 名字 | 描述 | 價值 |
|---|---|---|
| apiVersion | API 版本 | '2021-05-01-preview' |
| 身份 | 資料庫的 Azure Active Directory 身分識別。 | DatabaseIdentity |
| 位置 | 資源位置。 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 （必要） |
| 性能 | 資源屬性。 | DatabaseProperties |
| sku | 資料庫 SKU。 SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的 SKU（包括 SKU 名稱、層/版本、系列和容量），請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />powershellGet-AzSqlServerServiceObjective -Location <位置> ```` |
Sku |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 類型 | 資源類型 | 'Microsoft.Sql/servers/databases' |
Sku
| 名字 | 描述 | 價值 |
|---|---|---|
| 能力 | 特定 SKU 的容量。 | int |
| 家庭 | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| 名字 | SKU 的名稱，通常是字母 + 數位碼，例如 P3。 | 字串 （必要） |
| 大小 | 特定 SKU 的大小 | 字串 |
| 層 | 特定 SKU 的階層或版本，例如基本、進階。 | 字串 |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
使用寫入 Log Analytics 稽核的 Azure SQL Server 
|
此樣本可讓您部署已啟用稽核的 Azure SQL 伺服器，以將稽核記錄寫入 Log Analytics （OMS 工作區） |
|
建立 SQL Server 和資料庫
|
此範本可讓您建立 SQL Database 和 Server。 |
| 使用透明加密
|
使用透明數據加密建立 SQL Server 和專用 SQL 集區（先前稱為 SQL DW）。 |
|
部署新的 SQL 彈性集區
|
此範本可讓您使用新的相關聯的 SQL Server 和新的 SQL Database 來部署新的 SQL 彈性集區，並將其指派給它。 |
|
在 Azure 架構上部署體育分析
|
建立已啟用 ADLS Gen 2 的 Azure 記憶體帳戶、具有記憶體帳戶連結服務的 Azure Data Factory 實例（如果已部署的 Azure SQL Database），以及 Azure Databricks 實例。 部署範本和 ADF 實例受控識別的使用者 AAD 身分識別，將會在記憶體帳戶上授與記憶體 Blob 數據參與者角色。 還有一個選項可用來部署 Azure Key Vault 實例、Azure SQL Database 和 Azure 事件中樞（適用於串流使用案例）。 部署 Azure Key Vault 時，部署範本之使用者的 Data Factory 受控識別和 AAD 身分識別將會獲得 Key Vault 秘密使用者角色。 |
| 使用 VNET 中的自訂 Ambari + Hive 中繼存放區 DB HDInsight
|
此範本可讓您使用新的 SQL DB，在現有的虛擬網路中建立 HDInsight 叢集，以作為自訂 Ambari DB 和 Hive 中繼存放區。 您必須擁有現有的 SQL Sever、記憶體帳戶和 VNET。 |
|
私人端點範例
|
此範本示範如何建立指向 Azure SQL Server 的私人端點 |
|
使用 SQL Database 布建 Web 應用程式
|
此範本會布建 Web 應用程式、SQL Database、自動調整設定、警示規則和 App Insights。 它會在資料庫的 Web 應用程式中設定連接字串。 |
|
具有高可用性的遠端桌面服務
|
此 ARM 範例程式代碼會部署具有高可用性的 遠端桌面服務 2019 會話集合 實驗室。 目標是使用 Windows Server 2019 部署遠端桌面服務的完整備援高可用性解決方案。 |
| 使用 Azure SQL 在 Linux 上
|
此範本會使用官方 Sonarqube 映像，並在 Azure SQL Server 支援下，在 Azure App Service Web 應用程式 Linux 容器中部署 Sonarqube。 |
|
具有受控識別、SQL Server 和 的 Web 應用程式
|
針對應用程式 + 資料 + 受控識別 + 監視部署 Azure 基礎結構的簡單範例 |
|
WebApp 取用 Azure SQL 私人端點
|
此範本示範如何建立 Web 應用程式，以取用指向 Azure SQL Server 的私人端點 |
Terraform （AzAPI 提供者） 資源定義
伺服器/資料庫資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Sql/servers/databases 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/servers/databases@2021-05-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
autoPauseDelay = int
catalogCollation = "string"
collation = "string"
createMode = "string"
elasticPoolId = "string"
federatedClientId = "string"
highAvailabilityReplicaCount = int
isLedgerOn = bool
licenseType = "string"
longTermRetentionBackupResourceId = "string"
maintenanceConfigurationId = "string"
maxSizeBytes = int
minCapacity = int
readScale = "string"
recoverableDatabaseId = "string"
recoveryServicesRecoveryPointId = "string"
requestedBackupStorageRedundancy = "string"
restorableDroppedDatabaseId = "string"
restorePointInTime = "string"
sampleName = "string"
secondaryType = "string"
sourceDatabaseDeletionDate = "string"
sourceDatabaseId = "string"
sourceResourceId = "string"
zoneRedundant = bool
}
})
}
屬性值
DatabaseIdentity
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 識別類型 | 'None' 'UserAssigned' |
| userAssignedIdentities | 要使用的使用者指派身分識別的資源標識碼 | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
DatabaseProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| autoPauseDelay | 在幾分鐘后自動暫停資料庫的時間。 -1 值表示已停用自動暫停 | int |
| catalogCollation | 元資料目錄的定序。 | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| 整理 | 資料庫的定序。 | 字串 |
| createMode | 指定資料庫建立模式。 默認值：定期建立資料庫。 複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。 次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。 復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。 還原：藉由還原已刪除資料庫的備份來建立資料庫。 必須指定sourceDatabaseId。 如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。 否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。 |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | 包含此資料庫之彈性集區的資源標識碼。 | 字串 |
| federatedClientId | 用於每個資料庫跨租使用者的用戶端標識碼 CMK 案例 | 字串 約束： 最小長度 = 36 最大長度 = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| highAvailabilityReplicaCount | 與用來提供高可用性之資料庫相關聯的次要複本數目。 不適用於彈性集區內的超大規模資料庫。 | int |
| isLedgerOn | 這個資料庫是否為總賬資料庫，這表示資料庫中的所有數據表都是總賬數據表。 注意：建立資料庫之後，就無法變更此屬性的值。 | bool |
| licenseType | 要套用此資料庫的授權類型。 如果您需要授權，或擁有授權且符合 Azure Hybrid Benefit 資格，請 LicenseIncludedBasePrice。 |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | 與此資料庫建立作業相關聯的長期保留備份資源標識符。 | 字串 |
| maintenanceConfigurationId | 指派給資料庫的維護組態標識碼。 此組態會定義維護更新發生的期間。 | 字串 |
| maxSizeBytes | 以位元組表示的資料庫大小上限。 | int |
| minCapacity | 資料庫一律配置的最小容量，如果未暫停，則為 | int |
| readScale | 唯讀路由的狀態。 如果啟用，在其連接字串中將應用程式意圖設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。 不適用於彈性集區內的超大規模資料庫。 | 'Disabled' 'Enabled' |
| recoverableDatabaseId | 與此資料庫建立作業相關聯的可復原資料庫資源標識符。 | 字串 |
| recoveryServicesRecoveryPointId | 與此資料庫建立作業相關聯的恢復點資源標識碼。 | 字串 |
| requestedBackupStorageRedundancy | 要用來儲存此資料庫的備份的記憶體帳戶類型。 | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorableDroppedDatabaseId | 與這個資料庫建立作業相關聯的可還原卸除資料庫資源標識符。 | 字串 |
| restorePointInTime | 指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。 | 字串 |
| sampleName | 建立這個資料庫時要套用的範例架構名稱。 | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| secondaryType | 如果資料庫是輔助資料庫，則為次要類型。 有效值為 Geo 和 Named。 | 'Geo' 'Named' |
| sourceDatabaseDeletionDate | 指定刪除資料庫的時間。 | 字串 |
| sourceDatabaseId | 與這個資料庫建立作業相關聯的源資料庫資源標識符。 | 字串 |
| sourceResourceId | 與這個資料庫建立作業相關聯的來源資源標識符。 指定 sourceResourceId 時，sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate 不得指定，而 CreateMode 必須是 PointInTimeRestore、Restore 或 Recover。 當 createMode 是 PointInTimeRestore 時，sourceResourceId 必須是現有資料庫或現有 sql 集區的資源標識碼，而且必須指定 restorePointInTime。 當 createMode 為 Restore 時，sourceResourceId 必須是可還原卸除資料庫或可還原的已卸除 sql 集區的資源識別符。 當 createMode 為 Recover 時，sourceResourceId 必須是可復原資料庫或可復原 SQL 集區的資源標識碼。 此屬性允許跨只支援 DataWarehouse 版本的訂用帳戶進行還原。 當來源訂用帳戶屬於與目標訂用帳戶不同的租使用者時，“x-ms-authorization-auxiliary” 標頭必須包含來源租使用者的驗證令牌。 如需“x-ms-authorization-auxiliary” 標頭的詳細資訊，請參閱 /azure/azure-resource-manager/management/authenticate-multi-tenant |
字串 |
| zoneRedundant | 此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。 | bool |
DatabaseUserIdentity
| 名字 | 描述 | 價值 |
|---|
Microsoft.Sql/servers/databases
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 資料庫的 Azure Active Directory 身分識別。 | DatabaseIdentity |
| 位置 | 資源位置。 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 （必要） |
| parent_id | 此資源為父系之資源的標識碼。 | 類型資源的標識碼：伺服器 |
| 性能 | 資源屬性。 | DatabaseProperties |
| sku | 資料庫 SKU。 SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的 SKU（包括 SKU 名稱、層/版本、系列和容量），請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />powershellGet-AzSqlServerServiceObjective -Location <位置> ```` |
Sku |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 |
| 類型 | 資源類型 | “Microsoft.Sql/servers/databases@2021-05-01-preview” |
Sku
| 名字 | 描述 | 價值 |
|---|---|---|
| 能力 | 特定 SKU 的容量。 | int |
| 家庭 | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| 名字 | SKU 的名稱，通常是字母 + 數位碼，例如 P3。 | 字串 （必要） |
| 大小 | 特定 SKU 的大小 | 字串 |
| 層 | 特定 SKU 的階層或版本，例如基本、進階。 | 字串 |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|