Microsoft.Sql-servrar/databaser

Artikel
12/20/2024

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

Om du vill skapa en Microsoft.Sql/servers/databases-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Sql/servers/databases@2024-05-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    autoPauseDelay: int
    availabilityZone: 'string'
    catalogCollation: 'string'
    collation: 'string'
    createMode: 'string'
    elasticPoolId: 'string'
    encryptionProtector: 'string'
    encryptionProtectorAutoRotation: bool
    federatedClientId: 'string'
    freeLimitExhaustionBehavior: 'string'
    highAvailabilityReplicaCount: int
    isLedgerOn: bool
    keys: {
      {customized property}: {}
    }
    licenseType: 'string'
    longTermRetentionBackupResourceId: 'string'
    maintenanceConfigurationId: 'string'
    manualCutover: bool
    maxSizeBytes: int
    minCapacity: int
    performCutover: bool
    preferredEnclaveType: 'string'
    readScale: 'string'
    recoverableDatabaseId: 'string'
    recoveryServicesRecoveryPointId: 'string'
    requestedBackupStorageRedundancy: 'string'
    restorableDroppedDatabaseId: 'string'
    restorePointInTime: 'string'
    sampleName: 'string'
    secondaryType: 'string'
    sourceDatabaseDeletionDate: 'string'
    sourceDatabaseId: 'string'
    sourceResourceId: 'string'
    useFreeLimit: bool
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Egenskapsvärden

DatabaseIdentity

Namn	Beskrivning	Värde
typ	Identitetstypen	"Ingen" "UserAssigned"
userAssignedIdentities	Resurs-ID:n för de användartilldelade identiteter som ska användas	DatabaseIdentityUserAssignedIdentiteter

DatabaseIdentityUserAssignedIdentiteter

Namn	Beskrivning	Värde

DatabaseKey

Namn	Beskrivning	Värde

DatabaseProperties

