Microsoft. SQL-servrar/databaser 2014-04-01

Bicep-resursdefinition

Resurstypen servrar/databaser kan distribueras med åtgärder som mål:

• Resursgrupper – Se resursgruppsdistributionskommandon

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

För att skapa en Microsoft. SQL/servrar/databaser, lägg till följande Bicep i din mall.

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'
  }
}

Egenskapsvärden

Microsoft. SQL/servrar/databaser

DatabaseProperties

| Namn | Beskrivning | Värde | | ---- | ----------- | ------------ | | sortering | Sortering av databasen. Om createMode inte är Standard ignoreras det här värdet. | sträng | | | createMode | Anger läget för att skapa databasen.

Standard: skapande av vanlig databas.

Kopiera: skapar en databas som en kopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för källdatabasen.

OnlineSecondary/NonReadableSecondary: skapar en databas som en (läsbar eller icke-läsbar) sekundär replik av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga primära databasen.

PointInTimeRestore: Skapar en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga databasen och restorePointInTime måste anges.

Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. sourceDatabaseId måste anges som det återställningsbara databasresurs-ID som ska återställas.

Återställ: Skapar en databas genom att återställa en säkerhetskopia av en borttagen databas. sourceDatabaseId måste anges. Om sourceDatabaseId är databasens ursprungliga resurs-ID måste källanDatabaseDeletionDate anges. Annars måste sourceDatabaseId vara det återställningsbara borttagna databasresurs-ID:t och sourceDatabaseDeletionDate ignoreras. restorePointInTime kan också anges för återställning från en tidigare tidpunkt.

RestoreLongTermRetentionBackup: Skapar en databas genom att återställa från ett långsiktigt kvarhållningsvalv. recoveryServicesRecoveryPointResourceId måste anges som resurs-ID för återställningspunkten.

Copy, NonReadableSecondary, OnlineSecondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition. | "Kopiera"
'Default'
'NonReadableSecondary'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
"RestoreLongTermRetentionBackup" | | | edition | Databasens utgåva. DatabaseEditions-uppräkningen innehåller alla giltiga utgåvor. Om createMode är NonReadableSecondary eller OnlineSecondary ignoreras det här värdet.

Listan över SKU:er kan variera beroende på region och supporterbjudande. För att bestämma vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure region, använd Capabilities_ListByLocation REST API eller ett av följande kommandon:

azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />````<br /><br />PowerShell PowerShell
<Get-AzSqlServerServiceObjective -Location plats>
| 'Basic'<br />'Business'<br />'BusinessCritical'<br />'DataWarehouse'<br />'Free'<br />'GeneralPurpose'<br />'Hyperscale'<br />'Premium'<br />'PremiumRS'<br />'Standard'<br />'Stretch'<br />'System'<br />'System2'<br />'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'<br />'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.<br /><br />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 <br /><br />Constraints:<br />Min length = 36<br />Max length = 36<br />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. <br /><br />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:<br /><br />```azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />

