共用方式為

Microsoft.Sql servers/databases 2014-04-01

  • 發行項

Bicep 資源定義

伺服器/資料庫資源類型可以使用目標作業來部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。

資源格式

若要建立 Microsoft.Sql/servers/databases 資源，請將下列 Bicep 新增至您的範本。

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

屬性值

servers/databases

名稱 描述 值
NAME 資源名稱

瞭解如何在 Bicep 中設定子資源的名稱和類型。		 字串 (必要)

字元限制：1-128

合法字元：
不能使用：
<>*%&:\/? 或控制字元

不能以句號或空格結尾。
location 資源位置。 字串 (必要)
tags 資源標籤。 標記名稱和值的字典。 請參閱 範本中的標記
父系 (parent) 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源之外宣告子資源時，才需要新增這個屬性。

如需詳細資訊，請參閱 父資源外部的子資源。		 類型資源的符號名稱： 伺服器
properties 代表資源的屬性。 DatabaseProperties

DatabaseProperties

名稱 描述 值
collation 資料庫的定序。 如果 createMode 不是 Default，則會忽略此值。 字串
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'
edition 資料庫的版本。 DatabaseEditions 列舉包含所有有效的版本。 如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，則會忽略此值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 SKU 可供您在 Azure 區域中的訂用帳戶使用，請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：

Azure CLI：
az sql db list-editions -l {location} -o table



Azure PowerShell：
Get-AzSqlServerServiceObjective -Location {location}

 'Basic'
'Business'
'BusinessCritical'
'DataWarehouse'
'Free'
'GeneralPurpose'
'超大規模資料庫'
'Premium'
'PremiumRS'
'Standard'
'Stretch'
'System'
'System2'
'Web'
elasticPoolName 資料庫所在的彈性集區名稱。 如果同時更新 elasticPoolName 和 requestedServiceObjectiveName，則會忽略 requestedServiceObjectiveName 的值。 DataWarehouse 版本不支援。 字串
maxSizeBytes 以位元組表示的資料庫大小上限。 如果 createMode 不是 Default，則會忽略此值。 若要查看可能的值，請查詢功能 API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) operationId 所參考的功能：“Capabilities_ListByLocation”。 字串
readScale 條件。 如果資料庫是異地輔助資料庫，readScale 會指出是否允許此資料庫的唯讀連線。 DataWarehouse 版本不支援。 'Disabled'
'Enabled'
recoveryServicesRecoveryPointResourceId 條件。 如果 createMode 為 RestoreLongTermRetentionBackup，則需要此值。 指定要從中還原之恢復點的資源標識碼。 字串
requestedServiceObjectiveId 資料庫的已設定服務等級目標識別碼。 這是正在套用至資料庫的服務等級目標。 成功更新之後，它會符合 currentServiceObjectiveId 屬性的值。 如果 requestedServiceObjectiveId 和 requestedServiceObjectiveName 都已更新，requestedServiceObjectiveId 的值會覆寫 requestedServiceObjectiveName 的值。

SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的服務目標標識碼，請使用 Capabilities_ListByLocation REST API。		 字串

約束：
最小長度 = 36
最大長度 = 36
模式 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
requestedServiceObjectiveName 資料庫所設定服務等級目標的名稱。 這是正在套用至資料庫的服務等級目標。 成功更新之後，它會符合 serviceLevelObjective 屬性的值。

SKU 清單可能會因區域和支援供應項目而異。 若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 sku 可供您在 Azure 區域中的訂用帳戶使用，請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：

Azure CLI：
az sql db list-editions -l {location} -o table