Namn	Beskrivning	Värde
autoPauseDelay	Tid i minuter efter vilken databasen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverad	Int
availabilityZone	Anger tillgänglighetszonen som databasen är fäst på.	'1' '2' '3' "NoPreference"
catalogCollation	Sortering av metadatakatalogen.	"DATABASE_DEFAULT" "SQL_Latin1_General_CP1_CI_AS"
Sortering	Sortering av databasen.	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. Sekundär: skapar en databas som en 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, Secondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition.	"Kopiera" "Standard" "OnlineSecondary" "PointInTimeRestore" "Återställning" "Återställ" "RestoreExternalBackup" "RestoreExternalBackupSecondary" "RestoreLongTermRetentionBackup" "Sekundär"
elasticPoolId	Resursidentifieraren för den elastiska poolen som innehåller den här databasen.	sträng
encryptionProtector	Azure Key Vault-URI:n för databasen om den har konfigurerats med kundhanterade nycklar per databas.	sträng
encryptionProtectorAutoRotation	Flaggan för att aktivera eller inaktivera automatisk rotation av databaskrypteringsskydds-AKV-nyckel.	Bool
federatedClientId	Klient-ID:t som används för cmk-scenario mellan klientorganisationer per databas	sträng Begränsningar: Min längd = 36 Maximal längd = 36 Mönster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Anger beteendet när månatliga kostnadsfria gränser är uttömda för den kostnadsfria databasen. AutoPause: Databasen pausas automatiskt när de kostnadsfria gränserna överskrids under resten av månaden. BillForUsage: Databasen fortsätter att vara online vid överbelastning av kostnadsfria gränser och eventuell överförbrukning debiteras.	"Autopause" "BillOverUsage"
highAvailabilityReplicaCount	Antalet sekundära repliker som är associerade med databasen Business Critical, Premium eller Hyperscale Edition som används för att ge hög tillgänglighet. Gäller inte för en Hyperskala-databas i en elastisk pool.	Int
isLedgerOn	Om den här databasen är en transaktionsregisterdatabas, vilket innebär att alla tabeller i databasen är transaktionsregistertabeller. Obs! Värdet för den här egenskapen kan inte ändras när databasen har skapats.	Bool
Nycklar	Resurs-ID:n för de användartilldelade identiteter som ska användas	DatabasePropertiesKeys
licenseType	Den licenstyp som ska användas för den här databasen. `LicenseIncluded` om du behöver en licens eller `BasePrice` om du har en licens och är berättigad till Azure Hybrid-förmånen.	"BasePrice" "LicenseIncluded"
longTermRetentionBackupResourceId	Resursidentifieraren för den långsiktiga kvarhållningssäkerhetskopian som är associerad med att skapa den här databasen.	sträng
maintenanceConfigurationId	Underhållskonfigurations-ID som tilldelats databasen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.	sträng
manualCutover	Om kundkontrollerad manuell snabbhet måste utföras under uppdateringsdatabasåtgärden till Hyperskala-nivån eller inte. Den här egenskapen gäller endast vid skalning av databas från nivån Affärskritisk/Generell användning/Premium/Standard till Hyperskala-nivå. När manualCutover har angetts väntar skalningsåtgärden på att användarindata ska utlösa snabbhet i Hyperskala-databasen. Om du vill utlösa snabbhet anger du parametern "performCutover" när skalningsåtgärden är i vänteläge.	Bool
maxSizeBytes	Den maximala storleken på databasen uttryckt i byte.	Int
minCapacity	Minimal kapacitet som databasen alltid har allokerat, om den inte har pausats	Int
performCutover	För att utlösa kundkontrollerad manuell snabbhet under väntetillståndet medan skalningsåtgärden pågår. Den här egenskapsparametern gäller endast för skalningsåtgärder som initieras tillsammans med parametern "manualCutover". Den här egenskapen gäller endast vid skalning av databas från affärskritisk/generell användning/Premium/Standard-nivå till Hyperskala-nivå pågår redan. När performCutover har angetts utlöser skalningsåtgärden snabbhet och utför rolländring till Hyperskala-databas.	Bool
preferredEnclaveType	Typ av enklav som begärs i databasen, t.ex. standard enklaver eller VBS-enklaver.	"Standard" "VBS"
readScale	Tillståndet för skrivskyddad routning. Om det här alternativet är aktiverat kan anslutningar som har programmets avsikt inställd på skrivskyddad i anslutningssträngen dirigeras till en skrivskyddad sekundär replik i samma region. Gäller inte för en Hyperskala-databas i en elastisk pool.	"Inaktiverad" "Aktiverad"
recoverableDatabaseId	Resursidentifieraren för den återställningsbara databas som är associerad med den här databasens skapandeåtgärd.	sträng
recoveryServicesRecoveryPointId	Resursidentifieraren för återställningspunkten som är associerad med skapandeåtgärden för den här databasen.	sträng
requestedBackupStorageRedundancy	Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här databasen.	"Geo" "GeoZone" "Lokal" "Zon"
restorableDroppedDatabaseId	Resursidentifieraren för den återställningsbara borttagna databasen som är associerad med den här databasens skapandeåtgärd.	sträng
restorePointInTime	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.	sträng
sampleName	Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.	"AdventureWorksLT" "WideWorldImportersFull" "WideWorldImportersStd"
secondaryType	Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo, Named och Standby.	"Geo" "Namngivet" "Vänteläge"
sourceDatabaseDeletionDate	Anger den tid då databasen togs bort.	sträng
sourceDatabaseId	Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.	sträng
sourceResourceId	Resursidentifieraren för den källa som är associerad med skapandeåtgärden för den här databasen. Den här egenskapen stöds endast för DataWarehouse Edition och gör det möjligt att återställa mellan prenumerationer. När sourceResourceId har angetts får inte sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId och sourceDatabaseDeletionDate anges och CreateMode måste vara PointInTimeRestore, Restore eller Recover. När createMode är PointInTimeRestore måste sourceResourceId vara resurs-ID för den befintliga databasen eller den befintliga sql-poolen och restorePointInTime måste anges. När createMode är Återställning måste sourceResourceId vara resurs-ID för återställningsbar borttagen databas eller återställningsbar borttagen SQL-pool. När createMode är Återställ måste sourceResourceId vara resurs-ID för återställningsbar databas eller återställningsbar SQL-pool. När källprenumerationen tillhör en annan klientorganisation än målprenumerationen måste rubriken "x-ms-authorization-auxiliary" innehålla autentiseringstoken för källklientorganisationen. Mer information om rubriken "x-ms-authorization-auxiliary" finns i /azure/azure-resource-manager/management/authenticate-multi-tenant	sträng
useFreeLimit	Oavsett om databasen använder kostnadsfria månatliga gränser eller inte. Tillåts för en databas i en prenumeration.	Bool
zoneRedundant	Om den här databasen är zonredundant, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner.	Bool