```powershell
<Get-AzSqlServerServiceObjective -Location plats>
```` | "Grundläggande"
'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 | Villkorlig. Om createMode är PointInTimeRestore krävs det här värdet. Om createMode är Återställ är det här värdet valfritt. Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen. Måste vara större än eller lika med källdatabasens tidigasteRestoreDate-värde. | sträng | | | sampleName | Anger namnet på exempelschemat som ska tillämpas när du skapar den här databasen. Om createMode inte är Standard ignoreras det här värdet. Stöds inte för DataWarehouse-utgåvan. | "AdventureWorksLT" | | sourceDatabaseDeletionDate | Villkorlig. Om createMode är Återställ och sourceDatabaseId är den borttagna databasens ursprungliga resurs-ID när det fanns (i motsats till dess aktuella återställningsbara borttagna databas-ID) krävs det här värdet. Anger den tid då databasen togs bort. | sträng | | | sourceDatabaseId | Villkorlig. Om createMode är Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery eller Restore krävs det här värdet. Anger källdatabasens resurs-ID. Om createMode är NonReadableSecondary eller OnlineSecondary måste namnet på källdatabasen vara detsamma som den nya databas som skapas. | sträng | | | zoneRedundant | Om den här databasen är zonredundant, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner. | Bool |

TrackedResourceTags

Användningsexempel

Bicep-prover

Ett grundläggande exempel på distribution av MS SQL Database.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@secure()
@description('The administrator login password for the SQL server')
param administratorLoginPassword string

resource server 'Microsoft.Sql/servers@2021-02-01-preview' = {
  name: resourceName
  location: location
  properties: {
    administratorLogin: 'mradministrator'
    administratorLoginPassword: null
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

resource database 'Microsoft.Sql/servers/databases@2021-02-01-preview' = {
  parent: server
  name: resourceName
  location: location
  properties: {
    autoPauseDelay: 0
    createMode: 'Default'
    elasticPoolId: ''
    highAvailabilityReplicaCount: 0
    isLedgerOn: false
    licenseType: 'LicenseIncluded'
    maintenanceConfigurationId: resourceId('Microsoft.Maintenance/publicMaintenanceConfigurations', 'SQL_Default')
    minCapacity: 0
    readScale: 'Disabled'
    requestedBackupStorageRedundancy: 'Geo'
    zoneRedundant: false
  }
}

Azure Verified Modules

Följande Azure Verifierade moduler kan användas för att distribuera denna resurstyp.

Azure Quickstart Samples

Följande Azure Quickstart-mallar innehåller Bicep exempel för att distribuera denna resurstyp.

Resursdefinition för ARM-mall

Resurstypen servrar/databaser kan distribueras med åtgärder som mål:

• Resursgrupper – Se resursgruppsdistributionskommandon

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

För att skapa en Microsoft. SQL/servrar/databaser, lägg till följande JSON i din mall.

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2014-04-01",
  "name": "string",
  "location": "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"
  }
}

Egenskapsvärden

Microsoft. SQL/servrar/databaser

DatabaseProperties

| Namn | Beskrivning | Värde | | ---- | ----------- | ------------ | | sortering | Sortering av databasen. Om createMode inte är Standard ignoreras det här värdet. | sträng | | | createMode | Anger läget för att skapa databasen.

Standard: skapande av vanlig databas.

Kopiera: skapar en databas som en kopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för källdatabasen.

OnlineSecondary/NonReadableSecondary: skapar en databas som en (läsbar eller icke-läsbar) sekundär replik av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga primära databasen.

PointInTimeRestore: Skapar en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga databasen och restorePointInTime måste anges.

Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. sourceDatabaseId måste anges som det återställningsbara databasresurs-ID som ska återställas.

Återställ: Skapar en databas genom att återställa en säkerhetskopia av en borttagen databas. sourceDatabaseId måste anges. Om sourceDatabaseId är databasens ursprungliga resurs-ID måste källanDatabaseDeletionDate anges. Annars måste sourceDatabaseId vara det återställningsbara borttagna databasresurs-ID:t och sourceDatabaseDeletionDate ignoreras. restorePointInTime kan också anges för återställning från en tidigare tidpunkt.

RestoreLongTermRetentionBackup: Skapar en databas genom att återställa från ett långsiktigt kvarhållningsvalv. recoveryServicesRecoveryPointResourceId måste anges som resurs-ID för återställningspunkten.

Copy, NonReadableSecondary, OnlineSecondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition. | "Kopiera"
'Default'
'NonReadableSecondary'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
"RestoreLongTermRetentionBackup" | | | edition | Databasens utgåva. DatabaseEditions-uppräkningen innehåller alla giltiga utgåvor. Om createMode är NonReadableSecondary eller OnlineSecondary ignoreras det här värdet.

Listan över SKU:er kan variera beroende på region och supporterbjudande. För att bestämma vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure region, använd Capabilities_ListByLocation REST API eller ett av följande kommandon:

azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />````<br /><br />PowerShell PowerShell
<Get-AzSqlServerServiceObjective -Location plats>
| 'Basic'<br />'Business'<br />'BusinessCritical'<br />'DataWarehouse'<br />'Free'<br />'GeneralPurpose'<br />'Hyperscale'<br />'Premium'<br />'PremiumRS'<br />'Standard'<br />'Stretch'<br />'System'<br />'System2'<br />'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'<br />'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.<br /><br />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 <br /><br />Constraints:<br />Min length = 36<br />Max length = 36<br />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. <br /><br />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:<br /><br />```azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />

```powershell
<Get-AzSqlServerServiceObjective -Location plats>
```` | "Grundläggande"
'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 | Villkorlig. Om createMode är PointInTimeRestore krävs det här värdet. Om createMode är Återställ är det här värdet valfritt. Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen. Måste vara större än eller lika med källdatabasens tidigasteRestoreDate-värde. | sträng | | | sampleName | Anger namnet på exempelschemat som ska tillämpas när du skapar den här databasen. Om createMode inte är Standard ignoreras det här värdet. Stöds inte för DataWarehouse-utgåvan. | "AdventureWorksLT" | | sourceDatabaseDeletionDate | Villkorlig. Om createMode är Återställ och sourceDatabaseId är den borttagna databasens ursprungliga resurs-ID när det fanns (i motsats till dess aktuella återställningsbara borttagna databas-ID) krävs det här värdet. Anger den tid då databasen togs bort. | sträng | | | sourceDatabaseId | Villkorlig. Om createMode är Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery eller Restore krävs det här värdet. Anger källdatabasens resurs-ID. Om createMode är NonReadableSecondary eller OnlineSecondary måste namnet på källdatabasen vara detsamma som den nya databas som skapas. | sträng | | | zoneRedundant | Om den här databasen är zonredundant, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner. | Bool |

TrackedResourceTags

Användningsexempel

Azure Quickstart Templates

Följande Azure Quickstart-mallar distribuerar denna resurstyp.

Template	Description
Azure SQL Server med Revision skrivet till Log Analytics	Denna mall låter dig distribuera en Azure SQL-server med Auditing aktiverat för att skriva revisionsloggar till Log Analytics (OMS workspace)
Skapa en SQL Server och databas	Med den här mallen kan du skapa SQL Database och Server.
Dedikerad SQL-pool med transparent kryptering	Skapar en SQL Server och en dedikerad SQL-pool (tidigare SQL DW) med Transparent Data Encryption.
Distribuera en ny SQL Elastic Pool	Denna mall låter dig distribuera en ny SQL Elastic Pool med dess nya tillhörande SQL Server och nya SQL-databaser att tilldela den.
Distribuera Sports Analytics på Azure arkitektur	Skapar ett Azure-lagringskonto med ADLS Gen 2 aktiverat, en Azure Data Factory-instans med länkade tjänster för lagringskontot (och Azure SQL Database om den är installerad), och en Azure Databricks-instans. AAD-identiteten för den användare som distribuerar mallen och den hanterade identiteten för ADF-instansen beviljas rollen Storage Blob Data Contributor för lagringskontot. Det finns också alternativ för att distribuera en Azure Key Vault-instans, en Azure SQL Database och en Azure Event Hub (för streaminganvändning). När en Azure Key Vault distribueras kommer den data factory-hanterade identiteten och AAD-identiteten för användaren som distribuerar mallen att tilldelas rollen Key Vault Secrets User.
HDInsight med anpassad Ambari + Hive Metastore DB i VNET	Med den här mallen kan du skapa ett HDInsight-kluster i ett befintligt virtuellt nätverk med en ny SQL DB som fungerar som både en anpassad Ambari DB och Hive Metastore. Du måste ha ett befintligt SQL Sever, lagringskonto och VNET.
Private Endpoint exempel	Denna mall visar hur man skapar en privat endpoint som pekar på Azure SQL Server
Provisionera en webbapp med en SQL-databas	Den här mallen etablerar en webbapp, en SQL Database, autoskalningsinställningar, aviseringsregler och App Insights. Den konfigurerar en reťazec pripojenia i webbappen för databasen.
Fjärrskrivbord Tjänster med hög tillgänglighet	Denna exempelkod för ARM-mallen kommer att distribuera ett Fjärrskrivbord Services 2019 Session Collection labb med hög tillgänglighet. Målet är att distribuera en helt redundant, högtillgänglig lösning för Fjärrskrivbord Services, med Windows Server 2019.
Sonarqube Docker Web App på Linux med Azure SQL	Denna mall distribuerar Sonarqube i en Azure App Service webbapplikation Linux-container med den officiella Sonarqube-bilden och backas upp av en Azure SQL Server.
Web App med hanterad identitet, SQL Server och ΑΙ	Enkelt exempel är att distribuera Azure-infrastruktur för app + data + hanterad identitet + övervakning
WebApp som använder en Azure SQL privat endpoint	Denna mall visar hur man skapar en webbapp som använder en privat slutpunkt som pekar på Azure SQL Server

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen servrar/databaser kan distribueras med åtgärder som mål:

• Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

För att skapa en Microsoft. SQL/servers/databasresurs, lägg till följande Terraform i din mall.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2014-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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
    }
  }
}

Egenskapsvärden

Microsoft. SQL/servrar/databaser

DatabaseProperties

| Namn | Beskrivning | Värde | | ---- | ----------- | ------------ | | sortering | Sortering av databasen. Om createMode inte är Standard ignoreras det här värdet. | sträng | | | createMode | Anger läget för att skapa databasen.

Standard: skapande av vanlig databas.

Kopiera: skapar en databas som en kopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för källdatabasen.

OnlineSecondary/NonReadableSecondary: skapar en databas som en (läsbar eller icke-läsbar) sekundär replik av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga primära databasen.

PointInTimeRestore: Skapar en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga databasen och restorePointInTime måste anges.

Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. sourceDatabaseId måste anges som det återställningsbara databasresurs-ID som ska återställas.

Återställ: Skapar en databas genom att återställa en säkerhetskopia av en borttagen databas. sourceDatabaseId måste anges. Om sourceDatabaseId är databasens ursprungliga resurs-ID måste källanDatabaseDeletionDate anges. Annars måste sourceDatabaseId vara det återställningsbara borttagna databasresurs-ID:t och sourceDatabaseDeletionDate ignoreras. restorePointInTime kan också anges för återställning från en tidigare tidpunkt.

RestoreLongTermRetentionBackup: Skapar en databas genom att återställa från ett långsiktigt kvarhållningsvalv. recoveryServicesRecoveryPointResourceId måste anges som resurs-ID för återställningspunkten.

Copy, NonReadableSecondary, OnlineSecondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition. | "Kopiera"
'Default'
'NonReadableSecondary'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
"RestoreLongTermRetentionBackup" | | | edition | Databasens utgåva. DatabaseEditions-uppräkningen innehåller alla giltiga utgåvor. Om createMode är NonReadableSecondary eller OnlineSecondary ignoreras det här värdet.

Listan över SKU:er kan variera beroende på region och supporterbjudande. För att bestämma vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure region, använd Capabilities_ListByLocation REST API eller ett av följande kommandon:

azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />````<br /><br />PowerShell PowerShell
<Get-AzSqlServerServiceObjective -Location plats>
| 'Basic'<br />'Business'<br />'BusinessCritical'<br />'DataWarehouse'<br />'Free'<br />'GeneralPurpose'<br />'Hyperscale'<br />'Premium'<br />'PremiumRS'<br />'Standard'<br />'Stretch'<br />'System'<br />'System2'<br />'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'<br />'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.<br /><br />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 <br /><br />Constraints:<br />Min length = 36<br />Max length = 36<br />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. <br /><br />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:<br /><br />```azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />

```powershell
<Get-AzSqlServerServiceObjective -Location plats>
```` | "Grundläggande"
'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 | Villkorlig. Om createMode är PointInTimeRestore krävs det här värdet. Om createMode är Återställ är det här värdet valfritt. Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen. Måste vara större än eller lika med källdatabasens tidigasteRestoreDate-värde. | sträng | | | sampleName | Anger namnet på exempelschemat som ska tillämpas när du skapar den här databasen. Om createMode inte är Standard ignoreras det här värdet. Stöds inte för DataWarehouse-utgåvan. | "AdventureWorksLT" | | sourceDatabaseDeletionDate | Villkorlig. Om createMode är Återställ och sourceDatabaseId är den borttagna databasens ursprungliga resurs-ID när det fanns (i motsats till dess aktuella återställningsbara borttagna databas-ID) krävs det här värdet. Anger den tid då databasen togs bort. | sträng | | | sourceDatabaseId | Villkorlig. Om createMode är Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery eller Restore krävs det här värdet. Anger källdatabasens resurs-ID. Om createMode är NonReadableSecondary eller OnlineSecondary måste namnet på källdatabasen vara detsamma som den nya databas som skapas. | sträng | | | zoneRedundant | Om den här databasen är zonredundant, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner. | Bool |

TrackedResourceTags

Användningsexempel

Terraform-exempel

Ett grundläggande exempel på distribution av MS SQL Database.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "administrator_login_password" {
  type        = string
  description = "The administrator login password for the SQL server"
  sensitive   = true
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "publicMaintenanceConfiguration" {
  type      = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = "SQL_Default"
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Sql/servers/databases@2021-02-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      autoPauseDelay                   = 0
      createMode                       = "Default"
      elasticPoolId                    = ""
      highAvailabilityReplicaCount     = 0
      isLedgerOn                       = false
      licenseType                      = "LicenseIncluded"
      maintenanceConfigurationId       = data.azapi_resource_id.publicMaintenanceConfiguration.id
      minCapacity                      = 0
      readScale                        = "Disabled"
      requestedBackupStorageRedundancy = "Geo"
      zoneRedundant                    = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Ett grundläggande exempel på distribution av MS SQL Database.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "administrator_login_password" {
  type        = string
  description = "The administrator login password for the SQL server"
  sensitive   = true
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "publicMaintenanceConfiguration" {
  type      = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = "SQL_Default"
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Sql/servers/databases@2021-02-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      autoPauseDelay                   = 0
      createMode                       = "Default"
      elasticPoolId                    = ""
      highAvailabilityReplicaCount     = 0
      isLedgerOn                       = false
      licenseType                      = "LicenseIncluded"
      maintenanceConfigurationId       = data.azapi_resource_id.publicMaintenanceConfiguration.id
      minCapacity                      = 0
      readScale                        = "Disabled"
      requestedBackupStorageRedundancy = "Geo"
      zoneRedundant                    = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}