Azure PowerShell：
Get-AzSqlServerServiceObjective -Location {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 值。 字串
sampleName 指出建立此資料庫時所要套用的範例架構名稱。 如果 createMode 不是 Default，則會忽略此值。 DataWarehouse 版本不支援。 'AdventureWorksLT'
sourceDatabaseDeletionDate 條件。 如果 createMode 為 Restore，且 sourceDatabaseId 是已刪除的資料庫原始資源標識碼，當資料庫存在時 (與其目前可還原的已卸除資料庫標識碼) ，則需要此值。 指定刪除資料庫的時間。 字串
sourceDatabaseId 條件。 如果 createMode 是 Copy、NonReadableSecondary、OnlineSecondary、PointInTimeRestore、Recovery 或 Restore，則需要此值。 指定源資料庫的資源識別碼。 如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，源資料庫的名稱必須與所建立的新資料庫相同。 字串
zoneRedundant 不論此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。 bool

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
使用 SQL Database 的 Django 應用程式

部署至 Azure		 此範本會使用 Azure Linux CustomScript 擴充功能來部署應用程式。 此範例會建立Ubuntu VM、執行 Python、Django 和 Apache 的無訊息安裝，然後建立簡單的 Django 應用程式。 此範例也會建立 SQL Database，其中包含一些使用查詢在網頁瀏覽器中顯示的範例數據表
Azure 中的 EPiserverCMS

部署至 Azure		 此範本可讓您在 Azure 中建立 EpiServerCMS 部署所需的資源
使用 Azure SQL Database 自動調整 LANSA Windows VM ScaleSet

部署至 Azure		 此範本會部署 Windows VMSS，其中包含擴展集中所需的 VM 計數，以及安裝到每個 VM 中的 LANSA MSI。 部署 VM 擴展集之後，會使用自定義腳本擴充功能來安裝 LANSA MSI)
使用試用版授權部署 Octopus Deploy 3.0

部署至 Azure		 此範本可讓您部署具有試用授權的單一 Octopus Deploy 3.0 伺服器。 這會部署在單一 Windows Server 2012R2 VM (Standard D2) 和 SQL DB (S1 層) 到資源群組指定的位置。
Orchard CMS 影片入口網站 Web 應用程式

部署至 Azure		 此範本可讓您輕鬆地在已啟用和設定 Azure 媒體服務模組的 Azure App 服務 Web Apps 上部署 Orchard CMS。
可調整的 Umbraco CMS Web 應用程式

部署至 Azure		 此範本可讓您輕鬆地在 Azure App 服務 Web Apps 上部署 umbraco CMS Web 應用程式。
簡單 Umbraco CMS Web 應用程式

部署至 Azure		 此範本可讓您輕鬆地在 Azure App 服務 Web Apps 上部署 umbraco CMS Web 應用程式。
Enterprise Governance-AppService、SQL DB、AD、OMS、Runbook

部署至 Azure		 企業或大型的雲端採用需要負責任且有效率的治理模型，才能從其雲端部署衍生價值。 CloudWise (解決方案) 的程式代碼名稱，是 Azure 合作夥伴快速入門中提供的複合解決方案，是客戶、系統整合者和合作夥伴的採用啟用者，可提供自助式、自動化的治理和作業解決方案，著重於優化成本、改善應用程式 () 可靠性、降低商務風險。 此解決方案強調可見度和控制的核心治理要素。
使用 ILB ASE 的 eShop 網站

部署至 Azure		 App Service 環境是 Azure App Service 的進階服務方案選項，提供完全隔離的專用環境，能夠極為安全地執行 Azure App Service 應用程式，包括 Web Apps、Mobile Apps 和 API Apps。
使用 Azure SQL 私人端點的 WebApp

部署至 Azure		 此範本示範如何建立 Web 應用程式，以取用指向 Azure SQL Server 的私人端點
具有高可用性的遠端桌面服務

部署至 Azure		 此 ARM 範例程式代碼會部署具有高可用性的 遠端桌面服務 2019 工作階段集合 實驗室。 目標是使用 Windows Server 2019 部署遠端桌面服務的完整備援高可用性解決方案。
在 Azure 架構上部署運動分析

