Microsoft.Sql servers/databases

Artículo
12/20/2024

Definición de recursos de Bicep

El tipo de recurso servers/databases se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Sql/servers/databases, agregue lo siguiente a la plantilla de Bicep.

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

Valores de propiedad

DatabaseIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad	'Ninguno' 'UserAssigned'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nombre	Descripción	Valor

DatabaseKey

Nombre	Descripción	Valor

DatabaseProperties

Nombre	Descripción	Valor
autoPauseDelay	Hora en minutos después de la cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada	Int
availabilityZone	Especifica la zona de disponibilidad a la que está anclada la base de datos.	'1' '2' '3' 'NoPreference'
catalogCollation	Intercalación del catálogo de metadatos.	"DATABASE_DEFAULT" "SQL_Latin1_General_CP1_CI_AS"
colación	Intercalación de la base de datos.	cuerda
createMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación normal de la base de datos. Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen. Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente. PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar. Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos descartable restaurable y sourceDatabaseDeletionDate se omite. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior. RestoreLongTermRetentionBackup: crea una base de datos restaurando desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso de punto de recuperación. Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.	'Copiar' 'Valor predeterminado' 'OnlineSecondary' 'PointInTimeRestore' "Recuperación" 'Restaurar' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secundario'
elasticPoolId	Identificador de recurso del grupo elástico que contiene esta base de datos.	cuerda
encryptionProtector	El URI de Azure Key Vault de la base de datos si está configurado con claves administradas por cliente de base de datos.	cuerda
encryptionProtectorAutoRotation	Marca para habilitar o deshabilitar la rotación automática de la clave AKV del protector de cifrado de base de datos.	Bool
federatedClientId	Identificador de cliente usado para el escenario entre inquilinos por base de datos de CMK	cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Especifica el comportamiento cuando se agotan los límites gratuitos mensuales para la base de datos gratuita. AutoPause: la base de datos se pausará automáticamente tras el agotamiento de los límites libres durante el resto del mes. BillForUsage: la base de datos seguirá estando en línea tras el agotamiento de los límites gratuitos y se facturará cualquier uso por encima del límite.	'AutoPause' 'BillOverUsage'
highAvailabilityReplicaCount	Número de réplicas secundarias asociadas a la base de datos crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.	Int
isLedgerOn	Si esta base de datos es una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar después de crear la base de datos.	Bool
Llaves	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	DatabasePropertiesKeys de
licenseType	Tipo de licencia que se va a solicitar para esta base de datos. `LicenseIncluded` si necesita una licencia o `BasePrice` si tiene una licencia y es apta para la Ventaja híbrida de Azure.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.	cuerda
maintenanceConfigurationId	Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.	cuerda
manualCutover	Si es necesario realizar la migración manual controlada por el cliente durante la operación actualizar base de datos al nivel hiperescala. Esta propiedad solo es aplicable al escalado de la base de datos de nivel Crítico para la empresa, Uso general, Premium o Estándar a Nivel hiperescala. Cuando se especifica manualCutover, la operación de escalado esperará a que la entrada del usuario desencadene la migración a la base de datos de Hiperescala. Para desencadenar la transición, proporcione el parámetro "performCutover" cuando la operación de escalado esté en estado En espera.	Bool
maxSizeBytes	Tamaño máximo de la base de datos expresada en bytes.	Int
minCapacity	Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa	Int
performCutover	Para desencadenar la migración manual controlada por el cliente durante el estado de espera mientras la operación de escalado está en curso. Este parámetro de propiedad solo es aplicable a las operaciones de escalado que se inician junto con el parámetro "manualCutover". Esta propiedad solo es aplicable cuando el escalado de la base de datos de nivel Crítico para la empresa, Uso general, Premium o Estándar a Nivel hiperescala ya está en curso. Cuando se especifica performCutover, la operación de escalado desencadenará la transición y realizará el cambio de rol en la base de datos de Hiperescala.	Bool
preferredEnclaveType	Tipo de enclave solicitado en la base de datos, es decir, enclaves predeterminados o VBS.	'Valor predeterminado' 'VBS'
readScale	Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.	'Deshabilitado' 'Habilitado'
recoverableDatabaseId	Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.	cuerda
recoveryServicesRecoveryPointId	Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.	cuerda
requestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.	'Geo' 'GeoZone' 'Local' 'Zona'
restorableDroppedDatabaseId	Identificador de recurso de la base de datos que se puede restaurar asociada a la operación de creación de esta base de datos.	cuerda
restorePointInTime	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.	cuerda
sampleName	Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo, Named y Standby.	'Geo' 'Con nombre' 'Standby'
sourceDatabaseDeletionDate	Especifica la hora en que se eliminó la base de datos.	cuerda
sourceDatabaseId	Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.	cuerda
sourceResourceId	Identificador de recurso del origen asociado a la operación de creación de esta base de datos. Esta propiedad solo se admite para la edición DataWarehouse y permite restaurar entre suscripciones. Cuando se especifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId y sourceDatabaseDeletionDate no deben especificarse y CreateMode debe ser PointInTimeRestore, Restore o Recover. Cuando createMode es PointInTimeRestore, sourceResourceId debe ser el identificador de recurso de la base de datos existente o el grupo de SQL existente y se debe especificar restorePointInTime. Cuando createMode es Restore, sourceResourceId debe ser el identificador de recurso de la base de datos quitada restaurable o el grupo de SQL quitado restaurable. Cuando createMode es Recover, sourceResourceId debe ser el identificador de recurso de la base de datos recuperable o el grupo de SQL recuperable. Cuando la suscripción de origen pertenece a un inquilino diferente al de la suscripción de destino, el encabezado "x-ms-authorization-auxiliary" debe contener el token de autenticación para el inquilino de origen. Para más información sobre el encabezado "x-ms-authorization-auxiliary", consulte /azure/azure-resource-manager/management/authenticate-multi-tenant.	cuerda
useFreeLimit	Si la base de datos usa o no límites mensuales gratuitos. Se permite en una base de datos de una suscripción.	Bool
zoneRedundant	Si esta base de datos es con redundancia de zona, lo que significa que las réplicas de esta base de datos se distribuirán entre varias zonas de disponibilidad.	Bool