DatabasePropertiesKeys

Namn	Beskrivning	Värde

DatabaseUserIdentity

Namn	Beskrivning	Värde

Microsoft.Sql/servers/databases

Namn	Beskrivning	Värde
identitet	Azure Active Directory-identiteten för databasen.	DatabaseIdentity
plats	Resursplats.	sträng (krävs)
Namn	Resursnamnet	sträng (krävs)
förälder	I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen. Mer information finns i Underordnad resurs utanför den överordnade resursen.	Symboliskt namn för resurs av typen: servrar
Egenskaper	Resursegenskaper.	DatabaseProperties
Sku	Databasens SKU. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa 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änder du `Capabilities_ListByLocation` REST API eller något av följande kommandon: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />powershell Get-AzSqlServerServiceObjective -Location <plats> ````	Sku
Taggar	Resurstaggar	Ordlista med taggnamn och värden. Se taggar i mallar

Sku

Namn	Beskrivning	Värde
kapacitet	Kapacitet för den specifika SKU:n.	Int
familj	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.	sträng
Namn	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.	sträng (krävs)
storlek	Storleken på den specifika SKU:n	sträng
Nivå	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.	sträng

TrackedResourceTags

Namn	Beskrivning	Värde

Snabbstartsexempel

Följande snabbstartsexempel distribuerar den här resurstypen.

Bicep-fil	Beskrivning
Azure SQL Server med granskning skriven till Log Analytics	Med den här mallen kan du distribuera en Azure SQL-server med Granskning aktiverat för att skriva granskningsloggar till Log Analytics (OMS-arbetsyta)
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 datakryptering.
Distribuera Sports Analytics på Azure Architecture	Skapar ett Azure Storage-konto med ADLS Gen 2 aktiverat, en Azure Data Factory-instans med länkade tjänster för lagringskontot (en Azure SQL Database om den distribueras) 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 användningsfall för direktuppspelning). När ett Azure Key Vault distribueras beviljas den hanterade identiteten för datafabriken och AAD-identiteten för den användare som distribuerar mallen rollen Key Vault-hemligheter.
exempel på privat slutpunkt	Den här mallen visar hur du skapar en privat slutpunkt som pekar på Azure SQL Server
Etablera en webbapp med en SQL Database-	Den här mallen etablerar en webbapp, en SQL Database, autoskalningsinställningar, aviseringsregler och App Insights. Den konfigurerar en anslutningssträng i webbappen för databasen.
Sonarqube Docker Web App på Linux med Azure SQL	Den här mallen distribuerar Sonarqube i en Azure App Service-webbapps Linux-container med hjälp av den officiella Sonarqube-avbildningen och backas upp av en Azure SQL Server.
webbapp med hanterad identitet, SQL Server och ΑΙ	Enkelt exempel för att distribuera Azure-infrastruktur för app + data + hanterad identitet + övervakning

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

Om du vill skapa en Microsoft.Sql/servers/databases-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2024-05-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "autoPauseDelay": "int",
    "availabilityZone": "string",
    "catalogCollation": "string",
    "collation": "string",
    "createMode": "string",
    "elasticPoolId": "string",
    "encryptionProtector": "string",
    "encryptionProtectorAutoRotation": "bool",
    "federatedClientId": "string",
    "freeLimitExhaustionBehavior": "string",
    "highAvailabilityReplicaCount": "int",
    "isLedgerOn": "bool",
    "keys": {
      "{customized property}": {
      }
    },
    "licenseType": "string",
    "longTermRetentionBackupResourceId": "string",
    "maintenanceConfigurationId": "string",
    "manualCutover": "bool",
    "maxSizeBytes": "int",
    "minCapacity": "int",
    "performCutover": "bool",
    "preferredEnclaveType": "string",
    "readScale": "string",
    "recoverableDatabaseId": "string",
    "recoveryServicesRecoveryPointId": "string",
    "requestedBackupStorageRedundancy": "string",
    "restorableDroppedDatabaseId": "string",
    "restorePointInTime": "string",
    "sampleName": "string",
    "secondaryType": "string",
    "sourceDatabaseDeletionDate": "string",
    "sourceDatabaseId": "string",
    "sourceResourceId": "string",
    "useFreeLimit": "bool",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Egenskapsvärden

