Microsoft.Sql servers/databases

Articolo
12/20/2024

Definizione di risorsa Bicep

Il tipo di risorsa server/database può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Sql/servers/databases, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

DatabaseIdentity

Nome	Descrizione	Valore
digitare	Tipo di identità	'Nessuno' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nome	Descrizione	Valore

DatabaseKey

Nome	Descrizione	Valore

DatabaseProperties

Nome	Descrizione	Valore
autoPauseDelay	Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata	Int
availabilityZone	Specifica la zona di disponibilità a cui viene aggiunto il database.	'1' '2' '3' 'NoPreference'
catalogCollation	Regole di confronto del catalogo di metadati.	'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS'
collazione	Regole di confronto del database.	corda
createMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione regolare del database. Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine. Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente. PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime. Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare. Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo. RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino. Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.	'Copia' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Ripristino' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary'
elasticPoolId	Identificatore della risorsa del pool elastico contenente il database.	corda
encryptionProtector	URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database.	corda
encryptionProtectorAutoRotation	Flag per abilitare o disabilitare la rotazione automatica della chiave AKV della protezione di crittografia del database.	Bool
federatedClientId	ID client usato per lo scenario cmk tra tenant per database	corda Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Specifica il comportamento quando vengono esauriti i limiti gratuiti mensili per il database gratuito. AutoPause: il database verrà sospeso automaticamente al termine dell'esaurimento dei limiti gratuiti per il resto del mese. BillForUsage: il database continuerà a essere online al momento dell'esaurimento dei limiti gratuiti e verranno fatturate eventuali eccedenze.	'AutoPause' 'BillOverUsage'
highAvailabilityReplicaCount	Numero di repliche secondarie associate al database business critical, Premium o Hyperscale edition che vengono usate per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.	Int
isLedgerOn	Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.	Bool
Chiavi	ID risorsa delle identità assegnate dall'utente da usare	DatabasePropertiesKeys
licenseType	Tipo di licenza da applicare per questo database. `LicenseIncluded` se è necessaria una licenza o `BasePrice` se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.	corda
maintenanceConfigurationId	ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.	corda
manualCutover	Indica se il cutover manuale controllato dal cliente deve essere eseguito durante l'operazione Aggiorna database al livello Hyperscale. Questa proprietà è applicabile solo quando si ridimensiona il database dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale. Quando si specifica manualCutover, l'operazione di ridimensionamento attenderà l'input dell'utente per attivare il cutover nel database Hyperscale. Per attivare il cutover, specificare il parametro 'performCutover' quando l'operazione di ridimensionamento è in stato In attesa.	Bool
maxSizeBytes	Dimensione massima del database espressa in byte.	Int
minCapacity	Capacità minima allocata dal database, se non sospesa	Int
performCutover	Per attivare il cutover manuale controllato dal cliente durante lo stato di attesa mentre è in corso l'operazione di ridimensionamento. Questo parametro di proprietà è applicabile solo per le operazioni di ridimensionamento avviate insieme al parametro 'manualCutover'. Questa proprietà è applicabile solo quando il database viene ridimensionato dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale è già in corso. Quando si specifica performCutover, l'operazione di ridimensionamento attiverà il cutover e eseguirà la modifica del ruolo nel database Hyperscale.	Bool
preferredEnclaveType	Tipo di enclave richiesto nel database, ad esempio enclave predefiniti o VBS.	'Default' 'VBS'
readScale	Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.	'Disabilitato' 'Enabled'
recoverableDatabaseId	Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.	corda
recoveryServicesRecoveryPointId	Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.	corda
requestedBackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questo database.	'Geo' 'GeoZone' 'Local' 'Zone'
restorableDroppedDatabaseId	Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.	corda
restorePointInTime	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.	corda
sampleName	Nome dello schema di esempio da applicare durante la creazione del database.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	Tipo secondario del database se è secondario. I valori validi sono Geo, Named e Standby.	'Geo' 'Named' 'Standby'
sourceDatabaseDeletionDate	Specifica l'ora di eliminazione del database.	corda
sourceDatabaseId	Identificatore della risorsa del database di origine associato all'operazione di creazione del database.	corda
sourceResourceId	Identificatore della risorsa dell'origine associata all'operazione di creazione del database. Questa proprietà è supportata solo per l'edizione DataWarehouse e consente di eseguire il ripristino tra sottoscrizioni. Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover. Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime. Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o ripristinare il pool SQL eliminato. Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o del pool SQL ripristinabile. Quando la sottoscrizione di origine appartiene a un tenant diverso rispetto alla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere il token di autenticazione per il tenant di origine. Per altre informazioni sull'intestazione "x-ms-authorization-auxiliary", vedere /azure/azure-resource-manager/management/authenticate-multi-tenant	corda
useFreeLimit	Indica se il database utilizza limiti mensili gratuiti. Consentito in un database in una sottoscrizione.	Bool
zoneRedundant	Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.	Bool