DatabasePropertiesKeys

Nombre	Descripción	Valor

DatabaseUserIdentity

Nombre	Descripción	Valor

Microsoft.Sql/servers/databases

Nombre	Descripción	Valor
identidad	Identidad de Azure Active Directory de la base de datos.	DatabaseIdentity
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
padre	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: servidores
Propiedades	Propiedades de recursos.	DatabaseProperties
Sku	SKU de base de datos. La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la API REST de `Capabilities_ListByLocation` o uno de los siguientes comandos: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />PowerShell Get-AzSqlServerServiceObjective -Location <> de ubicación ````	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

Sku

Nombre	Descripción	Valor
capacidad	Capacidad de la SKU determinada.	Int
familia	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda
nombre	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.	string (obligatorio)
tamaño	Tamaño de la SKU determinada	cuerda
nivel	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	cuerda

TrackedResourceTags

Nombre	Descripción	Valor

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep	Descripción
Azure SQL Server con auditoría escrita en Log Analytics	Esta plantilla le permite implementar un servidor de Azure SQL server con auditoría habilitado para escribir registros de auditoría en Log Analytics (área de trabajo de OMS).
Crear un de base de datos y SQL Server	Esta plantilla le permite crear SQL Database y Server.
grupo de SQL dedicado con cifrado transparente	Crea un servidor SQL Server y un grupo de SQL dedicado (anteriormente SQL DW) con cifrado de datos transparente.
Implementación de Sports Analytics en la arquitectura de Azure	Crea una cuenta de Azure Storage con ADLS Gen 2 habilitado, una instancia de Azure Data Factory con servicios vinculados para la cuenta de almacenamiento (una instancia de Azure SQL Database si se implementa) y una instancia de Azure Databricks. AAD identity for the user deploying the template and the managed identity for the ADF instance will be granted the Storage Blob Data Contributor role on the storage account. También hay opciones para implementar una instancia de Azure Key Vault, una instancia de Azure SQL Database y un centro de eventos de Azure (para casos de uso de streaming). Cuando se implementa una instancia de Azure Key Vault, a la identidad administrada de Data Factory y a la identidad de AAD para el usuario que implementa la plantilla se le concederá el rol De usuario secretos de Key Vault.
ejemplo de punto de conexión privado de	Esta plantilla muestra cómo crear un punto de conexión privado que apunte a Azure SQL Server.
Aprovisionar una aplicación web con una de SQL Database	Esta plantilla aprovisiona una aplicación web, una instancia de SQL Database, la configuración de escalabilidad automática, las reglas de alerta y App Insights. Configura una cadena de conexión en la aplicación web para la base de datos.
Sonarqube Docker Web App en Linux con Azure SQL	Esta plantilla implementa Sonarqube en un contenedor de Linux de una aplicación web de Azure App Service mediante la imagen oficial de Sonarqube y respaldada por una instancia de Azure SQL Server.
Aplicación web con identidad administrada, SQL Server y ΑΙ	Ejemplo sencillo para implementar la infraestructura de Azure para la aplicación + datos + identidad administrada + supervisión