DatabaseIdentity

Namn	Beskrivning	Värde
typ	Identitetstypen	"Ingen" "UserAssigned"
userAssignedIdentities	Resurs-ID:n för de användartilldelade identiteter som ska användas	DatabaseIdentityUserAssignedIdentiteter

DatabaseIdentityUserAssignedIdentiteter

Namn	Beskrivning	Värde

DatabaseKey

Namn	Beskrivning	Värde

DatabaseProperties

Namn	Beskrivning	Värde
autoPauseDelay	Tid i minuter efter vilken databasen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverad	Int
availabilityZone	Anger tillgänglighetszonen som databasen är fäst på.	'1' '2' '3' "NoPreference"
catalogCollation	Sortering av metadatakatalogen.	"DATABASE_DEFAULT" "SQL_Latin1_General_CP1_CI_AS"
Sortering	Sortering av databasen.	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. Sekundär: skapar en databas som en 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, Secondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition.	"Kopiera" "Standard" "OnlineSecondary" "PointInTimeRestore" "Återställning" "Återställ" "RestoreExternalBackup" "RestoreExternalBackupSecondary" "RestoreLongTermRetentionBackup" "Sekundär"
elasticPoolId	Resursidentifieraren för den elastiska poolen som innehåller den här databasen.	sträng
encryptionProtector	Azure Key Vault-URI:n för databasen om den har konfigurerats med kundhanterade nycklar per databas.	sträng
encryptionProtectorAutoRotation	Flaggan för att aktivera eller inaktivera automatisk rotation av databaskrypteringsskydds-AKV-nyckel.	Bool
federatedClientId	Klient-ID:t som används för cmk-scenario mellan klientorganisationer per databas	sträng Begränsningar: Min längd = 36 Maximal längd = 36 Mönster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Anger beteendet när månatliga kostnadsfria gränser är uttömda för den kostnadsfria databasen. AutoPause: Databasen pausas automatiskt när de kostnadsfria gränserna överskrids under resten av månaden. BillForUsage: Databasen fortsätter att vara online vid överbelastning av kostnadsfria gränser och eventuell överförbrukning debiteras.	"Autopause" "BillOverUsage"
highAvailabilityReplicaCount	Antalet sekundära repliker som är associerade med databasen Business Critical, Premium eller Hyperscale Edition som används för att ge hög tillgänglighet. Gäller inte för en Hyperskala-databas i en elastisk pool.	Int
isLedgerOn	Om den här databasen är en transaktionsregisterdatabas, vilket innebär att alla tabeller i databasen är transaktionsregistertabeller. Obs! Värdet för den här egenskapen kan inte ändras när databasen har skapats.	Bool
Nycklar	Resurs-ID:n för de användartilldelade identiteter som ska användas	DatabasePropertiesKeys
licenseType	Den licenstyp som ska användas för den här databasen. `LicenseIncluded` om du behöver en licens eller `BasePrice` om du har en licens och är berättigad till Azure Hybrid-förmånen.	"BasePrice" "LicenseIncluded"
longTermRetentionBackupResourceId	Resursidentifieraren för den långsiktiga kvarhållningssäkerhetskopian som är associerad med att skapa den här databasen.	sträng
maintenanceConfigurationId	Underhållskonfigurations-ID som tilldelats databasen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.	sträng
manualCutover	Om kundkontrollerad manuell snabbhet måste utföras under uppdateringsdatabasåtgärden till Hyperskala-nivån eller inte. Den här egenskapen gäller endast vid skalning av databas från nivån Affärskritisk/Generell användning/Premium/Standard till Hyperskala-nivå. När manualCutover har angetts väntar skalningsåtgärden på att användarindata ska utlösa snabbhet i Hyperskala-databasen. Om du vill utlösa snabbhet anger du parametern "performCutover" när skalningsåtgärden är i vänteläge.	Bool
maxSizeBytes	Den maximala storleken på databasen uttryckt i byte.	Int
minCapacity	Minimal kapacitet som databasen alltid har allokerat, om den inte har pausats	Int
performCutover	För att utlösa kundkontrollerad manuell snabbhet under väntetillståndet medan skalningsåtgärden pågår. Den här egenskapsparametern gäller endast för skalningsåtgärder som initieras tillsammans med parametern "manualCutover". Den här egenskapen gäller endast vid skalning av databas från affärskritisk/generell användning/Premium/Standard-nivå till Hyperskala-nivå pågår redan. När performCutover har angetts utlöser skalningsåtgärden snabbhet och utför rolländring till Hyperskala-databas.	Bool
preferredEnclaveType	Typ av enklav som begärs i databasen, t.ex. standard enklaver eller VBS-enklaver.	"Standard" "VBS"
readScale	Tillståndet för skrivskyddad routning. Om det här alternativet är aktiverat kan anslutningar som har programmets avsikt inställd på skrivskyddad i anslutningssträngen dirigeras till en skrivskyddad sekundär replik i samma region. Gäller inte för en Hyperskala-databas i en elastisk pool.	"Inaktiverad" "Aktiverad"
recoverableDatabaseId	Resursidentifieraren för den återställningsbara databas som är associerad med den här databasens skapandeåtgärd.	sträng
recoveryServicesRecoveryPointId	Resursidentifieraren för återställningspunkten som är associerad med skapandeåtgärden för den här databasen.	sträng
requestedBackupStorageRedundancy	Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här databasen.	"Geo" "GeoZone" "Lokal" "Zon"
restorableDroppedDatabaseId	Resursidentifieraren för den återställningsbara borttagna databasen som är associerad med den här databasens skapandeåtgärd.	sträng
restorePointInTime	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.	sträng
sampleName	Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.	"AdventureWorksLT" "WideWorldImportersFull" "WideWorldImportersStd"
secondaryType	Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo, Named och Standby.	"Geo" "Namngivet" "Vänteläge"
sourceDatabaseDeletionDate	Anger den tid då databasen togs bort.	sträng
sourceDatabaseId	Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.	sträng
sourceResourceId	Resursidentifieraren för den källa som är associerad med skapandeåtgärden för den här databasen. Den här egenskapen stöds endast för DataWarehouse Edition och gör det möjligt att återställa mellan prenumerationer. När sourceResourceId har angetts får inte sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId och sourceDatabaseDeletionDate anges och CreateMode måste vara PointInTimeRestore, Restore eller Recover. När createMode är PointInTimeRestore måste sourceResourceId vara resurs-ID för den befintliga databasen eller den befintliga sql-poolen och restorePointInTime måste anges. När createMode är Återställning måste sourceResourceId vara resurs-ID för återställningsbar borttagen databas eller återställningsbar borttagen SQL-pool. När createMode är Återställ måste sourceResourceId vara resurs-ID för återställningsbar databas eller återställningsbar SQL-pool. När källprenumerationen tillhör en annan klientorganisation än målprenumerationen måste rubriken "x-ms-authorization-auxiliary" innehålla autentiseringstoken för källklientorganisationen. Mer information om rubriken "x-ms-authorization-auxiliary" finns i /azure/azure-resource-manager/management/authenticate-multi-tenant	sträng
useFreeLimit	Oavsett om databasen använder kostnadsfria månatliga gränser eller inte. Tillåts för en databas i en prenumeration.	Bool
zoneRedundant	Om den här databasen är zonredundant, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner.	Bool