DatabasePropertiesKeys

Nome	Descrizione	Valore

DatabaseUserIdentity

Nome	Descrizione	Valore

Microsoft.Sql/servers/databases

Nome	Descrizione	Valore
identità	Identità di Azure Active Directory del database.	DatabaseIdentity
ubicazione	Percorso della risorsa.	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
genitore	In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.	Nome simbolico per la risorsa di tipo: server
proprietà	Proprietà delle risorse.	DatabaseProperties
Sku	SKU del database. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST `Capabilities_ListByLocation` o uno dei comandi seguenti: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />PowerShell Get-AzSqlServerServiceObjective -Location <percorso> ````	sku
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

Sku

Nome	Descrizione	Valore
capacità	Capacità dello SKU specifico.	Int
famiglia	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.	corda
nome	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.	stringa (obbligatorio)
grandezza	Dimensioni dello SKU specifico	corda
livello	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.	corda

TrackedResourceTags

Nome	Descrizione	Valore

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File	Descrizione
Sql Server di Azure con il controllo scritto in Log Analytics	Questo modello consente di distribuire un server SQL di Azure con il controllo abilitato per scrivere log di controllo in Log Analytics (area di lavoro OMS)
Creare un di DATABASE e SQL Server	Questo modello consente di creare un database SQL e un server.
pool SQL dedicato con Transparent Encryption	Crea un'istanza di SQL Server e un pool SQL dedicato (in precedenza SQL Data Encryption) con Transparent Data Encryption.
Distribuire Sports Analytics nell'architettura di Azure	Crea un account di archiviazione di Azure con ADLS Gen 2 abilitato, un'istanza di Azure Data Factory con servizi collegati per l'account di archiviazione (un database SQL di Azure se distribuito) e un'istanza di Azure Databricks. All'identità di AAD per l'utente che distribuisce il modello e all'identità gestita per l'istanza di Azure Data Factory verrà concesso il ruolo Collaboratore ai dati del BLOB di archiviazione nell'account di archiviazione. Sono disponibili anche opzioni per distribuire un'istanza di Azure Key Vault, un database SQL di Azure e un hub eventi di Azure (per i casi d'uso di streaming). Quando viene distribuito un insieme di credenziali delle chiavi di Azure, all'identità gestita della data factory e all'identità di AAD per l'utente che distribuisce il modello verrà concesso il ruolo utente Segreti dell'insieme di credenziali delle chiavi.
esempio di endpoint privato	Questo modello illustra come creare un endpoint privato che punta ad Azure SQL Server
Effettuare il provisioning di un'app Web con un database SQL	Questo modello effettua il provisioning di un'app Web, un database SQL, impostazioni di scalabilità automatica, regole di avviso e Informazioni dettagliate app. Configura una stringa di connessione nell'app Web per il database.
'app Web Docker Sonarqube in Linux con Azure SQL	Questo modello distribuisce Sonarqube in un contenitore Linux dell'app Web del servizio app di Azure usando l'immagine Sonarqube ufficiale e supportata da un'istanza di Azure SQL Server.
'app Web con identità gestita, SQL Server e ΑΙ	Esempio semplice per distribuire l'infrastruttura di Azure per app + dati + identità gestita e monitoraggio

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa server/database può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Sql/servers/databases, aggiungere il codice JSON seguente al modello.

{
  "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"
  }
}