部署至 Azure		 建立已啟用 ADLS Gen 2 的 Azure 記憶體帳戶、具有記憶體帳戶連結服務的 Azure Data Factory 實例， (部署) 和 Azure Databricks 實例 Azure SQL 資料庫。 部署範本的使用者 AAD 身分識別和 ADF 實例的受控識別，將會獲得記憶體帳戶上的記憶體 Blob 數據參與者角色。 另外還有一個選項可用來部署 Azure 金鑰保存庫 實例、Azure SQL 資料庫，以及用於串流使用案例的 Azure 事件中樞 () 。 部署 Azure 金鑰保存庫 時，部署範本之用戶的數據處理站受控識別和 AAD 身分識別將會獲得 金鑰保存庫 秘密使用者角色。
具有 SQL Database、Azure Cosmos DB、Azure 搜尋服務的 Web 應用程式

部署至 Azure		 此範本會布建 Web 應用程式、SQL Database、Azure Cosmos DB、Azure 搜尋服務和 Application Insights。
使用 Azure DMS 遷移至 Azure SQL 資料庫

部署至 Azure		 Azure 資料移轉服務 (DMS) 的設計目的是簡化將內部部署資料庫移轉至 Azure 的程式。 DMS 會簡化將現有的內部部署 SQL Server 和 Oracle 資料庫移轉至 Azure 虛擬機中的 Azure SQL 資料庫、Azure SQL 受控執行個體 或 Microsoft SQL Server。 此範本會部署 Azure 資料庫移轉服務的實例、已安裝 SQL Server 的 Azure VM，其會作為其上預先建立之資料庫的來源伺服器，以及目標 Azure SQL DB 伺服器，其具有要從來源移轉至目標伺服器的預先建立資料庫架構。 此範本也會部署所需的資源，例如 NIC、vnet 等，以支援來源 VM、DMS 服務和目標伺服器。
具有 VNET 中自定義 Ambari + Hive 中繼存放區 DB 的 HDInsight

部署至 Azure		 此範本可讓您使用新的 SQL DB，在現有的虛擬網路中建立 HDInsight 叢集，以做為自定義 Ambari DB 和 Hive 中繼存放區。 您必須擁有現有的 SQL Sever、記憶體帳戶和 VNET。
部署 HDInsight 叢集和 SQL 資料庫

部署至 Azure		 此範本可讓您建立 HDInsight 叢集和測試 Sqoop 的 SQL Database。
私人端點範例

部署至 Azure		 此範本示範如何建立指向 Azure SQL Server 的私人端點
寫入事件中樞的稽核 Azure SQL 伺服器

部署至 Azure		 此範本可讓您部署已啟用稽核的 Azure SQL 伺服器，以將稽核記錄寫入事件中樞
已將稽核寫入Log Analytics的 Azure SQL Server

部署至 Azure		 此範本可讓您部署已啟用稽核的 Azure SQL 伺服器，以將稽核記錄寫入 Log Analytics (OMS 工作區)
具有透明加密的專用SQL集區

部署至 Azure		 使用透明數據加密建立 SQL Server 和專用 SQL 集區 (先前稱為 SQL DW) 。
建立 SQL Server 和資料庫

部署至 Azure		 此範本可讓您建立 SQL Database和伺服器。
使用 TDE 布建 SQL Database

部署至 Azure		 此範本會布建已針對 Azure 流量開啟防火牆的 SQL Server，以及具有透明數據加密的 SQL 資料庫 (TDE) 。
部署新的 SQL 彈性集區

部署至 Azure		 此範本可讓您部署新的 SQL 彈性集區及其新的相關聯 SQL Server，以及要指派給它的新 SQL Database。
使用故障轉移群組建立 Azure SQL 伺服器和資料庫

部署至 Azure		 建立兩個 Azure SQL 伺服器、資料庫和故障轉移群組。
使用 Azure SQL 後端 App Service 環境

部署至 Azure		 此範本會建立具有 Azure SQL 後端以及私人端點以及通常用於私人/隔離環境中相關聯資源的 App Service 環境。
使用 SQL Database 布建行動應用程式