DatabasePropertiesKeys

Namn	Beskrivning	Värde

DatabaseUserIdentity

Namn	Beskrivning	Värde

Microsoft.Sql/servers/databases

Namn	Beskrivning	Värde
apiVersion	API-versionen	"2024-05-01-preview"
identitet	Azure Active Directory-identiteten för databasen.	DatabaseIdentity
plats	Resursplats.	sträng (krävs)
Namn	Resursnamnet	sträng (krävs)
Egenskaper	Resursegenskaper.	DatabaseProperties
Sku	Databasens SKU. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa 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änder du `Capabilities_ListByLocation` REST API eller något av följande kommandon: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />powershell Get-AzSqlServerServiceObjective -Location <plats> ````	Sku
Taggar	Resurstaggar	Ordlista med taggnamn och värden. Se taggar i mallar
typ	Resurstypen	"Microsoft.Sql/servers/databases"

Sku

Namn	Beskrivning	Värde
kapacitet	Kapacitet för den specifika SKU:n.	Int
familj	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.	sträng
Namn	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.	sträng (krävs)
storlek	Storleken på den specifika SKU:n	sträng
Nivå	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.	sträng

TrackedResourceTags

Namn	Beskrivning	Värde

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Beskrivning
Azure SQL Server med granskning skriven till Log Analytics	Med den här mallen kan du distribuera en Azure SQL-server med Granskning aktiverat för att skriva granskningsloggar till Log Analytics (OMS-arbetsyta)
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 datakryptering.
Distribuera en ny elastisk SQL-pool	Med den här mallen kan du distribuera en ny elastisk SQL-pool med den nya associerade SQL Server och nya SQL-databaser som ska tilldelas till den.
Distribuera Sports Analytics på Azure Architecture	Skapar ett Azure Storage-konto med ADLS Gen 2 aktiverat, en Azure Data Factory-instans med länkade tjänster för lagringskontot (en Azure SQL Database om den distribueras) 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 användningsfall för direktuppspelning). När ett Azure Key Vault distribueras beviljas den hanterade identiteten för datafabriken och AAD-identiteten för den användare som distribuerar mallen rollen Key Vault-hemligheter.
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.
exempel på privat slutpunkt	Den här mallen visar hur du skapar en privat slutpunkt som pekar på Azure SQL Server
Etablera en webbapp med en SQL Database-	Den här mallen etablerar en webbapp, en SQL Database, autoskalningsinställningar, aviseringsregler och App Insights. Den konfigurerar en anslutningssträng i webbappen för databasen.
Fjärrskrivbordstjänster med hög tillgänglighet	Den här ARM-mallexempelkoden distribuerar en Remote Desktop Services 2019 Session Collection lab med hög tillgänglighet. Målet är att distribuera en fullständigt redundant lösning med hög tillgänglighet för Fjärrskrivbordstjänster med Hjälp av Windows Server 2019.
Sonarqube Docker Web App på Linux med Azure SQL	Den här mallen distribuerar Sonarqube i en Azure App Service-webbapps Linux-container med hjälp av den officiella Sonarqube-avbildningen och backas upp av en Azure SQL Server.
webbapp med hanterad identitet, SQL Server och ΑΙ	Enkelt exempel för att distribuera Azure-infrastruktur för app + data + hanterad identitet + övervakning
WebApp använder en privat Azure SQL-slutpunkt	Den här mallen visar hur du 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