Valori delle proprietà

DatabaseIdentity

Nome	Descrizione	Valore
digitare	Tipo di identità	'Nessuno' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nome	Descrizione	Valore

DatabaseKey

Nome	Descrizione	Valore

DatabaseProperties

Nome	Descrizione	Valore
autoPauseDelay	Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata	Int
availabilityZone	Specifica la zona di disponibilità a cui viene aggiunto il database.	'1' '2' '3' 'NoPreference'
catalogCollation	Regole di confronto del catalogo di metadati.	'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS'
collazione	Regole di confronto del database.	corda
createMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione regolare del database. Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine. Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente. PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime. Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare. Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo. RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino. Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.	'Copia' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Ripristino' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary'
elasticPoolId	Identificatore della risorsa del pool elastico contenente il database.	corda
encryptionProtector	URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database.	corda
encryptionProtectorAutoRotation	Flag per abilitare o disabilitare la rotazione automatica della chiave AKV della protezione di crittografia del database.	Bool
federatedClientId	ID client usato per lo scenario cmk tra tenant per database	corda Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Specifica il comportamento quando vengono esauriti i limiti gratuiti mensili per il database gratuito. AutoPause: il database verrà sospeso automaticamente al termine dell'esaurimento dei limiti gratuiti per il resto del mese. BillForUsage: il database continuerà a essere online al momento dell'esaurimento dei limiti gratuiti e verranno fatturate eventuali eccedenze.	'AutoPause' 'BillOverUsage'
highAvailabilityReplicaCount	Numero di repliche secondarie associate al database business critical, Premium o Hyperscale edition che vengono usate per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.	Int
isLedgerOn	Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.	Bool
Chiavi	ID risorsa delle identità assegnate dall'utente da usare	DatabasePropertiesKeys
licenseType	Tipo di licenza da applicare per questo database. `LicenseIncluded` se è necessaria una licenza o `BasePrice` se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.	corda
maintenanceConfigurationId	ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.	corda
manualCutover	Indica se il cutover manuale controllato dal cliente deve essere eseguito durante l'operazione Aggiorna database al livello Hyperscale. Questa proprietà è applicabile solo quando si ridimensiona il database dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale. Quando si specifica manualCutover, l'operazione di ridimensionamento attenderà l'input dell'utente per attivare il cutover nel database Hyperscale. Per attivare il cutover, specificare il parametro 'performCutover' quando l'operazione di ridimensionamento è in stato In attesa.	Bool
maxSizeBytes	Dimensione massima del database espressa in byte.	Int
minCapacity	Capacità minima allocata dal database, se non sospesa	Int
performCutover	Per attivare il cutover manuale controllato dal cliente durante lo stato di attesa mentre è in corso l'operazione di ridimensionamento. Questo parametro di proprietà è applicabile solo per le operazioni di ridimensionamento avviate insieme al parametro 'manualCutover'. Questa proprietà è applicabile solo quando il database viene ridimensionato dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale è già in corso. Quando si specifica performCutover, l'operazione di ridimensionamento attiverà il cutover e eseguirà la modifica del ruolo nel database Hyperscale.	Bool
preferredEnclaveType	Tipo di enclave richiesto nel database, ad esempio enclave predefiniti o VBS.	'Default' 'VBS'
readScale	Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.	'Disabilitato' 'Enabled'
recoverableDatabaseId	Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.	corda
recoveryServicesRecoveryPointId	Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.	corda
requestedBackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questo database.	'Geo' 'GeoZone' 'Local' 'Zone'
restorableDroppedDatabaseId	Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.	corda
restorePointInTime	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.	corda
sampleName	Nome dello schema di esempio da applicare durante la creazione del database.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	Tipo secondario del database se è secondario. I valori validi sono Geo, Named e Standby.	'Geo' 'Named' 'Standby'
sourceDatabaseDeletionDate	Specifica l'ora di eliminazione del database.	corda
sourceDatabaseId	Identificatore della risorsa del database di origine associato all'operazione di creazione del database.	corda
sourceResourceId	Identificatore della risorsa dell'origine associata all'operazione di creazione del database. Questa proprietà è supportata solo per l'edizione DataWarehouse e consente di eseguire il ripristino tra sottoscrizioni. Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover. Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime. Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o ripristinare il pool SQL eliminato. Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o del pool SQL ripristinabile. Quando la sottoscrizione di origine appartiene a un tenant diverso rispetto alla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere il token di autenticazione per il tenant di origine. Per altre informazioni sull'intestazione "x-ms-authorization-auxiliary", vedere /azure/azure-resource-manager/management/authenticate-multi-tenant	corda
useFreeLimit	Indica se il database utilizza limiti mensili gratuiti. Consentito in un database in una sottoscrizione.	Bool
zoneRedundant	Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.	Bool