Definición de recursos de plantilla de ARM

El tipo de recurso servers/databases se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Sql/servers/databases, agregue el siguiente json a la plantilla.

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

Valores de propiedad

DatabaseIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad	'Ninguno' 'UserAssigned'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nombre	Descripción	Valor

DatabaseKey

Nombre	Descripción	Valor

DatabaseProperties

Nombre	Descripción	Valor
autoPauseDelay	Hora en minutos después de la cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada	Int
availabilityZone	Especifica la zona de disponibilidad a la que está anclada la base de datos.	'1' '2' '3' 'NoPreference'
catalogCollation	Intercalación del catálogo de metadatos.	"DATABASE_DEFAULT" "SQL_Latin1_General_CP1_CI_AS"
colación	Intercalación de la base de datos.	cuerda
createMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación normal de la base de datos. Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen. Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente. PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar. Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos descartable restaurable y sourceDatabaseDeletionDate se omite. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior. RestoreLongTermRetentionBackup: crea una base de datos restaurando desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso de punto de recuperación. Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.	'Copiar' 'Valor predeterminado' 'OnlineSecondary' 'PointInTimeRestore' "Recuperación" 'Restaurar' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secundario'
elasticPoolId	Identificador de recurso del grupo elástico que contiene esta base de datos.	cuerda
encryptionProtector	El URI de Azure Key Vault de la base de datos si está configurado con claves administradas por cliente de base de datos.	cuerda
encryptionProtectorAutoRotation	Marca para habilitar o deshabilitar la rotación automática de la clave AKV del protector de cifrado de base de datos.	Bool
federatedClientId	Identificador de cliente usado para el escenario entre inquilinos por base de datos de CMK	cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Especifica el comportamiento cuando se agotan los límites gratuitos mensuales para la base de datos gratuita. AutoPause: la base de datos se pausará automáticamente tras el agotamiento de los límites libres durante el resto del mes. BillForUsage: la base de datos seguirá estando en línea tras el agotamiento de los límites gratuitos y se facturará cualquier uso por encima del límite.	'AutoPause' 'BillOverUsage'
highAvailabilityReplicaCount	Número de réplicas secundarias asociadas a la base de datos crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.	Int
isLedgerOn	Si esta base de datos es una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar después de crear la base de datos.	Bool
Llaves	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	DatabasePropertiesKeys de
licenseType	Tipo de licencia que se va a solicitar para esta base de datos. `LicenseIncluded` si necesita una licencia o `BasePrice` si tiene una licencia y es apta para la Ventaja híbrida de Azure.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.	cuerda
maintenanceConfigurationId	Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.	cuerda
manualCutover	Si es necesario realizar la migración manual controlada por el cliente durante la operación actualizar base de datos al nivel hiperescala. Esta propiedad solo es aplicable al escalado de la base de datos de nivel Crítico para la empresa, Uso general, Premium o Estándar a Nivel hiperescala. Cuando se especifica manualCutover, la operación de escalado esperará a que la entrada del usuario desencadene la migración a la base de datos de Hiperescala. Para desencadenar la transición, proporcione el parámetro "performCutover" cuando la operación de escalado esté en estado En espera.	Bool
maxSizeBytes	Tamaño máximo de la base de datos expresada en bytes.	Int
minCapacity	Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa	Int
performCutover	Para desencadenar la migración manual controlada por el cliente durante el estado de espera mientras la operación de escalado está en curso. Este parámetro de propiedad solo es aplicable a las operaciones de escalado que se inician junto con el parámetro "manualCutover". Esta propiedad solo es aplicable cuando el escalado de la base de datos de nivel Crítico para la empresa, Uso general, Premium o Estándar a Nivel hiperescala ya está en curso. Cuando se especifica performCutover, la operación de escalado desencadenará la transición y realizará el cambio de rol en la base de datos de Hiperescala.	Bool
preferredEnclaveType	Tipo de enclave solicitado en la base de datos, es decir, enclaves predeterminados o VBS.	'Valor predeterminado' 'VBS'
readScale	Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.	'Deshabilitado' 'Habilitado'
recoverableDatabaseId	Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.	cuerda
recoveryServicesRecoveryPointId	Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.	cuerda
requestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.	'Geo' 'GeoZone' 'Local' 'Zona'
restorableDroppedDatabaseId	Identificador de recurso de la base de datos que se puede restaurar asociada a la operación de creación de esta base de datos.	cuerda
restorePointInTime	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.	cuerda
sampleName	Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo, Named y Standby.	'Geo' 'Con nombre' 'Standby'
sourceDatabaseDeletionDate	Especifica la hora en que se eliminó la base de datos.	cuerda
sourceDatabaseId	Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.	cuerda
sourceResourceId	Identificador de recurso del origen asociado a la operación de creación de esta base de datos. Esta propiedad solo se admite para la edición DataWarehouse y permite restaurar entre suscripciones. Cuando se especifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId y sourceDatabaseDeletionDate no deben especificarse y CreateMode debe ser PointInTimeRestore, Restore o Recover. Cuando createMode es PointInTimeRestore, sourceResourceId debe ser el identificador de recurso de la base de datos existente o el grupo de SQL existente y se debe especificar restorePointInTime. Cuando createMode es Restore, sourceResourceId debe ser el identificador de recurso de la base de datos quitada restaurable o el grupo de SQL quitado restaurable. Cuando createMode es Recover, sourceResourceId debe ser el identificador de recurso de la base de datos recuperable o el grupo de SQL recuperable. Cuando la suscripción de origen pertenece a un inquilino diferente al de la suscripción de destino, el encabezado "x-ms-authorization-auxiliary" debe contener el token de autenticación para el inquilino de origen. Para más información sobre el encabezado "x-ms-authorization-auxiliary", consulte /azure/azure-resource-manager/management/authenticate-multi-tenant.	cuerda
useFreeLimit	Si la base de datos usa o no límites mensuales gratuitos. Se permite en una base de datos de una suscripción.	Bool
zoneRedundant	Si esta base de datos es con redundancia de zona, lo que significa que las réplicas de esta base de datos se distribuirán entre varias zonas de disponibilidad.	Bool