Om du vill skapa en Microsoft.Sql/servers/databases-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2024-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
      availabilityZone = "string"
      catalogCollation = "string"
      collation = "string"
      createMode = "string"
      elasticPoolId = "string"
      encryptionProtector = "string"
      encryptionProtectorAutoRotation = bool
      federatedClientId = "string"
      freeLimitExhaustionBehavior = "string"
      highAvailabilityReplicaCount = int
      isLedgerOn = bool
      keys = {
        {customized property} = {
        }
      }
      licenseType = "string"
      longTermRetentionBackupResourceId = "string"
      maintenanceConfigurationId = "string"
      manualCutover = bool
      maxSizeBytes = int
      minCapacity = int
      performCutover = bool
      preferredEnclaveType = "string"
      readScale = "string"
      recoverableDatabaseId = "string"
      recoveryServicesRecoveryPointId = "string"
      requestedBackupStorageRedundancy = "string"
      restorableDroppedDatabaseId = "string"
      restorePointInTime = "string"
      sampleName = "string"
      secondaryType = "string"
      sourceDatabaseDeletionDate = "string"
      sourceDatabaseId = "string"
      sourceResourceId = "string"
      useFreeLimit = bool
      zoneRedundant = bool
    }
  })
}

Egenskapsvärden

DatabaseIdentity

Namn	Beskrivning	Värde
typ	Identitetstypen	"Ingen" "UserAssigned"
userAssignedIdentities	Resurs-ID:n för de användartilldelade identiteter som ska användas	DatabaseIdentityUserAssignedIdentiteter

DatabaseIdentityUserAssignedIdentiteter

Namn	Beskrivning	Värde

DatabaseKey

Namn	Beskrivning	Värde

DatabaseProperties

