Condividi tramite


Microsoft.Sql servers/databases

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.

Resource format

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

resource symbolicname 'Microsoft.Sql/servers/databases@2024-11-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'
  }
}

Property Values

Microsoft.Sql/servers/databases

Name Description Value
identity Identità di Azure Active Directory del database. DatabaseIdentity
location Resource location. string (required)
name Nome della risorsa string (required)
parent 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
properties Resource properties. 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 &lt;location&gt; -o table<br />````<br /><br />powershell
Get-AzSqlServerServiceObjective -Location <percorso>
````
Sku
tags Resource tags Dizionario di nomi e valori di tag. Vedere tag nei modelli

DatabaseIdentity

Name Description Value
type Tipo di identità 'None'
'UserAssigned'
userAssignedIdentities ID risorsa delle identità assegnate dall'utente da usare DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Name Description Value

DatabaseKey

Name Description Value

DatabaseProperties

Name Description Value
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'
collation Regole di confronto del database. string
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.
'Copy'
'Default'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secondary'
elasticPoolId Identificatore della risorsa del pool elastico contenente il database. string
encryptionProtector URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database. string
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 string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[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
keys 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. string
maintenanceConfigurationId ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. string
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. 'Disabled'
'Enabled'
recoverableDatabaseId Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. string
recoveryServicesRecoveryPointId Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database. string
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. string
restorePointInTime Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. string
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. string
sourceDatabaseId Identificatore della risorsa del database di origine associato all'operazione di creazione del database. string
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
string
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

Name Description Value

DatabaseUserIdentity

Name Description Value

Sku

Name Description Value
capacity Capacità dello SKU specifico. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. string (required)
size Dimensioni dello SKU specifico string
tier Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. string

TrackedResourceTags

Name Description Value

Usage Examples

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

Bicep File Description
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.

Resource format

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

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2024-11-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"
  }
}

Property Values

Microsoft.Sql/servers/databases

Name Description Value
apiVersion Versione dell'API '2024-11-01-preview'
identity Identità di Azure Active Directory del database. DatabaseIdentity
location Resource location. string (required)
name Nome della risorsa string (required)
properties Resource properties. 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 &lt;location&gt; -o table<br />````<br /><br />powershell
Get-AzSqlServerServiceObjective -Location <percorso>
````
Sku
tags Resource tags Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.Sql/servers/databases'

DatabaseIdentity

Name Description Value
type Tipo di identità 'None'
'UserAssigned'
userAssignedIdentities ID risorsa delle identità assegnate dall'utente da usare DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Name Description Value

DatabaseKey

Name Description Value

DatabaseProperties

Name Description Value
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'
collation Regole di confronto del database. string
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.
'Copy'
'Default'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secondary'
elasticPoolId Identificatore della risorsa del pool elastico contenente il database. string
encryptionProtector URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database. string
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 string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[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
keys 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. string
maintenanceConfigurationId ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. string
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. 'Disabled'
'Enabled'
recoverableDatabaseId Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. string
recoveryServicesRecoveryPointId Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database. string
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. string
restorePointInTime Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. string
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. string
sourceDatabaseId Identificatore della risorsa del database di origine associato all'operazione di creazione del database. string
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
string
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

Name Description Value

DatabaseUserIdentity

Name Description Value

Sku

Name Description Value
capacity Capacità dello SKU specifico. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. string (required)
size Dimensioni dello SKU specifico string
tier Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. string

TrackedResourceTags

Name Description Value

Usage Examples

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Template Description
Sql Server di Azure con il controllo scritto in Log Analytics

Pubblica su Azure
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

Pubblica su Azure
Questo modello consente di creare un database SQL e un server.
pool SQL dedicato con Transparent Encryption

Pubblica su Azure
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

Pubblica su Azure
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

Pubblica su 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

Pubblica su Azure
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

Pubblica su Azure
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

Pubblica su Azure
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

Pubblica su Azure
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

Pubblica su Azure
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 ΑΙ

Pubblica su Azure
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

Pubblica su 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:

  • Resource groups

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

Resource format

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-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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"
    }
  }
}

Property Values

Microsoft.Sql/servers/databases

Name Description Value
identity Identità di Azure Active Directory del database. DatabaseIdentity
location Resource location. string (required)
name Nome della risorsa string (required)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: server
properties Resource properties. 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 &lt;location&gt; -o table<br />````<br /><br />powershell
Get-AzSqlServerServiceObjective -Location <percorso>
````
Sku
tags Resource tags Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.Sql/servers/databases@2024-11-01-preview"

DatabaseIdentity

Name Description Value
type Tipo di identità 'None'
'UserAssigned'
userAssignedIdentities ID risorsa delle identità assegnate dall'utente da usare DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Name Description Value

DatabaseKey

Name Description Value

DatabaseProperties

Name Description Value
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'
collation Regole di confronto del database. string
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.
'Copy'
'Default'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secondary'
elasticPoolId Identificatore della risorsa del pool elastico contenente il database. string
encryptionProtector URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database. string
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 string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[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
keys 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. string
maintenanceConfigurationId ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. string
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. 'Disabled'
'Enabled'
recoverableDatabaseId Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. string
recoveryServicesRecoveryPointId Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database. string
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. string
restorePointInTime Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. string
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. string
sourceDatabaseId Identificatore della risorsa del database di origine associato all'operazione di creazione del database. string
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
string
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

Name Description Value

DatabaseUserIdentity

Name Description Value

Sku

Name Description Value
capacity Capacità dello SKU specifico. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. string (required)
size Dimensioni dello SKU specifico string
tier Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. string

TrackedResourceTags

Name Description Value