Microsoft.SqlVirtualMachine sqlVirtualMachines 2022-07-01-preview
Definición de recursos de Bicep
El tipo de recurso sqlVirtualMachines se puede implementar en:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.SqlVirtualMachine/sqlVirtualMachines, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.SqlVirtualMachine/sqlVirtualMachines@2022-07-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
}
properties: {
assessmentSettings: {
enable: bool
runImmediately: bool
schedule: {
dayOfWeek: 'string'
enable: bool
monthlyOccurrence: int
startTime: 'string'
weeklyInterval: int
}
}
autoBackupSettings: {
backupScheduleType: 'string'
backupSystemDbs: bool
daysOfWeek: [
'string'
]
enable: bool
enableEncryption: bool
fullBackupFrequency: 'string'
fullBackupStartTime: int
fullBackupWindowHours: int
logBackupFrequency: int
password: 'string'
retentionPeriod: int
storageAccessKey: 'string'
storageAccountUrl: 'string'
storageContainerName: 'string'
}
autoPatchingSettings: {
dayOfWeek: 'string'
enable: bool
maintenanceWindowDuration: int
maintenanceWindowStartingHour: int
}
enableAutomaticUpgrade: bool
keyVaultCredentialSettings: {
azureKeyVaultUrl: 'string'
credentialName: 'string'
enable: bool
servicePrincipalName: 'string'
servicePrincipalSecret: 'string'
}
leastPrivilegeMode: 'Enabled'
serverConfigurationsManagementSettings: {
additionalFeaturesServerConfigurations: {
isRServicesEnabled: bool
}
sqlConnectivityUpdateSettings: {
connectivityType: 'string'
port: int
sqlAuthUpdatePassword: 'string'
sqlAuthUpdateUserName: 'string'
}
sqlInstanceSettings: {
collation: 'string'
isIfiEnabled: bool
isLpimEnabled: bool
isOptimizeForAdHocWorkloadsEnabled: bool
maxDop: int
maxServerMemoryMB: int
minServerMemoryMB: int
}
sqlStorageUpdateSettings: {
diskConfigurationType: 'string'
diskCount: int
startingDeviceId: int
}
sqlWorkloadTypeUpdateSettings: {
sqlWorkloadType: 'string'
}
}
sqlImageOffer: 'string'
sqlImageSku: 'string'
sqlManagement: 'string'
sqlServerLicenseType: 'string'
sqlVirtualMachineGroupResourceId: 'string'
storageConfigurationSettings: {
diskConfigurationType: 'string'
sqlDataSettings: {
defaultFilePath: 'string'
luns: [
int
]
}
sqlLogSettings: {
defaultFilePath: 'string'
luns: [
int
]
}
sqlSystemDbOnDataDisk: bool
sqlTempDbSettings: {
dataFileCount: int
dataFileSize: int
dataGrowth: int
defaultFilePath: 'string'
logFileSize: int
logGrowth: int
luns: [
int
]
persistFolder: bool
persistFolderPath: 'string'
}
storageWorkloadType: 'string'
}
virtualMachineResourceId: 'string'
wsfcDomainCredentials: {
clusterBootstrapAccountPassword: 'string'
clusterOperatorAccountPassword: 'string'
sqlServiceAccountPassword: 'string'
}
wsfcStaticIp: 'string'
}
}
Valores de propiedades
sqlVirtualMachines
Nombre | Descripción | Value |
---|---|---|
name | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación del recurso | string (obligatorio) |
etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
identity | Identidad de Azure Active Directory del servidor. | ResourceIdentity |
properties | Propiedades de recursos. | SqlVirtualMachineProperties |
ResourceIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso. | 'Ninguno' 'SystemAssigned' |
SqlVirtualMachineProperties
Nombre | Descripción | Valor |
---|---|---|
assessmentSettings | Configuración de evaluación. | AssessmentSettings |
autoBackupSettings | Configuración de copia de seguridad automática para SQL Server. | AutoBackupSettings |
autoPatchingSettings | Configuración de aplicación automática de revisiones para aplicar actualizaciones de seguridad críticas a la máquina virtual SQL. | AutoPatchingSettings |
enableAutomaticUpgrade | Habilite la actualización automática del Agente de extensión iaaS de Sql. | bool |
keyVaultCredentialSettings | Configuración de credenciales del almacén de claves. | KeyVaultCredentialSettings |
leastPrivilegeMode | Modo de privilegios mínimos del Agente IaaS de SQL. | 'Habilitado' |
serverConfigurationsManagementSettings | SQL Server opciones de administración de configuración. | ServerConfigurationsManagementSettings |
sqlImageOffer | Oferta de imagen de SQL. Algunos ejemplos son SQL2016-WS2016, SQL2017-WS2016. | string |
sqlImageSku | SQL Server tipo de edición. | "Desarrollador" 'Enterprise' 'Express' 'Estándar' 'Web' |
sqlManagement | SQL Server Tipo de administración. | 'Full' 'LightWeight' 'NoAgent' |
sqlServerLicenseType | SQL Server tipo de licencia. | 'AHUB' 'DR' 'PAYG' |
sqlVirtualMachineGroupResourceId | Identificador de recurso de ARM del grupo de máquinas virtuales DE SQL de la que forma parte o formará parte. | string |
storageConfigurationSettings | Opciones de configuración de almacenamiento. | StorageConfigurationSettings |
virtualMachineResourceId | Id. de recurso de ARM de la máquina virtual subyacente creada a partir de la imagen de SQL Marketplace. | string |
wsfcDomainCredentials | Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL. | WsfcDomainCredentials |
wsfcStaticIp | Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL. | string |
AssessmentSettings
Nombre | Descripción | Valor |
---|---|---|
enable | Habilite o deshabilite la característica de evaluación en la máquina virtual SQL. | bool |
runImmediately | Ejecute la evaluación inmediatamente en la máquina virtual SQL. | bool |
schedule | Programación para la evaluación. | Programación |
Programación
Nombre | Descripción | Valor |
---|---|---|
dayOfWeek | Día de la semana para ejecutar la evaluación. | 'Viernes' 'Lunes' "Sábado" 'Domingo' 'Jueves' 'Martes' 'Miércoles' |
enable | Habilite o deshabilite la programación de evaluación en la máquina virtual SQL. | bool |
monthlyOccurrence | Repetición del día DayOfWeek en un mes para programar la evaluación. Toma valores: 1,2,3,4 y -1. Use -1 para el último día dayOfWeek del mes. | int |
startTime | Hora del día en formato HH:mm. Eg. 17:30 | string |
weeklyInterval | Número de semanas que se programan entre 2 ejecuciones de evaluación. Toma el valor de 1 a 6 | int |
AutoBackupSettings
Nombre | Descripción | Valor |
---|---|---|
backupScheduleType | Tipo de programación de copia de seguridad. | "Automatizado" 'Manual' |
backupSystemDbs | Incluya o excluya las bases de datos del sistema de la copia de seguridad automática. | bool |
daysOfWeek | Días de la semana para las copias de seguridad cuando FullBackupFrequency está establecido en Weekly. | Matriz de cadenas que contiene cualquiera de: 'Viernes' 'Lunes' "Sábado" 'Domingo' 'Jueves' 'Martes' 'Miércoles' |
enable | Habilite o deshabilite la devolución de seguridad automática en la máquina virtual SQL. | bool |
enableEncryption | Habilite o deshabilite el cifrado para la copia de seguridad en la máquina virtual SQL. | bool |
fullBackupFrequency | Frecuencia de las copias de seguridad completas. En ambos casos, las copias de seguridad completas se inician durante el siguiente período de tiempo programado. | 'Diario' 'Semanal' |
fullBackupStartTime | Hora de inicio de un día determinado durante el cual se pueden realizar copias de seguridad completas. 0-23 horas. | int |
fullBackupWindowHours | Duración del período de tiempo de un día determinado durante el cual se pueden realizar copias de seguridad completas. 1-23 horas. | int |
logBackupFrequency | Frecuencia de las copias de seguridad de registros. 5-60 minutos. | int |
password | Contraseña para el cifrado en la copia de seguridad. | string |
retentionPeriod | Período de retención de la copia de seguridad: 1-90 días. | int |
storageAccessKey | Clave de cuenta de almacenamiento en la que se realizará la copia de seguridad. | string |
storageAccountUrl | Dirección URL de la cuenta de almacenamiento en la que se realizará la copia de seguridad. | string |
storageContainerName | Nombre del contenedor de almacenamiento en el que se realizará la copia de seguridad. | string |
AutoPatchingSettings
Nombre | Descripción | Valor |
---|---|---|
dayOfWeek | Día de la semana en el que se aplicará la revisión. | 'Todos los días' 'Viernes' 'Lunes' "Sábado" 'Domingo' 'Jueves' 'Martes' 'Miércoles' |
enable | Habilite o deshabilite el autopatching en la máquina virtual SQL. | bool |
maintenanceWindowDuration | Duración de la aplicación de revisiones. | int |
maintenanceWindowStartingHour | Hora del día en que se inicia la aplicación de revisiones. Hora de la máquina virtual local. | int |
KeyVaultCredentialSettings
Nombre | Descripción | Valor |
---|---|---|
azureKeyVaultUrl | Dirección URL de Azure Key Vault. | string |
credentialName | Nombre de credencial. | string |
enable | Habilite o deshabilite la configuración de credenciales del almacén de claves. | bool |
servicePrincipalName | Nombre de entidad de seguridad de servicio para acceder al almacén de claves. | string |
servicePrincipalSecret | Secreto de nombre de entidad de seguridad de servicio para acceder al almacén de claves. | string |
ServerConfigurationsManagementSettings
Nombre | Descripción | Valor |
---|---|---|
additionalFeaturesServerConfigurations | Configuración adicional de características de SQL. | AdditionalFeaturesServerConfigurations |
sqlConnectivityUpdateSettings | Configuración del tipo de conectividad de SQL. | SqlConnectivityUpdateSettings |
sqlInstanceSettings | Configuración de la instancia de SQL. | SQLInstanceSettings |
sqlStorageUpdateSettings | Configuración de actualización de almacenamiento de SQL. | SqlStorageUpdateSettings |
sqlWorkloadTypeUpdateSettings | Configuración del tipo de carga de trabajo de SQL. | SqlWorkloadTypeUpdateSettings |
AdditionalFeaturesServerConfigurations
Nombre | Descripción | Valor |
---|---|---|
isRServicesEnabled | Habilite o deshabilite los servicios de R (SQL 2016 en adelante). | bool |
SqlConnectivityUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
connectivityType | SQL Server opción de conectividad. | 'LOCAL' 'PRIVATE' 'PUBLIC' |
port | SQL Server puerto. | int |
sqlAuthUpdatePassword | SQL Server contraseña de inicio de sesión sysadmin. | string |
sqlAuthUpdateUserName | SQL Server inicio de sesión sysadmin que se va a crear. | string |
SQLInstanceSettings
Nombre | Descripción | Valor |
---|---|---|
collation | SQL Server intercalación. | string |
isIfiEnabled | SQL Server IFI. | bool |
isLpimEnabled | SQL Server LPIM. | bool |
isOptimizeForAdHocWorkloadsEnabled | SQL Server Optimizar para cargas de trabajo de Adhoc. | bool |
maxDop | SQL Server MAXDOP. | int |
maxServerMemoryMB | SQL Server memoria máxima. | int |
minServerMemoryMB | SQL Server memoria mínima. | int |
SqlStorageUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
diskConfigurationType | Configuración de disco que se va a aplicar a SQL Server. | 'ADD' 'EXTEND' 'NEW' |
diskCount | Recuento de discos de máquina virtual. | int |
startingDeviceId | Id. de dispositivo del primer disco que se va a actualizar. | int |
SqlWorkloadTypeUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
sqlWorkloadType | SQL Server tipo de carga de trabajo. | "DW" "GENERAL" 'OLTP' |
StorageConfigurationSettings
Nombre | Descripción | Valor |
---|---|---|
diskConfigurationType | Configuración de disco que se va a aplicar a SQL Server. | 'ADD' 'EXTEND' 'NEW' |
sqlDataSettings | SQL Server configuración de almacenamiento de datos. | SQLStorageSettings |
sqlLogSettings | SQL Server configuración de almacenamiento de registros. | SQLStorageSettings |
sqlSystemDbOnDataDisk | SQL Server Almacenamiento de SystemDb en DataPool si es true. | bool |
sqlTempDbSettings | SQL Server configuración de almacenamiento de TempDb. | SQLTempDbSettings |
storageWorkloadType | Tipo de carga de trabajo de almacenamiento. | "DW" "GENERAL" 'OLTP' |
SQLStorageSettings
Nombre | Descripción | Valor |
---|---|---|
defaultFilePath | SQL Server ruta de acceso de archivo predeterminada | string |
Luns | Números de unidad lógica para los discos. | int[] |
SQLTempDbSettings
Nombre | Descripción | Valor |
---|---|---|
dataFileCount | SQL Server recuento de archivos de datos tempdb | int |
dataFileSize | SQL Server tamaño del archivo de datos tempdb | int |
dataGrowth | SQL Server tamaño de crecimiento automático del archivo de datos tempdb | int |
defaultFilePath | SQL Server ruta de acceso de archivo predeterminada | string |
logFileSize | SQL Server tamaño del archivo de registro de tempdb | int |
logGrowth | SQL Server tamaño de crecimiento automático del archivo de registro de tempdb | int |
Luns | Números de unidad lógica para los discos. | int[] |
persistFolder | SQL Server opción de carpeta persistente de tempdb | bool |
persistFolderPath | SQL Server ubicación de carpeta persistente de tempdb | string |
WsfcDomainCredentials
Nombre | Descripción | Valor |
---|---|---|
clusterBootstrapAccountPassword | Contraseña de la cuenta de arranque del clúster. | string |
clusterOperatorAccountPassword | Contraseña de la cuenta del operador de clúster. | string |
sqlServiceAccountPassword | Contraseña de la cuenta de servicio de SQL. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla | Descripción |
---|---|
Implementación del programa de instalación always ON de SQL con sql Virtual Machines existente |
Implemente el programa de instalación always ON de SQL con Virtual Machines de SQL existente. Las máquinas virtuales ya deben estar unidas a un dominio existente y deben ejecutar la versión empresarial de SQL Server. |
VM con SQL Server con la configuración de almacenamiento optimizada para rendimiento |
Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento en PremiumSSD |
Configuración de almacenamiento optimizada para el rendimiento de la máquina virtual de SQL en UltraSSD |
Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento mediante UltraSSD para archivos de registro de SQL |
Definición de recursos de plantilla de ARM
El tipo de recurso sqlVirtualMachines se puede implementar en:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.SqlVirtualMachine/sqlVirtualMachines, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.SqlVirtualMachine/sqlVirtualMachines",
"apiVersion": "2022-07-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string"
},
"properties": {
"assessmentSettings": {
"enable": "bool",
"runImmediately": "bool",
"schedule": {
"dayOfWeek": "string",
"enable": "bool",
"monthlyOccurrence": "int",
"startTime": "string",
"weeklyInterval": "int"
}
},
"autoBackupSettings": {
"backupScheduleType": "string",
"backupSystemDbs": "bool",
"daysOfWeek": [ "string" ],
"enable": "bool",
"enableEncryption": "bool",
"fullBackupFrequency": "string",
"fullBackupStartTime": "int",
"fullBackupWindowHours": "int",
"logBackupFrequency": "int",
"password": "string",
"retentionPeriod": "int",
"storageAccessKey": "string",
"storageAccountUrl": "string",
"storageContainerName": "string"
},
"autoPatchingSettings": {
"dayOfWeek": "string",
"enable": "bool",
"maintenanceWindowDuration": "int",
"maintenanceWindowStartingHour": "int"
},
"enableAutomaticUpgrade": "bool",
"keyVaultCredentialSettings": {
"azureKeyVaultUrl": "string",
"credentialName": "string",
"enable": "bool",
"servicePrincipalName": "string",
"servicePrincipalSecret": "string"
},
"leastPrivilegeMode": "Enabled",
"serverConfigurationsManagementSettings": {
"additionalFeaturesServerConfigurations": {
"isRServicesEnabled": "bool"
},
"sqlConnectivityUpdateSettings": {
"connectivityType": "string",
"port": "int",
"sqlAuthUpdatePassword": "string",
"sqlAuthUpdateUserName": "string"
},
"sqlInstanceSettings": {
"collation": "string",
"isIfiEnabled": "bool",
"isLpimEnabled": "bool",
"isOptimizeForAdHocWorkloadsEnabled": "bool",
"maxDop": "int",
"maxServerMemoryMB": "int",
"minServerMemoryMB": "int"
},
"sqlStorageUpdateSettings": {
"diskConfigurationType": "string",
"diskCount": "int",
"startingDeviceId": "int"
},
"sqlWorkloadTypeUpdateSettings": {
"sqlWorkloadType": "string"
}
},
"sqlImageOffer": "string",
"sqlImageSku": "string",
"sqlManagement": "string",
"sqlServerLicenseType": "string",
"sqlVirtualMachineGroupResourceId": "string",
"storageConfigurationSettings": {
"diskConfigurationType": "string",
"sqlDataSettings": {
"defaultFilePath": "string",
"luns": [ "int" ]
},
"sqlLogSettings": {
"defaultFilePath": "string",
"luns": [ "int" ]
},
"sqlSystemDbOnDataDisk": "bool",
"sqlTempDbSettings": {
"dataFileCount": "int",
"dataFileSize": "int",
"dataGrowth": "int",
"defaultFilePath": "string",
"logFileSize": "int",
"logGrowth": "int",
"luns": [ "int" ],
"persistFolder": "bool",
"persistFolderPath": "string"
},
"storageWorkloadType": "string"
},
"virtualMachineResourceId": "string",
"wsfcDomainCredentials": {
"clusterBootstrapAccountPassword": "string",
"clusterOperatorAccountPassword": "string",
"sqlServiceAccountPassword": "string"
},
"wsfcStaticIp": "string"
}
}
Valores de propiedades
sqlVirtualMachines
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | 'Microsoft.SqlVirtualMachine/sqlVirtualMachines' |
apiVersion | La versión de la API de recursos | "2022-07-01-preview" |
name | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación del recurso | string (obligatorio) |
etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
identity | Identidad de Azure Active Directory del servidor. | ResourceIdentity |
properties | Propiedades de recursos. | SqlVirtualMachineProperties |
ResourceIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso. | 'Ninguno' 'SystemAssigned' |
SqlVirtualMachineProperties
Nombre | Descripción | Valor |
---|---|---|
assessmentSettings | Configuración de evaluación. | AssessmentSettings |
autoBackupSettings | Configuración de copia de seguridad automática para SQL Server. | AutoBackupSettings |
autoPatchingSettings | Configuración de aplicación automática de revisiones para aplicar actualizaciones de seguridad críticas a la máquina virtual SQL. | AutoPatchingSettings |
enableAutomaticUpgrade | Habilite la actualización automática del Agente de extensión iaaS de Sql. | bool |
keyVaultCredentialSettings | Configuración de credenciales del almacén de claves. | KeyVaultCredentialSettings |
leastPrivilegeMode | Modo de privilegios mínimos del Agente IaaS de SQL. | 'Habilitado' |
serverConfigurationsManagementSettings | SQL Server opciones de administración de configuración. | ServerConfigurationsManagementSettings |
sqlImageOffer | Oferta de imagen de SQL. Algunos ejemplos son SQL2016-WS2016, SQL2017-WS2016. | string |
sqlImageSku | SQL Server tipo de edición. | "Desarrollador" "Enterprise" 'Express' 'Estándar' 'Web' |
sqlManagement | SQL Server Tipo de administración. | 'Full' 'LightWeight' 'NoAgent' |
sqlServerLicenseType | SQL Server tipo de licencia. | 'AHUB' "DR" 'PAYG' |
sqlVirtualMachineGroupResourceId | Identificador de recurso de ARM del grupo de máquinas virtuales de SQL de la que forma parte esta máquina virtual de SQL. | string |
storageConfigurationSettings | Opciones de configuración de almacenamiento. | StorageConfigurationSettings |
virtualMachineResourceId | Identificador de recurso de ARM de la máquina virtual subyacente creada a partir de la imagen de Marketplace de SQL. | string |
wsfcDomainCredentials | Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL. | WsfcDomainCredentials |
wsfcStaticIp | Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL. | string |
AssessmentSettings
Nombre | Descripción | Valor |
---|---|---|
enable | Habilite o deshabilite la característica de evaluación en la máquina virtual SQL. | bool |
runImmediately | Ejecute la evaluación inmediatamente en la máquina virtual SQL. | bool |
schedule | Programación para la evaluación. | Programación |
Programación
Nombre | Descripción | Valor |
---|---|---|
dayOfWeek | Día de la semana para ejecutar la evaluación. | 'Viernes' "Lunes" 'Sábado' 'Domingo' 'Jueves' "Martes" 'Miércoles' |
enable | Habilite o deshabilite la programación de evaluación en la máquina virtual SQL. | bool |
monthlyOccurrence | Repetición del día DayOfWeek en un mes para programar la evaluación. Toma valores: 1,2,3,4 y -1. Use -1 para el último día dayOfWeek del mes. | int |
startTime | Hora del día en formato HH:mm. Eg. 17:30 | string |
weeklyInterval | Número de semanas que se van a programar entre 2 ejecuciones de evaluación. Toma el valor de 1 a 6 | int |
AutoBackupSettings
Nombre | Descripción | Valor |
---|---|---|
backupScheduleType | Tipo de programación de copia de seguridad. | "Automatizado" 'Manual' |
backupSystemDbs | Incluya o excluya las bases de datos del sistema de la copia de seguridad automática. | bool |
daysOfWeek | Días de la semana para las copias de seguridad cuando FullBackupFrequency está establecido en Semanal. | Matriz de cadenas que contiene cualquiera de: 'Viernes' "Lunes" 'Sábado' 'Domingo' 'Jueves' 'Martes' 'Miércoles' |
enable | Habilite o deshabilite la devolución de seguridad automática en la máquina virtual SQL. | bool |
enableEncryption | Habilite o deshabilite el cifrado para la copia de seguridad en la máquina virtual SQL. | bool |
fullBackupFrequency | Frecuencia de las copias de seguridad completas. En ambos casos, las copias de seguridad completas se inician durante el siguiente período de tiempo programado. | 'Diario' 'Semanal' |
fullBackupStartTime | Hora de inicio de un día determinado durante el cual se pueden realizar copias de seguridad completas. 0-23 horas. | int |
fullBackupWindowHours | Duración del período de tiempo de un día determinado durante el cual se pueden realizar copias de seguridad completas. 1-23 horas. | int |
logBackupFrequency | Frecuencia de las copias de seguridad de registros. 5-60 minutos. | int |
password | Contraseña para el cifrado en la copia de seguridad. | string |
retentionPeriod | Período de retención de la copia de seguridad: 1-90 días. | int |
storageAccessKey | Clave de cuenta de almacenamiento en la que se realizará la copia de seguridad. | string |
storageAccountUrl | Dirección URL de la cuenta de almacenamiento en la que se realizará la copia de seguridad. | string |
storageContainerName | Nombre del contenedor de almacenamiento en el que se realizará la copia de seguridad. | string |
AutoPatchingSettings
Nombre | Descripción | Valor |
---|---|---|
dayOfWeek | Día de la semana en el que se aplicará la revisión. | 'Todos los días' 'Viernes' 'Lunes' "Sábado" 'Domingo' 'Jueves' 'Martes' 'Miércoles' |
enable | Habilite o deshabilite el autopatching en la máquina virtual SQL. | bool |
maintenanceWindowDuration | Duración de la aplicación de revisiones. | int |
maintenanceWindowStartingHour | Hora del día en que se inicia la aplicación de revisiones. Hora de la máquina virtual local. | int |
KeyVaultCredentialSettings
Nombre | Descripción | Valor |
---|---|---|
azureKeyVaultUrl | Dirección URL de Azure Key Vault. | string |
credentialName | Nombre de credencial. | string |
enable | Habilite o deshabilite la configuración de credenciales del almacén de claves. | bool |
servicePrincipalName | Nombre de entidad de seguridad de servicio para acceder al almacén de claves. | string |
servicePrincipalSecret | Secreto de nombre de entidad de seguridad de servicio para acceder al almacén de claves. | string |
ServerConfigurationsManagementSettings
Nombre | Descripción | Valor |
---|---|---|
additionalFeaturesServerConfigurations | Configuración adicional de características de SQL. | AdditionalFeaturesServerConfigurations |
sqlConnectivityUpdateSettings | Configuración del tipo de conectividad de SQL. | SqlConnectivityUpdateSettings |
sqlInstanceSettings | Configuración de la instancia de SQL. | SQLInstanceSettings |
sqlStorageUpdateSettings | Configuración de actualización de almacenamiento de SQL. | SqlStorageUpdateSettings |
sqlWorkloadTypeUpdateSettings | Configuración del tipo de carga de trabajo de SQL. | SqlWorkloadTypeUpdateSettings |
AdditionalFeaturesServerConfigurations
Nombre | Descripción | Valor |
---|---|---|
isRServicesEnabled | Habilite o deshabilite los servicios de R (SQL 2016 y versiones posteriores). | bool |
SqlConnectivityUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
connectivityType | SQL Server opción de conectividad. | 'LOCAL' "PRIVATE" 'PUBLIC' |
port | SQL Server puerto. | int |
sqlAuthUpdatePassword | SQL Server contraseña de inicio de sesión de sysadmin. | string |
sqlAuthUpdateUserName | SQL Server inicio de sesión sysadmin que se va a crear. | string |
SQLInstanceSettings
Nombre | Descripción | Valor |
---|---|---|
collation | SQL Server intercalación. | string |
isIfiEnabled | SQL Server IFI. | bool |
isLpimEnabled | SQL Server LPIM. | bool |
isOptimizeForAdHocWorkloadsEnabled | SQL Server Optimizar para cargas de trabajo de Adhoc. | bool |
maxDop | SQL Server MAXDOP. | int |
maxServerMemoryMB | SQL Server memoria máxima. | int |
minServerMemoryMB | SQL Server memoria mínima. | int |
SqlStorageUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
diskConfigurationType | Configuración de disco que se va a aplicar a SQL Server. | 'ADD' 'EXTEND' 'NEW' |
diskCount | Recuento de discos de máquina virtual. | int |
startingDeviceId | Id. de dispositivo del primer disco que se va a actualizar. | int |
SqlWorkloadTypeUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
sqlWorkloadType | SQL Server tipo de carga de trabajo. | "DW" "GENERAL" 'OLTP' |
StorageConfigurationSettings
Nombre | Descripción | Valor |
---|---|---|
diskConfigurationType | Configuración de disco que se va a aplicar a SQL Server. | 'ADD' 'EXTEND' 'NEW' |
sqlDataSettings | SQL Server configuración de almacenamiento de datos. | SQLStorageSettings |
sqlLogSettings | SQL Server configuración de almacenamiento de registros. | SQLStorageSettings |
sqlSystemDbOnDataDisk | SQL Server Almacenamiento de SystemDb en DataPool si es true. | bool |
sqlTempDbSettings | SQL Server configuración de almacenamiento de TempDb. | SQLTempDbSettings |
storageWorkloadType | Tipo de carga de trabajo de almacenamiento. | "DW" 'GENERAL' 'OLTP' |
SQLStorageSettings
Nombre | Descripción | Valor |
---|---|---|
defaultFilePath | SQL Server ruta de acceso de archivo predeterminada | string |
Luns | Números de unidad lógica para los discos. | int[] |
SQLTempDbSettings
Nombre | Descripción | Valor |
---|---|---|
dataFileCount | SQL Server recuento de archivos de datos tempdb | int |
dataFileSize | SQL Server tamaño del archivo de datos tempdb | int |
dataGrowth | SQL Server tamaño de crecimiento automático del archivo de datos tempdb | int |
defaultFilePath | SQL Server ruta de acceso de archivo predeterminada | string |
logFileSize | SQL Server tamaño del archivo de registro de tempdb | int |
logGrowth | SQL Server tamaño de crecimiento automático del archivo de registro de tempdb | int |
Luns | Números de unidad lógica para los discos. | int[] |
persistFolder | SQL Server opción de carpeta persistente de tempdb | bool |
persistFolderPath | SQL Server ubicación de carpeta persistente de tempdb | string |
WsfcDomainCredentials
Nombre | Descripción | Valor |
---|---|---|
clusterBootstrapAccountPassword | Contraseña de la cuenta de arranque del clúster. | string |
clusterOperatorAccountPassword | Contraseña de la cuenta del operador de clúster. | string |
sqlServiceAccountPassword | Contraseña de la cuenta de servicio de SQL. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla | Descripción |
---|---|
Implementación del programa de instalación always ON de SQL con sql Virtual Machines existente |
Implemente el programa de instalación always ON de SQL con Virtual Machines de SQL existente. Las máquinas virtuales ya deben estar unidas a un dominio existente y deben ejecutar la versión empresarial de SQL Server. |
VM con SQL Server con la configuración de almacenamiento optimizada para rendimiento |
Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento en PremiumSSD |
Configuración de almacenamiento optimizada para el rendimiento de la máquina virtual de SQL en UltraSSD |
Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento mediante UltraSSD para archivos de registro de SQL |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso sqlVirtualMachines se puede implementar en:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.SqlVirtualMachine/sqlVirtualMachines, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.SqlVirtualMachine/sqlVirtualMachines@2022-07-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "SystemAssigned"
}
body = jsonencode({
properties = {
assessmentSettings = {
enable = bool
runImmediately = bool
schedule = {
dayOfWeek = "string"
enable = bool
monthlyOccurrence = int
startTime = "string"
weeklyInterval = int
}
}
autoBackupSettings = {
backupScheduleType = "string"
backupSystemDbs = bool
daysOfWeek = [
"string"
]
enable = bool
enableEncryption = bool
fullBackupFrequency = "string"
fullBackupStartTime = int
fullBackupWindowHours = int
logBackupFrequency = int
password = "string"
retentionPeriod = int
storageAccessKey = "string"
storageAccountUrl = "string"
storageContainerName = "string"
}
autoPatchingSettings = {
dayOfWeek = "string"
enable = bool
maintenanceWindowDuration = int
maintenanceWindowStartingHour = int
}
enableAutomaticUpgrade = bool
keyVaultCredentialSettings = {
azureKeyVaultUrl = "string"
credentialName = "string"
enable = bool
servicePrincipalName = "string"
servicePrincipalSecret = "string"
}
leastPrivilegeMode = "Enabled"
serverConfigurationsManagementSettings = {
additionalFeaturesServerConfigurations = {
isRServicesEnabled = bool
}
sqlConnectivityUpdateSettings = {
connectivityType = "string"
port = int
sqlAuthUpdatePassword = "string"
sqlAuthUpdateUserName = "string"
}
sqlInstanceSettings = {
collation = "string"
isIfiEnabled = bool
isLpimEnabled = bool
isOptimizeForAdHocWorkloadsEnabled = bool
maxDop = int
maxServerMemoryMB = int
minServerMemoryMB = int
}
sqlStorageUpdateSettings = {
diskConfigurationType = "string"
diskCount = int
startingDeviceId = int
}
sqlWorkloadTypeUpdateSettings = {
sqlWorkloadType = "string"
}
}
sqlImageOffer = "string"
sqlImageSku = "string"
sqlManagement = "string"
sqlServerLicenseType = "string"
sqlVirtualMachineGroupResourceId = "string"
storageConfigurationSettings = {
diskConfigurationType = "string"
sqlDataSettings = {
defaultFilePath = "string"
luns = [
int
]
}
sqlLogSettings = {
defaultFilePath = "string"
luns = [
int
]
}
sqlSystemDbOnDataDisk = bool
sqlTempDbSettings = {
dataFileCount = int
dataFileSize = int
dataGrowth = int
defaultFilePath = "string"
logFileSize = int
logGrowth = int
luns = [
int
]
persistFolder = bool
persistFolderPath = "string"
}
storageWorkloadType = "string"
}
virtualMachineResourceId = "string"
wsfcDomainCredentials = {
clusterBootstrapAccountPassword = "string"
clusterOperatorAccountPassword = "string"
sqlServiceAccountPassword = "string"
}
wsfcStaticIp = "string"
}
})
}
Valores de propiedades
sqlVirtualMachines
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | "Microsoft.SqlVirtualMachine/sqlVirtualMachines@2022-07-01-preview" |
name | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación del recurso | string (obligatorio) |
parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. |
identity | Identidad de Azure Active Directory del servidor. | ResourceIdentity |
properties | Propiedades de recursos. | SqlVirtualMachineProperties |
ResourceIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso. | "SystemAssigned" |
SqlVirtualMachineProperties
Nombre | Descripción | Valor |
---|---|---|
assessmentSettings | Configuración de evaluación. | AssessmentSettings |
autoBackupSettings | Configuración de copia de seguridad automática para SQL Server. | AutoBackupSettings |
autoPatchingSettings | Configuración de aplicación automática de revisiones para aplicar actualizaciones de seguridad críticas a la máquina virtual SQL. | AutoPatchingSettings |
enableAutomaticUpgrade | Habilite la actualización automática del Agente de extensión iaaS de Sql. | bool |
keyVaultCredentialSettings | Configuración de credenciales del almacén de claves. | KeyVaultCredentialSettings |
leastPrivilegeMode | Modo de privilegios mínimos del Agente IaaS de SQL. | "Habilitado" |
serverConfigurationsManagementSettings | SQL Server opciones de administración de configuración. | ServerConfigurationsManagementSettings |
sqlImageOffer | Oferta de imagen de SQL. Algunos ejemplos son SQL2016-WS2016, SQL2017-WS2016. | string |
sqlImageSku | SQL Server tipo de edición. | "Desarrollador" "Enterprise" "Express" "Estándar" "Web" |
sqlManagement | SQL Server Tipo de administración. | "Lleno" "LightWeight" "NoAgent" |
sqlServerLicenseType | SQL Server tipo de licencia. | "AHUB" "DR" "PAYG" |
sqlVirtualMachineGroupResourceId | Identificador de recurso de ARM del grupo de máquinas virtuales DE SQL de la que forma parte o formará parte. | string |
storageConfigurationSettings | Opciones de configuración de almacenamiento. | StorageConfigurationSettings |
virtualMachineResourceId | Id. de recurso de ARM de la máquina virtual subyacente creada a partir de la imagen de SQL Marketplace. | string |
wsfcDomainCredentials | Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL. | WsfcDomainCredentials |
wsfcStaticIp | Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL. | string |
AssessmentSettings
Nombre | Descripción | Valor |
---|---|---|
enable | Habilite o deshabilite la característica de evaluación en la máquina virtual SQL. | bool |
runImmediately | Ejecute la evaluación inmediatamente en la máquina virtual SQL. | bool |
schedule | Programación para la evaluación. | Programación |
Programación
Nombre | Descripción | Valor |
---|---|---|
dayOfWeek | Día de la semana para ejecutar la evaluación. | "Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday" |
enable | Habilite o deshabilite la programación de evaluación en la máquina virtual SQL. | bool |
monthlyOccurrence | Repetición del día DayOfWeek en un mes para programar la evaluación. Toma valores: 1,2,3,4 y -1. Use -1 para el último día dayOfWeek del mes. | int |
startTime | Hora del día en formato HH:mm. Eg. 17:30 | string |
weeklyInterval | Número de semanas que se programan entre 2 ejecuciones de evaluación. Toma el valor de 1 a 6 | int |
AutoBackupSettings
Nombre | Descripción | Valor |
---|---|---|
backupScheduleType | Tipo de programación de copia de seguridad. | "Automatizado" "Manual" |
backupSystemDbs | Incluya o excluya las bases de datos del sistema de la copia de seguridad automática. | bool |
daysOfWeek | Días de la semana para las copias de seguridad cuando FullBackupFrequency está establecido en Weekly. | Matriz de cadenas que contiene cualquiera de: "Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday" |
enable | Habilite o deshabilite la devolución de seguridad automática en la máquina virtual SQL. | bool |
enableEncryption | Habilite o deshabilite el cifrado para la copia de seguridad en la máquina virtual SQL. | bool |
fullBackupFrequency | Frecuencia de las copias de seguridad completas. En ambos casos, las copias de seguridad completas se inician durante el siguiente período de tiempo programado. | "Diariamente" "Weekly" |
fullBackupStartTime | Hora de inicio de un día determinado durante el cual se pueden realizar copias de seguridad completas. 0-23 horas. | int |
fullBackupWindowHours | Duración del período de tiempo de un día determinado durante el cual se pueden realizar copias de seguridad completas. 1-23 horas. | int |
logBackupFrequency | Frecuencia de las copias de seguridad de registros. 5-60 minutos. | int |
password | Contraseña para el cifrado en la copia de seguridad. | string |
retentionPeriod | Período de retención de la copia de seguridad: 1-90 días. | int |
storageAccessKey | Clave de cuenta de almacenamiento en la que se realizará la copia de seguridad. | string |
storageAccountUrl | Dirección URL de la cuenta de almacenamiento en la que se realizará la copia de seguridad. | string |
storageContainerName | Nombre del contenedor de almacenamiento en el que se realizará la copia de seguridad. | string |
AutoPatchingSettings
Nombre | Descripción | Valor |
---|---|---|
dayOfWeek | Día de la semana en el que se aplicará la revisión. | "Todos los días" "Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday" |
enable | Habilite o deshabilite el autopatching en la máquina virtual SQL. | bool |
maintenanceWindowDuration | Duración de la aplicación de revisiones. | int |
maintenanceWindowStartingHour | Hora del día en que se inicia la aplicación de revisiones. Hora de la máquina virtual local. | int |
KeyVaultCredentialSettings
Nombre | Descripción | Valor |
---|---|---|
azureKeyVaultUrl | Dirección URL de Azure Key Vault. | string |
credentialName | Nombre de la credencial. | string |
enable | Habilite o deshabilite la configuración de credenciales del almacén de claves. | bool |
servicePrincipalName | Nombre de la entidad de seguridad de servicio para acceder al almacén de claves. | string |
servicePrincipalSecret | Secreto de nombre de entidad de seguridad de servicio para acceder al almacén de claves. | string |
ServerConfigurationsManagementSettings
Nombre | Descripción | Valor |
---|---|---|
additionalFeaturesServerConfigurations | Configuración adicional de características de SQL. | AdditionalFeaturesServerConfigurations |
sqlConnectivityUpdateSettings | Configuración del tipo de conectividad de SQL. | SqlConnectivityUpdateSettings |
sqlInstanceSettings | Configuración de la instancia de SQL. | SQLInstanceSettings |
sqlStorageUpdateSettings | Configuración de actualización de almacenamiento de SQL. | SqlStorageUpdateSettings |
sqlWorkloadTypeUpdateSettings | Configuración del tipo de carga de trabajo de SQL. | SqlWorkloadTypeUpdateSettings |
AdditionalFeaturesServerConfigurations
Nombre | Descripción | Valor |
---|---|---|
isRServicesEnabled | Habilite o deshabilite los servicios de R (SQL 2016 y versiones posteriores). | bool |
SqlConnectivityUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
connectivityType | SQL Server opción de conectividad. | "LOCAL" "PRIVADO" "PUBLIC" |
port | SQL Server puerto. | int |
sqlAuthUpdatePassword | SQL Server contraseña de inicio de sesión de sysadmin. | string |
sqlAuthUpdateUserName | SQL Server inicio de sesión sysadmin que se va a crear. | string |
SQLInstanceSettings
Nombre | Descripción | Valor |
---|---|---|
collation | SQL Server intercalación. | string |
isIfiEnabled | SQL Server IFI. | bool |
isLpimEnabled | SQL Server LPIM. | bool |
isOptimizeForAdHocWorkloadsEnabled | SQL Server Optimizar para cargas de trabajo de Adhoc. | bool |
maxDop | SQL Server MAXDOP. | int |
maxServerMemoryMB | SQL Server memoria máxima. | int |
minServerMemoryMB | SQL Server memoria mínima. | int |
SqlStorageUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
diskConfigurationType | Configuración de disco que se va a aplicar a SQL Server. | "ADD" "EXTEND" "NUEVO" |
diskCount | Recuento de discos de máquina virtual. | int |
startingDeviceId | Id. de dispositivo del primer disco que se va a actualizar. | int |
SqlWorkloadTypeUpdateSettings
Nombre | Descripción | Valor |
---|---|---|
sqlWorkloadType | SQL Server tipo de carga de trabajo. | "DW" "GENERAL" "OLTP" |
StorageConfigurationSettings
Nombre | Descripción | Valor |
---|---|---|
diskConfigurationType | Configuración de disco que se va a aplicar a SQL Server. | "ADD" "EXTEND" "NUEVO" |
sqlDataSettings | SQL Server configuración de almacenamiento de datos. | SQLStorageSettings |
sqlLogSettings | SQL Server configuración de almacenamiento de registros. | SQLStorageSettings |
sqlSystemDbOnDataDisk | SQL Server Almacenamiento de SystemDb en DataPool si es true. | bool |
sqlTempDbSettings | SQL Server configuración de almacenamiento de TempDb. | SQLTempDbSettings |
storageWorkloadType | Tipo de carga de trabajo de almacenamiento. | "DW" "GENERAL" "OLTP" |
SQLStorageSettings
Nombre | Descripción | Valor |
---|---|---|
defaultFilePath | SQL Server ruta de acceso de archivo predeterminada | string |
Luns | Números de unidad lógica para los discos. | int[] |
SQLTempDbSettings
Nombre | Descripción | Valor |
---|---|---|
dataFileCount | SQL Server recuento de archivos de datos tempdb | int |
dataFileSize | SQL Server tamaño del archivo de datos tempdb | int |
dataGrowth | SQL Server tamaño de crecimiento automático del archivo de datos tempdb | int |
defaultFilePath | SQL Server ruta de acceso de archivo predeterminada | string |
logFileSize | SQL Server tamaño del archivo de registro de tempdb | int |
logGrowth | SQL Server tamaño de crecimiento automático del archivo de registro de tempdb | int |
Luns | Números de unidad lógica para los discos. | int[] |
persistFolder | SQL Server opción de carpeta persistente de tempdb | bool |
persistFolderPath | SQL Server ubicación de carpeta persistente de tempdb | string |
WsfcDomainCredentials
Nombre | Descripción | Valor |
---|---|---|
clusterBootstrapAccountPassword | Contraseña de la cuenta de arranque del clúster. | string |
clusterOperatorAccountPassword | Contraseña de la cuenta del operador de clúster. | string |
sqlServiceAccountPassword | Contraseña de la cuenta de servicio SQL. | string |