Namn	Beskrivning	Värde
autoPauseDelay	Tid i minuter efter vilken databasen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverad	Int
availabilityZone	Anger tillgänglighetszonen som databasen är fäst på.	'1' '2' '3' "NoPreference"
catalogCollation	Sortering av metadatakatalogen.	"DATABASE_DEFAULT" "SQL_Latin1_General_CP1_CI_AS"
Sortering	Sortering av databasen.	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. Sekundär: skapar en databas som en 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, Secondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition.	"Kopiera" "Standard" "OnlineSecondary" "PointInTimeRestore" "Återställning" "Återställ" "RestoreExternalBackup" "RestoreExternalBackupSecondary" "RestoreLongTermRetentionBackup" "Sekundär"
elasticPoolId	Resursidentifieraren för den elastiska poolen som innehåller den här databasen.	sträng
encryptionProtector	Azure Key Vault-URI:n för databasen om den har konfigurerats med kundhanterade nycklar per databas.	sträng
encryptionProtectorAutoRotation	Flaggan för att aktivera eller inaktivera automatisk rotation av databaskrypteringsskydds-AKV-nyckel.	Bool
federatedClientId	Klient-ID:t som används för cmk-scenario mellan klientorganisationer per databas	sträng Begränsningar: Min längd = 36 Maximal längd = 36 Mönster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Anger beteendet när månatliga kostnadsfria gränser är uttömda för den kostnadsfria databasen. AutoPause: Databasen pausas automatiskt när de kostnadsfria gränserna överskrids under resten av månaden. BillForUsage: Databasen fortsätter att vara online vid överbelastning av kostnadsfria gränser och eventuell överförbrukning debiteras.	"Autopause" "BillOverUsage"
highAvailabilityReplicaCount	Antalet sekundära repliker som är associerade med databasen Business Critical, Premium eller Hyperscale Edition som används för att ge hög tillgänglighet. Gäller inte för en Hyperskala-databas i en elastisk pool.	Int
isLedgerOn	Om den här databasen är en transaktionsregisterdatabas, vilket innebär att alla tabeller i databasen är transaktionsregistertabeller. Obs! Värdet för den här egenskapen kan inte ändras när databasen har skapats.	Bool
Nycklar	Resurs-ID:n för de användartilldelade identiteter som ska användas	DatabasePropertiesKeys
licenseType	Den licenstyp som ska användas för den här databasen. `LicenseIncluded` om du behöver en licens eller `BasePrice` om du har en licens och är berättigad till Azure Hybrid-förmånen.	"BasePrice" "LicenseIncluded"
longTermRetentionBackupResourceId	Resursidentifieraren för den långsiktiga kvarhållningssäkerhetskopian som är associerad med att skapa den här databasen.	sträng
maintenanceConfigurationId	Underhållskonfigurations-ID som tilldelats databasen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.	sträng
manualCutover	Om kundkontrollerad manuell snabbhet måste utföras under uppdateringsdatabasåtgärden till Hyperskala-nivån eller inte. Den här egenskapen gäller endast vid skalning av databas från nivån Affärskritisk/Generell användning/Premium/Standard till Hyperskala-nivå. När manualCutover har angetts väntar skalningsåtgärden på att användarindata ska utlösa snabbhet i Hyperskala-databasen. Om du vill utlösa snabbhet anger du parametern "performCutover" när skalningsåtgärden är i vänteläge.	Bool
maxSizeBytes	Den maximala storleken på databasen uttryckt i byte.	Int
minCapacity	Minimal kapacitet som databasen alltid har allokerat, om den inte har pausats	Int
performCutover	För att utlösa kundkontrollerad manuell snabbhet under väntetillståndet medan skalningsåtgärden pågår. Den här egenskapsparametern gäller endast för skalningsåtgärder som initieras tillsammans med parametern "manualCutover". Den här egenskapen gäller endast vid skalning av databas från affärskritisk/generell användning/Premium/Standard-nivå till Hyperskala-nivå pågår redan. När performCutover har angetts utlöser skalningsåtgärden snabbhet och utför rolländring till Hyperskala-databas.	Bool
preferredEnclaveType	Typ av enklav som begärs i databasen, t.ex. standard enklaver eller VBS-enklaver.	"Standard" "VBS"
readScale	Tillståndet för skrivskyddad routning. Om det här alternativet är aktiverat kan anslutningar som har programmets avsikt inställd på skrivskyddad i anslutningssträngen dirigeras till en skrivskyddad sekundär replik i samma region. Gäller inte för en Hyperskala-databas i en elastisk pool.	"Inaktiverad" "Aktiverad"
recoverableDatabaseId	Resursidentifieraren för den återställningsbara databas som är associerad med den här databasens skapandeåtgärd.	sträng
recoveryServicesRecoveryPointId	Resursidentifieraren för återställningspunkten som är associerad med skapandeåtgärden för den här databasen.	sträng
requestedBackupStorageRedundancy	Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här databasen.	"Geo" "GeoZone" "Lokal" "Zon"
restorableDroppedDatabaseId	Resursidentifieraren för den återställningsbara borttagna databasen som är associerad med den här databasens skapandeåtgärd.	sträng
restorePointInTime	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.	sträng
sampleName	Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.	"AdventureWorksLT" "WideWorldImportersFull" "WideWorldImportersStd"
secondaryType	Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo, Named och Standby.	"Geo" "Namngivet" "Vänteläge"
sourceDatabaseDeletionDate	Anger den tid då databasen togs bort.	sträng
sourceDatabaseId	Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.	sträng
sourceResourceId	Resursidentifieraren för den källa som är associerad med skapandeåtgärden för den här databasen. Den här egenskapen stöds endast för DataWarehouse Edition och gör det möjligt att återställa mellan prenumerationer. När sourceResourceId har angetts får inte sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId och sourceDatabaseDeletionDate anges och CreateMode måste vara PointInTimeRestore, Restore eller Recover. När createMode är PointInTimeRestore måste sourceResourceId vara resurs-ID för den befintliga databasen eller den befintliga sql-poolen och restorePointInTime måste anges. När createMode är Återställning måste sourceResourceId vara resurs-ID för återställningsbar borttagen databas eller återställningsbar borttagen SQL-pool. När createMode är Återställ måste sourceResourceId vara resurs-ID för återställningsbar databas eller återställningsbar SQL-pool. När källprenumerationen tillhör en annan klientorganisation än målprenumerationen måste rubriken "x-ms-authorization-auxiliary" innehålla autentiseringstoken för källklientorganisationen. Mer information om rubriken "x-ms-authorization-auxiliary" finns i /azure/azure-resource-manager/management/authenticate-multi-tenant	sträng
useFreeLimit	Oavsett om databasen använder kostnadsfria månatliga gränser eller inte. Tillåts för en databas i en prenumeration.	Bool
zoneRedundant	Om den här databasen är zonredundant, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner.	Bool