部署至 Azure		 此範本會布建行動應用程式、SQL Database和通知中樞。 它會在資料庫和通知中樞的行動應用程式中設定 連接字串。
具有受控識別、SQL Server和 ΑΙ 的 Web 應用程式

部署至 Azure		 為應用程式 + 資料 + 受控識別 + 監視部署 Azure 基礎結構的簡單範例
使用範本建立 Web 應用程式 + Redis 快取 + SQL DB

部署至 Azure		 此範本會建立具有 Redis 快取和 SQL Database 的 Azure Web 應用程式。
使用 SQL Database 布建 Web 應用程式

部署至 Azure		 此範本會布建 Web 應用程式、SQL Database、自動調整設定、警示規則和 App Insights。 它會在資料庫的 Web 應用程式中設定 連接字串。
建立、設定 Web 應用程式並將其部署至 Azure VM

部署至 Azure		 使用 SQL Azure 資料庫建立及設定 Windows VM，並使用 PowerShell DSC 將 Web 應用程式部署至環境
使用 Azure SQL 在 Linux 上使用 Sonarqube Docker Web 應用程式

部署至 Azure		 此範本會使用官方 Sonarqube 映像，並將 Sonarqube 部署在 Azure App 服務 Web 應用程式 Linux 容器中，並由 Azure SQL Server 支援。

ARM 範本資源定義

伺服器/資料庫資源類型可以使用目標作業進行部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.Sql/servers/databases 資源，請將下列 JSON 新增至您的範本。

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2014-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "collation": "string",
    "createMode": "string",
    "edition": "string",
    "elasticPoolName": "string",
    "maxSizeBytes": "string",
    "readScale": "string",
    "recoveryServicesRecoveryPointResourceId": "string",
    "requestedServiceObjectiveId": "string",
    "requestedServiceObjectiveName": "string",
    "restorePointInTime": "string",
    "sampleName": "AdventureWorksLT",
    "sourceDatabaseDeletionDate": "string",
    "sourceDatabaseId": "string",
    "zoneRedundant": "bool"
  }
}

屬性值

servers/databases

名稱 描述 值
類型 資源類型 'Microsoft.Sql/servers/databases'
apiVersion 資源 API 版本 '2014-04-01'
NAME 資源名稱

瞭解如何在 JSON ARM 範本中設定子資源的名稱和類型。		 需要字串 ()

字元限制：1-128

合法字元：
不能使用：
<>*%&:\/? 或控制字元

不能以句號或空格結尾。
location 資源位置。 需要字串 ()
tags 資源標籤。 標記名稱和值的字典。 請參閱 範本中的標籤
properties 代表資源的屬性。 DatabaseProperties

DatabaseProperties

名稱 描述 值
collation 資料庫的定序。 如果 createMode 不是 Default，則會忽略此值。 字串
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'
edition 資料庫的版本。 DatabaseEditions 列舉包含所有有效的版本。 如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，則會忽略此值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 SKU 可供您在 Azure 區域中的訂用帳戶使用，請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：

Azure CLI：
az sql db list-editions -l {location} -o table



Azure PowerShell：
Get-AzSqlServerServiceObjective -Location {location}

 'Basic'
'Business'
'BusinessCritical'
'DataWarehouse'
'Free'
'GeneralPurpose'
'超大規模資料庫'
'Premium'
'PremiumRS'
'Standard'
'Stretch'
'System'
'System2'
'Web'
elasticPoolName 資料庫所在的彈性集區名稱。 如果 elasticPoolName 和 requestedServiceObjectiveName 都更新，則會忽略 requestedServiceObjectiveName 的值。 DataWarehouse 版本不支援。 字串
maxSizeBytes 以位元組表示的資料庫大小上限。 如果 createMode 不是 Default，則會忽略此值。 若要查看可能的值，請查詢功能 API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) operationId 所參考的功能：“Capabilities_ListByLocation”。 字串
readScale 條件。 如果資料庫是異地輔助資料庫，readScale 會指出是否允許此資料庫的唯讀連線。 DataWarehouse 版本不支援。 'Disabled'
'Enabled'
recoveryServicesRecoveryPointResourceId 條件。 如果 createMode 是 RestoreLongTermRetentionBackup，則需要此值。 指定要從中還原之恢復點的資源標識碼。 字串
requestedServiceObjectiveId 資料庫的已設定服務等級目標識別碼。 這是在套用至資料庫的過程中的服務等級目標。 成功更新之後，它會符合 currentServiceObjectiveId 屬性的值。 如果 requestedServiceObjectiveId 和 requestedServiceObjectiveName 都會更新，requestedServiceObjectiveId 的值會覆寫 requestedServiceObjectiveName 的值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 Azure 區域中訂用帳戶可用的服務目標標識碼，請使用 Capabilities_ListByLocation REST API。		 字串