DatabasePropertiesKeys

Nombre	Descripción	Valor

DatabaseUserIdentity

Nombre	Descripción	Valor

Microsoft.Sql/servers/databases

Nombre	Descripción	Valor
apiVersion	La versión de api	'2024-05-01-preview'
identidad	Identidad de Azure Active Directory de la base de datos.	DatabaseIdentity
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos.	DatabaseProperties
Sku	SKU de base de datos. La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la API REST de `Capabilities_ListByLocation` o uno de los siguientes comandos: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />PowerShell Get-AzSqlServerServiceObjective -Location <> de ubicación ````	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.Sql/servers/databases"

Sku

Nombre	Descripción	Valor
capacidad	Capacidad de la SKU determinada.	Int
familia	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda
nombre	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.	string (obligatorio)
tamaño	Tamaño de la SKU determinada	cuerda
nivel	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	cuerda

TrackedResourceTags

Nombre	Descripción	Valor

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
Azure SQL Server con auditoría escrita en Log Analytics	Esta plantilla le permite implementar un servidor de Azure SQL server con auditoría habilitado para escribir registros de auditoría en Log Analytics (área de trabajo de OMS).
Crear un de base de datos y SQL Server	Esta plantilla le permite crear SQL Database y Server.
grupo de SQL dedicado con cifrado transparente	Crea un servidor SQL Server y un grupo de SQL dedicado (anteriormente SQL DW) con cifrado de datos transparente.
Implementar un nuevo grupo elástico de SQL	Esta plantilla le permite implementar un nuevo grupo elástico de SQL con su nuevo servidor SQL Server asociado y nuevas bases de datos SQL para asignarlo.
Implementación de Sports Analytics en la arquitectura de Azure	Crea una cuenta de Azure Storage con ADLS Gen 2 habilitado, una instancia de Azure Data Factory con servicios vinculados para la cuenta de almacenamiento (una instancia de Azure SQL Database si se implementa) y una instancia de Azure Databricks. AAD identity for the user deploying the template and the managed identity for the ADF instance will be granted the Storage Blob Data Contributor role on the storage account. También hay opciones para implementar una instancia de Azure Key Vault, una instancia de Azure SQL Database y un centro de eventos de Azure (para casos de uso de streaming). Cuando se implementa una instancia de Azure Key Vault, a la identidad administrada de Data Factory y a la identidad de AAD para el usuario que implementa la plantilla se le concederá el rol De usuario secretos de Key Vault.
HDInsight con Ambari + Base de datos de metastore de Hive personalizada en la de red virtual	Esta plantilla permite crear un clúster de HDInsight en una red virtual existente con una nueva base de datos SQL que actúa como base de datos de Ambari personalizada y Metastore de Hive. Debe tener una instancia de SQL Sever, una cuenta de almacenamiento y una red virtual existentes.
ejemplo de punto de conexión privado de	Esta plantilla muestra cómo crear un punto de conexión privado que apunte a Azure SQL Server.
Aprovisionar una aplicación web con una de SQL Database	Esta plantilla aprovisiona una aplicación web, una instancia de SQL Database, la configuración de escalabilidad automática, las reglas de alerta y App Insights. Configura una cadena de conexión en la aplicación web para la base de datos.
Servicios de Escritorio remoto con alta disponibilidad	Este código de ejemplo de plantilla de ARM implementará un laboratorio de recopilación de sesiones de remote Desktop Services 2019 con alta disponibilidad. El objetivo es implementar una solución totalmente redundante y de alta disponibilidad para Servicios de Escritorio remoto con Windows Server 2019.
Sonarqube Docker Web App en Linux con Azure SQL	Esta plantilla implementa Sonarqube en un contenedor de Linux de una aplicación web de Azure App Service mediante la imagen oficial de Sonarqube y respaldada por una instancia de Azure SQL Server.
Aplicación web con identidad administrada, SQL Server y ΑΙ	Ejemplo sencillo para implementar la infraestructura de Azure para la aplicación + datos + identidad administrada + supervisión
WebApp que consume un punto de conexión privado de Azure SQL	Esta plantilla muestra cómo crear una aplicación web que consuma un punto de conexión privado que apunte a Azure SQL Server.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso servers/databases se puede implementar con operaciones destinadas a:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Sql/servers/databases, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

DatabaseIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad	'Ninguno' 'UserAssigned'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nombre	Descripción	Valor

DatabaseKey

Nombre	Descripción	Valor

DatabaseProperties

Nombre	Descripción	Valor
autoPauseDelay	Hora en minutos después de la cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada	Int
availabilityZone	Especifica la zona de disponibilidad a la que está anclada la base de datos.	'1' '2' '3' 'NoPreference'
catalogCollation	Intercalación del catálogo de metadatos.	"DATABASE_DEFAULT" "SQL_Latin1_General_CP1_CI_AS"
colación	Intercalación de la base de datos.	cuerda
createMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación normal de la base de datos. Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen. Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente. PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar. Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos descartable restaurable y sourceDatabaseDeletionDate se omite. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior. RestoreLongTermRetentionBackup: crea una base de datos restaurando desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso de punto de recuperación. Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.	'Copiar' 'Valor predeterminado' 'OnlineSecondary' 'PointInTimeRestore' "Recuperación" 'Restaurar' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secundario'
elasticPoolId	Identificador de recurso del grupo elástico que contiene esta base de datos.	cuerda
encryptionProtector	El URI de Azure Key Vault de la base de datos si está configurado con claves administradas por cliente de base de datos.	cuerda
encryptionProtectorAutoRotation	Marca para habilitar o deshabilitar la rotación automática de la clave AKV del protector de cifrado de base de datos.	Bool
federatedClientId	Identificador de cliente usado para el escenario entre inquilinos por base de datos de CMK	cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
freeLimitExhaustionBehavior	Especifica el comportamiento cuando se agotan los límites gratuitos mensuales para la base de datos gratuita. AutoPause: la base de datos se pausará automáticamente tras el agotamiento de los límites libres durante el resto del mes. BillForUsage: la base de datos seguirá estando en línea tras el agotamiento de los límites gratuitos y se facturará cualquier uso por encima del límite.	'AutoPause' 'BillOverUsage'
highAvailabilityReplicaCount	Número de réplicas secundarias asociadas a la base de datos crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.	Int
isLedgerOn	Si esta base de datos es una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar después de crear la base de datos.	Bool
Llaves	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	DatabasePropertiesKeys de
licenseType	Tipo de licencia que se va a solicitar para esta base de datos. `LicenseIncluded` si necesita una licencia o `BasePrice` si tiene una licencia y es apta para la Ventaja híbrida de Azure.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.	cuerda
maintenanceConfigurationId	Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.	cuerda
manualCutover	Si es necesario realizar la migración manual controlada por el cliente durante la operación actualizar base de datos al nivel hiperescala. Esta propiedad solo es aplicable al escalado de la base de datos de nivel Crítico para la empresa, Uso general, Premium o Estándar a Nivel hiperescala. Cuando se especifica manualCutover, la operación de escalado esperará a que la entrada del usuario desencadene la migración a la base de datos de Hiperescala. Para desencadenar la transición, proporcione el parámetro "performCutover" cuando la operación de escalado esté en estado En espera.	Bool
maxSizeBytes	Tamaño máximo de la base de datos expresada en bytes.	Int
minCapacity	Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa	Int
performCutover	Para desencadenar la migración manual controlada por el cliente durante el estado de espera mientras la operación de escalado está en curso. Este parámetro de propiedad solo es aplicable a las operaciones de escalado que se inician junto con el parámetro "manualCutover". Esta propiedad solo es aplicable cuando el escalado de la base de datos de nivel Crítico para la empresa, Uso general, Premium o Estándar a Nivel hiperescala ya está en curso. Cuando se especifica performCutover, la operación de escalado desencadenará la transición y realizará el cambio de rol en la base de datos de Hiperescala.	Bool
preferredEnclaveType	Tipo de enclave solicitado en la base de datos, es decir, enclaves predeterminados o VBS.	'Valor predeterminado' 'VBS'
readScale	Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.	'Deshabilitado' 'Habilitado'
recoverableDatabaseId	Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.	cuerda
recoveryServicesRecoveryPointId	Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.	cuerda
requestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.	'Geo' 'GeoZone' 'Local' 'Zona'
restorableDroppedDatabaseId	Identificador de recurso de la base de datos que se puede restaurar asociada a la operación de creación de esta base de datos.	cuerda
restorePointInTime	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.	cuerda
sampleName	Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo, Named y Standby.	'Geo' 'Con nombre' 'Standby'
sourceDatabaseDeletionDate	Especifica la hora en que se eliminó la base de datos.	cuerda
sourceDatabaseId	Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.	cuerda
sourceResourceId	Identificador de recurso del origen asociado a la operación de creación de esta base de datos. Esta propiedad solo se admite para la edición DataWarehouse y permite restaurar entre suscripciones. Cuando se especifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId y sourceDatabaseDeletionDate no deben especificarse y CreateMode debe ser PointInTimeRestore, Restore o Recover. Cuando createMode es PointInTimeRestore, sourceResourceId debe ser el identificador de recurso de la base de datos existente o el grupo de SQL existente y se debe especificar restorePointInTime. Cuando createMode es Restore, sourceResourceId debe ser el identificador de recurso de la base de datos quitada restaurable o el grupo de SQL quitado restaurable. Cuando createMode es Recover, sourceResourceId debe ser el identificador de recurso de la base de datos recuperable o el grupo de SQL recuperable. Cuando la suscripción de origen pertenece a un inquilino diferente al de la suscripción de destino, el encabezado "x-ms-authorization-auxiliary" debe contener el token de autenticación para el inquilino de origen. Para más información sobre el encabezado "x-ms-authorization-auxiliary", consulte /azure/azure-resource-manager/management/authenticate-multi-tenant.	cuerda
useFreeLimit	Si la base de datos usa o no límites mensuales gratuitos. Se permite en una base de datos de una suscripción.	Bool
zoneRedundant	Si esta base de datos es con redundancia de zona, lo que significa que las réplicas de esta base de datos se distribuirán entre varias zonas de disponibilidad.	Bool

DatabasePropertiesKeys

Nombre	Descripción	Valor

DatabaseUserIdentity

Nombre	Descripción	Valor

Microsoft.Sql/servers/databases

Nombre	Descripción	Valor
identidad	Identidad de Azure Active Directory de la base de datos.	DatabaseIdentity
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: servidores
Propiedades	Propiedades de recursos.	DatabaseProperties
Sku	SKU de base de datos. La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la API REST de `Capabilities_ListByLocation` o uno de los siguientes comandos: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />PowerShell Get-AzSqlServerServiceObjective -Location <> de ubicación ````	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.Sql/servers/databases@2024-05-01-preview"

Sku

Nombre	Descripción	Valor
capacidad	Capacidad de la SKU determinada.	Int
familia	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda
nombre	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.	string (obligatorio)
tamaño	Tamaño de la SKU determinada	cuerda
nivel	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	cuerda

TrackedResourceTags

Nombre	Descripción	Valor

Compartir a través de

Microsoft.Sql servers/databases

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Ejemplos de inicio rápido

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Microsoft.Sql/servers/databases

Sku

TrackedResourceTags

Comentarios

Recursos adicionales