DatabasePropertiesKeys

Namn	Beskrivning	Värde

DatabaseUserIdentity

Namn	Beskrivning	Värde

Microsoft.Sql/servers/databases

Namn	Beskrivning	Värde
identitet	Azure Active Directory-identiteten för databasen.	DatabaseIdentity
plats	Resursplats.	sträng (krävs)
Namn	Resursnamnet	sträng (krävs)
parent_id	ID för resursen som är överordnad för den här resursen.	ID för resurs av typen: servrar
Egenskaper	Resursegenskaper.	DatabaseProperties
Sku	Databasens SKU. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa 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änder du `Capabilities_ListByLocation` REST API eller något av följande kommandon: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />powershell Get-AzSqlServerServiceObjective -Location <plats> ````	Sku
Taggar	Resurstaggar	Ordlista med taggnamn och värden.
typ	Resurstypen	"Microsoft.Sql/servers/databases@2024-05-01-preview"

Sku

Namn	Beskrivning	Värde
kapacitet	Kapacitet för den specifika SKU:n.	Int
familj	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.	sträng
Namn	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.	sträng (krävs)
storlek	Storleken på den specifika SKU:n	sträng
Nivå	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.	sträng

TrackedResourceTags

Namn	Beskrivning	Värde

Dela via

Microsoft.Sql-servrar/databaser

Bicep-resursdefinition

Resursformat

Egenskapsvärden

DatabaseIdentity

DatabaseIdentityUserAssignedIdentiteter

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Snabbstartsexempel

Resursdefinition för ARM-mall

Resursformat

Egenskapsvärden

DatabaseIdentity

DatabaseIdentityUserAssignedIdentiteter

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Snabbstartsmallar

Resursdefinition för Terraform (AzAPI-provider)

Resursformat

Egenskapsvärden

DatabaseIdentity

DatabaseIdentityUserAssignedIdentiteter

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Feedback

Ytterligare resurser