約束：
最小長度 = 36
最大長度 = 36
模式 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
requestedServiceObjectiveName 資料庫所設定服務等級目標的名稱。 這是在套用至資料庫的過程中的服務等級目標。 成功更新之後，它會符合 serviceLevelObjective 屬性的值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 SKU 可供您在 Azure 區域中的訂用帳戶使用，請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：

Azure CLI：
az sql db list-editions -l {location} -o table



Azure PowerShell：
Get-AzSqlServerServiceObjective -Location {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 值。 字串
sampleName 指出建立此資料庫時要套用的範例架構名稱。 如果 createMode 不是 Default，則會忽略此值。 DataWarehouse 版本不支援。 'AdventureWorksLT'
sourceDatabaseDeletionDate 條件。 如果 createMode 為 Restore，而且 sourceDatabaseId 是已刪除資料庫的原始資源標識碼，當資料庫存在時 (與其目前的可還原卸除資料庫標識碼) ，則需要此值。 指定刪除資料庫的時間。 字串
sourceDatabaseId 條件。 如果 createMode 是 Copy、NonReadableSecondary、OnlineSecondary、PointInTimeRestore、Recovery 或 Restore，則需要此值。 指定源資料庫的資源識別碼。 如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，源資料庫的名稱必須與所建立的新資料庫相同。 字串
zoneRedundant 不論此資料庫是否為區域備援，這表示此資料庫的複本將會分散到多個可用性區域。 bool

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
具有 SQL Database 的 Django 應用程式

部署至 Azure		 此範本會使用 Azure Linux CustomScript 擴充功能來部署應用程式。 此範例會建立Ubuntu VM、執行 Python、Django 和 Apache 的無訊息安裝，然後建立簡單的 Django 應用程式。 此範例也會建立 SQL Database，其中包含一些使用查詢在網頁瀏覽器中顯示的範例數據表
Azure 中的 EPiserverCMS

部署至 Azure		 此範本可讓您在 Azure 中建立 EpiServerCMS 部署所需的資源
使用 Azure SQL Database 自動調整 LANSA Windows VM ScaleSet

部署至 Azure		 此範本會部署 Windows VMSS，其中包含擴展集中所需的 VM 計數，以及安裝到每個 VM 中的 LANSA MSI。 部署 VM 擴展集之後，會使用自定義腳本擴充功能來安裝 LANSA MSI)
使用試用版授權部署 Octopus Deploy 3.0

部署至 Azure		 此範本可讓您部署具有試用授權的單一 Octopus Deploy 3.0 伺服器。 這會部署在單一 Windows Server 2012R2 VM (Standard D2) 和 SQL DB (S1 層) 到資源群組指定的位置。
Orchard CMS 影片入口網站 Web 應用程式

部署至 Azure		 此範本可讓您輕鬆地在已啟用和設定 Azure 媒體服務模組的 Azure App 服務 Web Apps 上部署 Orchard CMS。
可調整的 Umbraco CMS Web 應用程式

部署至 Azure		 此範本提供在 Azure App 服務 Web Apps 上部署 umbraco CMS Web 應用程式的簡單方式。
簡單 Umbraco CMS Web 應用程式

