Condividi tramite


Microsoft.Sql server/database 2017-10-01-preview

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@2017-10-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoPauseDelay: int
    catalogCollation: 'string'
    collation: 'string'
    createMode: 'string'
    elasticPoolId: 'string'
    licenseType: 'string'
    longTermRetentionBackupResourceId: 'string'
    maxSizeBytes: int
    minCapacity: int
    readReplicaCount: int
    readScale: 'string'
    recoverableDatabaseId: 'string'
    recoveryServicesRecoveryPointId: 'string'
    restorableDroppedDatabaseId: 'string'
    restorePointInTime: 'string'
    sampleName: 'string'
    sourceDatabaseDeletionDate: 'string'
    sourceDatabaseId: 'string'
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.Sql/servers/databases

Name Description Value
location Percorso della risorsa. stringa (obbligatorio)
name Nome della risorsa stringa (obbligatorio)
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 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 Capabilities_ListByLocation REST 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 posizione>
````
Sku
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

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
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
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
maxSizeBytes Dimensione massima del database espressa in byte. int
minCapacity Capacità minima allocata dal database, se non sospesa int
readReplicaCount Numero di repliche secondarie di sola lettura associate al database a cui è possibile instradare le connessioni finalità dell'applicazione di sola lettura. Questa proprietà è impostata solo per i database dell'edizione Hyperscale. int
readScale 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. Questa proprietà è impostata solo per i database Premium e Business Critical. '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
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'
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
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

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. stringa (obbligatorio)
size Dimensioni dello SKU specifico string
tier Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. string

TrackedResourceTags

Name Description Value

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Description
Database SQL di Azure AVM Resource Module for Azure SQL Database

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.

File bicipite Description
Azure SQL Server con 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 database e un database di 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": "2017-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "autoPauseDelay": "int",
    "catalogCollation": "string",
    "collation": "string",
    "createMode": "string",
    "elasticPoolId": "string",
    "licenseType": "string",
    "longTermRetentionBackupResourceId": "string",
    "maxSizeBytes": "int",
    "minCapacity": "int",
    "readReplicaCount": "int",
    "readScale": "string",
    "recoverableDatabaseId": "string",
    "recoveryServicesRecoveryPointId": "string",
    "restorableDroppedDatabaseId": "string",
    "restorePointInTime": "string",
    "sampleName": "string",
    "sourceDatabaseDeletionDate": "string",
    "sourceDatabaseId": "string",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.Sql/servers/databases

Name Description Value
apiVersion Versione dell'API '2017-10-01-preview'
location Percorso della risorsa. stringa (obbligatorio)
name Nome della risorsa stringa (obbligatorio)
properties 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 Capabilities_ListByLocation REST 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 posizione>
````
Sku
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.Sql/servers/databases'

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
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
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
maxSizeBytes Dimensione massima del database espressa in byte. int
minCapacity Capacità minima allocata dal database, se non sospesa int
readReplicaCount Numero di repliche secondarie di sola lettura associate al database a cui è possibile instradare le connessioni finalità dell'applicazione di sola lettura. Questa proprietà è impostata solo per i database dell'edizione Hyperscale. int
readScale 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. Questa proprietà è impostata solo per i database Premium e Business Critical. '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
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'
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
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

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. stringa (obbligatorio)
size Dimensioni dello SKU specifico string
tier Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. string

TrackedResourceTags

Name Description Value

Esempi di utilizzo

Modelli di avvio rapido di Azure

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

Template Description
Azure SQL Server con 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 database e un database di 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:

  • 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@2017-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      autoPauseDelay = int
      catalogCollation = "string"
      collation = "string"
      createMode = "string"
      elasticPoolId = "string"
      licenseType = "string"
      longTermRetentionBackupResourceId = "string"
      maxSizeBytes = int
      minCapacity = int
      readReplicaCount = int
      readScale = "string"
      recoverableDatabaseId = "string"
      recoveryServicesRecoveryPointId = "string"
      restorableDroppedDatabaseId = "string"
      restorePointInTime = "string"
      sampleName = "string"
      sourceDatabaseDeletionDate = "string"
      sourceDatabaseId = "string"
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Sql/servers/databases

Name Description Value
location Percorso della risorsa. stringa (obbligatorio)
name Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: server
properties 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 Capabilities_ListByLocation REST 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 posizione>
````
Sku
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.Sql/servers/databases@2017-10-01-preview"

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
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
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
maxSizeBytes Dimensione massima del database espressa in byte. int
minCapacity Capacità minima allocata dal database, se non sospesa int
readReplicaCount Numero di repliche secondarie di sola lettura associate al database a cui è possibile instradare le connessioni finalità dell'applicazione di sola lettura. Questa proprietà è impostata solo per i database dell'edizione Hyperscale. int
readScale 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. Questa proprietà è impostata solo per i database Premium e Business Critical. '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
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'
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
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

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. stringa (obbligatorio)
size Dimensioni dello SKU specifico string
tier Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. string

TrackedResourceTags

Name Description Value

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione del database MS SQL.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azurerm_client_config" "current" {
}

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

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

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

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

Un esempio di base di distribuzione del database MS SQL.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azurerm_client_config" "current" {
}

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

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

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

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