DatabasePropertiesKeys

Nome	Descrizione	Valore

DatabaseUserIdentity

Nome	Descrizione	Valore

Microsoft.Sql/servers/databases

Nome	Descrizione	Valore
apiVersion	Versione dell'API	'2024-05-01-preview'
identità	Identità di Azure Active Directory del database.	DatabaseIdentity
ubicazione	Percorso della risorsa.	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà delle risorse.	DatabaseProperties
Sku	SKU del database. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST `Capabilities_ListByLocation` o uno dei comandi seguenti: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />PowerShell Get-AzSqlServerServiceObjective -Location <percorso> ````	sku
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare	Tipo di risorsa	'Microsoft.Sql/servers/databases'

Sku

Nome	Descrizione	Valore
capacità	Capacità dello SKU specifico.	Int
famiglia	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.	corda
nome	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.	stringa (obbligatorio)
grandezza	Dimensioni dello SKU specifico	corda
livello	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.	corda

TrackedResourceTags

Nome	Descrizione	Valore

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma	Descrizione
Sql Server di Azure con il controllo scritto in Log Analytics	Questo modello consente di distribuire un server SQL di Azure con il controllo abilitato per scrivere log di controllo in Log Analytics (area di lavoro OMS)
Creare un di DATABASE e SQL Server	Questo modello consente di creare un database SQL e un server.
pool SQL dedicato con Transparent Encryption	Crea un'istanza di SQL Server e un pool SQL dedicato (in precedenza SQL Data Encryption) con Transparent Data Encryption.
Distribuire un nuovo pool elastico SQL	Questo modello consente di distribuire un nuovo pool elastico SQL con il nuovo SQL Server associato e i nuovi database SQL da assegnare.
Distribuire Sports Analytics nell'architettura di Azure	Crea un account di archiviazione di Azure con ADLS Gen 2 abilitato, un'istanza di Azure Data Factory con servizi collegati per l'account di archiviazione (un database SQL di Azure se distribuito) e un'istanza di Azure Databricks. All'identità di AAD per l'utente che distribuisce il modello e all'identità gestita per l'istanza di Azure Data Factory verrà concesso il ruolo Collaboratore ai dati del BLOB di archiviazione nell'account di archiviazione. Sono disponibili anche opzioni per distribuire un'istanza di Azure Key Vault, un database SQL di Azure e un hub eventi di Azure (per i casi d'uso di streaming). Quando viene distribuito un insieme di credenziali delle chiavi di Azure, all'identità gestita della data factory e all'identità di AAD per l'utente che distribuisce il modello verrà concesso il ruolo utente Segreti dell'insieme di credenziali delle chiavi.
HDInsight con database metastore Ambari + Hive personalizzato nella rete virtuale	Questo modello consente di creare un cluster HDInsight in una rete virtuale esistente con un nuovo database SQL che funge sia da database Ambari personalizzato che da metastore Hive. È necessario disporre di un server SQL esistente, un account di archiviazione e una rete virtuale.
esempio di endpoint privato	Questo modello illustra come creare un endpoint privato che punta ad Azure SQL Server
Effettuare il provisioning di un'app Web con un database SQL	Questo modello effettua il provisioning di un'app Web, un database SQL, impostazioni di scalabilità automatica, regole di avviso e Informazioni dettagliate app. Configura una stringa di connessione nell'app Web per il database.
Servizi Desktop remoto con a disponibilità elevata	Questo codice di esempio di modello di Resource Manager distribuirà un lab di raccolta di sessioni di Servizi Desktop remoto 2019 con disponibilità elevata. L'obiettivo è distribuire una soluzione completamente ridondante e a disponibilità elevata per Servizi Desktop remoto usando Windows Server 2019.
'app Web Docker Sonarqube in Linux con Azure SQL	Questo modello distribuisce Sonarqube in un contenitore Linux dell'app Web del servizio app di Azure usando l'immagine Sonarqube ufficiale e supportata da un'istanza di Azure SQL Server.
'app Web con identità gestita, SQL Server e ΑΙ	Esempio semplice per distribuire l'infrastruttura di Azure per app + dati + identità gestita e monitoraggio
'app Web che usa un endpoint privato SQL di Azure	Questo modello illustra come creare un'app Web che usa un endpoint privato che punta ad Azure SQL Server

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa server/database può essere distribuito con operazioni destinate a:

gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Sql/servers/databases, aggiungere il codice Terraform seguente al modello.

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

Valori delle proprietà

DatabaseIdentity

Nome	Descrizione	Valore
digitare	Tipo di identità	'Nessuno' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nome	Descrizione	Valore

DatabaseKey

Nome	Descrizione	Valore

DatabaseProperties

Nome	Descrizione	Valore
autoPauseDelay	Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata	Int
availabilityZone	Specifica la zona di disponibilità a cui viene aggiunto il database.	'1' '2' '3' 'NoPreference'
catalogCollation	Regole di confronto del catalogo di metadati.	'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS'
collazione	Regole di confronto del database.	corda
createMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione regolare del database. Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine. Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente. PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime. Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare. Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo. RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino. Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.	'Copia' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Ripristino' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary'
elasticPoolId	Identificatore della risorsa del pool elastico contenente il database.	corda
encryptionProtector	URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database.	corda
encryptionProtectorAutoRotation	Flag per abilitare o disabilitare la rotazione automatica della chiave AKV della protezione di crittografia del database.	Bool
federatedClientId	ID client usato per lo scenario cmk tra tenant per database	corda Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Specifica il comportamento quando vengono esauriti i limiti gratuiti mensili per il database gratuito. AutoPause: il database verrà sospeso automaticamente al termine dell'esaurimento dei limiti gratuiti per il resto del mese. BillForUsage: il database continuerà a essere online al momento dell'esaurimento dei limiti gratuiti e verranno fatturate eventuali eccedenze.	'AutoPause' 'BillOverUsage'
highAvailabilityReplicaCount	Numero di repliche secondarie associate al database business critical, Premium o Hyperscale edition che vengono usate per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.	Int
isLedgerOn	Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.	Bool
Chiavi	ID risorsa delle identità assegnate dall'utente da usare	DatabasePropertiesKeys
licenseType	Tipo di licenza da applicare per questo database. `LicenseIncluded` se è necessaria una licenza o `BasePrice` se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.	corda
maintenanceConfigurationId	ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.	corda
manualCutover	Indica se il cutover manuale controllato dal cliente deve essere eseguito durante l'operazione Aggiorna database al livello Hyperscale. Questa proprietà è applicabile solo quando si ridimensiona il database dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale. Quando si specifica manualCutover, l'operazione di ridimensionamento attenderà l'input dell'utente per attivare il cutover nel database Hyperscale. Per attivare il cutover, specificare il parametro 'performCutover' quando l'operazione di ridimensionamento è in stato In attesa.	Bool
maxSizeBytes	Dimensione massima del database espressa in byte.	Int
minCapacity	Capacità minima allocata dal database, se non sospesa	Int
performCutover	Per attivare il cutover manuale controllato dal cliente durante lo stato di attesa mentre è in corso l'operazione di ridimensionamento. Questo parametro di proprietà è applicabile solo per le operazioni di ridimensionamento avviate insieme al parametro 'manualCutover'. Questa proprietà è applicabile solo quando il database viene ridimensionato dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale è già in corso. Quando si specifica performCutover, l'operazione di ridimensionamento attiverà il cutover e eseguirà la modifica del ruolo nel database Hyperscale.	Bool
preferredEnclaveType	Tipo di enclave richiesto nel database, ad esempio enclave predefiniti o VBS.	'Default' 'VBS'
readScale	Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.	'Disabilitato' 'Enabled'
recoverableDatabaseId	Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.	corda
recoveryServicesRecoveryPointId	Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.	corda
requestedBackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questo database.	'Geo' 'GeoZone' 'Local' 'Zone'
restorableDroppedDatabaseId	Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.	corda
restorePointInTime	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.	corda
sampleName	Nome dello schema di esempio da applicare durante la creazione del database.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	Tipo secondario del database se è secondario. I valori validi sono Geo, Named e Standby.	'Geo' 'Named' 'Standby'
sourceDatabaseDeletionDate	Specifica l'ora di eliminazione del database.	corda
sourceDatabaseId	Identificatore della risorsa del database di origine associato all'operazione di creazione del database.	corda
sourceResourceId	Identificatore della risorsa dell'origine associata all'operazione di creazione del database. Questa proprietà è supportata solo per l'edizione DataWarehouse e consente di eseguire il ripristino tra sottoscrizioni. Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover. Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime. Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o ripristinare il pool SQL eliminato. Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o del pool SQL ripristinabile. Quando la sottoscrizione di origine appartiene a un tenant diverso rispetto alla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere il token di autenticazione per il tenant di origine. Per altre informazioni sull'intestazione "x-ms-authorization-auxiliary", vedere /azure/azure-resource-manager/management/authenticate-multi-tenant	corda
useFreeLimit	Indica se il database utilizza limiti mensili gratuiti. Consentito in un database in una sottoscrizione.	Bool
zoneRedundant	Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.	Bool

DatabasePropertiesKeys

Nome	Descrizione	Valore

DatabaseUserIdentity

Nome	Descrizione	Valore

Microsoft.Sql/servers/databases

Nome	Descrizione	Valore
identità	Identità di Azure Active Directory del database.	DatabaseIdentity
ubicazione	Percorso della risorsa.	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: server
proprietà	Proprietà delle risorse.	DatabaseProperties
Sku	SKU del database. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST `Capabilities_ListByLocation` o uno dei comandi seguenti: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />PowerShell Get-AzSqlServerServiceObjective -Location <percorso> ````	sku
Tag	Tag delle risorse	Dizionario di nomi e valori di tag.
digitare	Tipo di risorsa	"Microsoft.Sql/servers/databases@2024-05-01-preview"

Sku

Nome	Descrizione	Valore
capacità	Capacità dello SKU specifico.	Int
famiglia	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.	corda
nome	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.	stringa (obbligatorio)
grandezza	Dimensioni dello SKU specifico	corda
livello	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.	corda

TrackedResourceTags

Nome	Descrizione	Valore

Condividi tramite

Microsoft.Sql servers/databases

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Esempi di avvio rapido

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Modelli di avvio rapido

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Commenti e suggerimenti

Risorse aggiuntive