部署至 Azure		 此範本提供在 Azure App 服務 Web Apps 上部署 umbraco CMS Web 應用程式的簡單方式。
Enterprise Governance-AppService、SQL DB、AD、OMS、Runbook

部署至 Azure		 企業或大型的雲端採用需要負責任且有效率的治理模型，才能從其雲端部署衍生價值。 CloudWise (解決方案) 的程式代碼名稱，是 Azure 合作夥伴快速入門中提供的複合解決方案，是客戶、系統整合者和合作夥伴的採用啟用者，可提供自助式、自動化的治理和作業解決方案，著重於優化成本、改善應用程式 () 可靠性、降低商務風險。 此解決方案強調可見度和控制的核心治理要素。
使用 ILB ASE 的 eShop 網站

部署至 Azure		 App Service 環境是 Azure App Service 的進階服務方案選項，提供完全隔離的專用環境，能夠極為安全地執行 Azure App Service 應用程式，包括 Web Apps、Mobile Apps 和 API Apps。
取用 Azure SQL 私人端點的 WebApp

部署至 Azure		 此範本示範如何建立 Web 應用程式，以取用指向 Azure SQL Server 的私人端點
具有高可用性的遠端桌面服務

部署至 Azure		 此 ARM 範例程式代碼會部署具有高可用性的 遠端桌面服務 2019 工作階段集合 實驗室。 目標是使用 Windows Server 2019 部署遠端桌面服務的完整備援高可用性解決方案。
在 Azure 架構上部署運動分析

部署至 Azure		 建立已啟用 ADLS Gen 2 的 Azure 記憶體帳戶、具有記憶體帳戶連結服務的 Azure Data Factory 實例， (部署) 和 Azure Databricks 實例時 Azure SQL 資料庫。 部署範本的使用者 AAD 身分識別和 ADF 實例的受控識別，將會獲得記憶體帳戶上的記憶體 Blob 數據參與者角色。 您也可以選擇部署 Azure 金鑰保存庫 實例、Azure SQL 資料庫，以及用於串流使用案例的 Azure 事件中樞 () 。 部署 Azure 金鑰保存庫 時，部署範本的用戶數據處理站受控識別和 AAD 身分識別將會獲得 金鑰保存庫 秘密使用者角色。
具有 SQL Database、Azure Cosmos DB、Azure 搜尋服務的 Web 應用程式

部署至 Azure		 此範本會布建 Web 應用程式、SQL Database、Azure Cosmos DB、Azure 搜尋服務和 Application Insights。
使用 Azure DMS 遷移至 Azure SQL 資料庫

部署至 Azure		 Azure 資料移轉服務 (DMS) 的設計目的是簡化將內部部署資料庫移轉至 Azure 的程式。 DMS 會簡化將現有的內部部署 SQL Server 和 Oracle 資料庫移轉至 Azure 虛擬機中的 Azure SQL 資料庫、Azure SQL 受控執行個體 或 Microsoft SQL Server。 此範本會部署 Azure 資料庫移轉服務的實例、已安裝 SQL Server 的 Azure VM，其會作為來源伺服器，其中包含預先建立的資料庫，以及目標 Azure SQL DB 伺服器，其具有要從來源移轉至目標伺服器的預先建立資料庫架構。 此範本也會部署所需的資源，例如 NIC、vnet 等，以支援來源 VM、DMS 服務和目標伺服器。
具有 VNET 中自定義 Ambari + Hive 中繼存放區 DB 的 HDInsight

部署至 Azure		 此範本可讓您使用新的 SQL DB，在現有的虛擬網路中建立 HDInsight 叢集，以做為自定義 Ambari DB 和 Hive 中繼存放區。 您必須擁有現有的 SQL Sever、記憶體帳戶和 VNET。
部署 HDInsight 叢集和 SQL 資料庫

部署至 Azure		 此範本可讓您建立 HDInsight 叢集和測試 Sqoop 的 SQL Database。
私人端點範例

部署至 Azure		 此範本示範如何建立指向 Azure SQL Server 的私人端點
寫入事件中樞的稽核 Azure SQL 伺服器

部署至 Azure		 此範本可讓您部署已啟用稽核的 Azure SQL 伺服器，以將稽核記錄寫入事件中樞
Azure SQL 寫入 Log Analytics 稽核的伺服器

部署至 Azure		 此範本可讓您部署已啟用稽核的 Azure SQL 伺服器，以將稽核記錄寫入 Log Analytics (OMS 工作區)
具有透明加密的專用SQL集區

部署至 Azure		 使用透明數據加密建立 SQL Server 和專用 SQL 集區 (先前稱為 SQL DW) 。
建立 SQL Server 和資料庫

部署至 Azure		 此範本可讓您建立 SQL Database和伺服器。
使用 TDE 布建 SQL Database

部署至 Azure		 此範本會布建已針對 Azure 流量開啟防火牆的 SQL Server，以及具有透明數據加密的 SQL 資料庫 (TDE) 。
部署新的 SQL 彈性集區

部署至 Azure		 此範本可讓您部署新的 SQL 彈性集區及其新的相關聯 SQL Server 和新的 SQL Database 來指派給它。
使用故障轉移群組建立 Azure SQL 伺服器和資料庫

部署至 Azure		 建立兩個 Azure SQL 伺服器、資料庫和故障轉移群組。
使用 Azure SQL 後端 App Service 環境

部署至 Azure		 此範本會建立具有 Azure SQL 後端以及私人端點以及通常用於私人/隔離環境中相關聯資源的 App Service 環境。
使用 SQL Database 布建行動應用程式

部署至 Azure		 此範本會布建行動應用程式、SQL Database和通知中樞。 它會在資料庫和通知中樞的行動應用程式中設定 連接字串。
具有受控識別、SQL Server和 ΑΙ 的 Web 應用程式

部署至 Azure		 為應用程式 + 資料 + 受控識別 + 監視部署 Azure 基礎結構的簡單範例
使用範本建立 Web 應用程式 + Redis 快取 + SQL DB

部署至 Azure		 此範本會建立具有 Redis 快取和 SQL Database 的 Azure Web 應用程式。
使用 SQL Database 布建 Web 應用程式

部署至 Azure		 此範本會布建 Web 應用程式、SQL Database、自動調整設定、警示規則和 App Insights。 它會在資料庫的 Web 應用程式中設定 連接字串。
建立、設定及部署 Web 應用程式至 Azure VM

部署至 Azure		 使用 powerShell DSC 建立及設定具有 SQL Azure 資料庫的 Windows VM，並使用 PowerShell DSC 將 Web 應用程式部署至環境
使用 Azure SQL 在 Linux 上使用 Sonarqube Docker Web 應用程式

部署至 Azure		 此範本會使用官方 Sonarqube 映像，並將 Sonarqube 部署在 Azure App 服務 Web 應用程式 Linux 容器中，並由 Azure SQL 伺服器支援。

Terraform (AzAPI 提供者) 資源定義

伺服器/資料庫資源類型可以使用目標作業來部署：

  • 資源群組

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。

資源格式

若要建立 Microsoft.Sql/servers/databases 資源，請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2014-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      collation = "string"
      createMode = "string"
      edition = "string"
      elasticPoolName = "string"
      maxSizeBytes = "string"
      readScale = "string"
      recoveryServicesRecoveryPointResourceId = "string"
      requestedServiceObjectiveId = "string"
      requestedServiceObjectiveName = "string"
      restorePointInTime = "string"
      sampleName = "AdventureWorksLT"
      sourceDatabaseDeletionDate = "string"
      sourceDatabaseId = "string"
      zoneRedundant = bool
    }
  })
}

屬性值

servers/databases

名稱 描述 值
類型 資源類型 “Microsoft.Sql/servers/databases@2014-04-01”
NAME 資源名稱 字串 (必要)

字元限制：1-128

合法字元：
不能使用：
<>*%&:\/? 或控制字元

不能以句號或空格結尾。
location 資源位置。 字串 (必要)
parent_id 此資源之父系的資源標識碼。 類型資源的識別碼： 伺服器
tags 資源標籤。 標記名稱和值的字典。
properties 代表資源的屬性。 DatabaseProperties

DatabaseProperties

名稱 描述 值
collation 資料庫的定序。 如果 createMode 不是 Default，則會忽略此值。 字串
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”
edition 資料庫的版本。 DatabaseEditions 列舉包含所有有效的版本。 如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，則會忽略此值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 SKU 可供您在 Azure 區域中的訂用帳戶使用，請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：

Azure CLI：
az sql db list-editions -l {location} -o table



Azure PowerShell：
Get-AzSqlServerServiceObjective -Location {location}

 "Basic"
“Business”
“BusinessCritical”
“DataWarehouse”
“Free”
“GeneralPurpose”
“超大規模數據庫”
“Premium”
“PremiumRS”
“Standard”
“Stretch”
“System”
“System2”
"Web"
elasticPoolName 資料庫所在的彈性集區名稱。 如果 elasticPoolName 和 requestedServiceObjectiveName 都更新，則會忽略 requestedServiceObjectiveName 的值。 DataWarehouse 版本不支援。 字串
maxSizeBytes 以位元組表示的資料庫大小上限。 如果 createMode 不是 Default，則會忽略此值。 若要查看可能的值，請查詢功能 API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) operationId 所參考的功能：“Capabilities_ListByLocation”。 字串
readScale 條件。 如果資料庫是異地輔助資料庫，readScale 會指出是否允許此資料庫的唯讀連線。 DataWarehouse 版本不支援。 “Disabled”
“Enabled”
recoveryServicesRecoveryPointResourceId 條件。 如果 createMode 是 RestoreLongTermRetentionBackup，則需要此值。 指定要從中還原之恢復點的資源標識碼。 字串
requestedServiceObjectiveId 資料庫的已設定服務等級目標識別碼。 這是在套用至資料庫的過程中的服務等級目標。 成功更新之後，它會符合 currentServiceObjectiveId 屬性的值。 如果 requestedServiceObjectiveId 和 requestedServiceObjectiveName 都會更新，requestedServiceObjectiveId 的值會覆寫 requestedServiceObjectiveName 的值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 Azure 區域中訂用帳戶可用的服務目標標識碼，請使用 Capabilities_ListByLocation REST API。		 字串

約束：
最小長度 = 36
最大長度 = 36
模式 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
requestedServiceObjectiveName 資料庫所設定服務等級目標的名稱。 這是在套用至資料庫的過程中的服務等級目標。 成功更新之後，它會符合 serviceLevelObjective 屬性的值。

SKU 清單可能會因區域和支援供應專案而有所不同。 若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 SKU 可供您在 Azure 區域中的訂用帳戶使用，請使用 Capabilities_ListByLocation REST API 或下列其中一個命令：

Azure CLI：
az sql db list-editions -l {location} -o table



Azure PowerShell：
Get-AzSqlServerServiceObjective -Location {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 值。 字串
sampleName 指出建立此資料庫時所要套用的範例架構名稱。 如果 createMode 不是 Default，則會忽略此值。 DataWarehouse 版本不支援。 “AdventureWorksLT”
sourceDatabaseDeletionDate 條件。 如果 createMode 為 Restore，且 sourceDatabaseId 是已刪除的資料庫原始資源標識碼，當資料庫存在時 (與其目前可還原的已卸除資料庫標識碼) ，則需要此值。 指定刪除資料庫的時間。 字串
sourceDatabaseId 條件。 如果 createMode 是 Copy、NonReadableSecondary、OnlineSecondary、PointInTimeRestore、Recovery 或 Restore，則需要此值。 指定源資料庫的資源識別碼。 如果 createMode 為 NonReadableSecondary 或 OnlineSecondary，源資料庫的名稱必須與所建立的新資料庫相同。 字串
zoneRedundant 不論此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。 bool