Microsoft.SqlVirtualMachine sqlVirtualMachines

  • Artikel
  • 7 menit untuk membaca

The sqlVirtualMachines resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

For a list of changed properties in each API version, see change log.

Template format

To create a Microsoft.SqlVirtualMachine/sqlVirtualMachines resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.SqlVirtualMachine/sqlVirtualMachines@2021-11-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
    }
    keyVaultCredentialSettings: {
      azureKeyVaultUrl: 'string'
      credentialName: 'string'
      enable: bool
      servicePrincipalName: 'string'
      servicePrincipalSecret: 'string'
    }
    serverConfigurationsManagementSettings: {
      additionalFeaturesServerConfigurations: {
        isRServicesEnabled: bool
      }
      sqlConnectivityUpdateSettings: {
        connectivityType: 'string'
        port: int
        sqlAuthUpdatePassword: 'string'
        sqlAuthUpdateUserName: 'string'
      }
      sqlInstanceSettings: {
        collation: 'string'
        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
        ]
      }
      storageWorkloadType: 'string'
    }
    virtualMachineResourceId: 'string'
    wsfcDomainCredentials: {
      clusterBootstrapAccountPassword: 'string'
      clusterOperatorAccountPassword: 'string'
      sqlServiceAccountPassword: 'string'
    }
  }
}

Property values

sqlVirtualMachines

Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.		 'Microsoft.SqlVirtualMachine/sqlVirtualMachines'
apiVersion The resource api version

For Bicep, set this value in the resource declaration.		 '2021-11-01-preview'
name The resource name string (required)
location Resource location. string (required)
tags Resource tags. Dictionary of tag names and values. See Tags in templates
identity Azure Active Directory identity of the server. ResourceIdentity
properties Resource properties. SqlVirtualMachineProperties

ResourceIdentity

Name Description Value
type The identity type. Set this to 'SystemAssigned' in order to automatically create and assign an Azure Active Directory principal for the resource. 'None'
'SystemAssigned'

SqlVirtualMachineProperties

Name Description Value
assessmentSettings Assessment Settings. AssessmentSettings
autoBackupSettings Auto backup settings for SQL Server. AutoBackupSettings
autoPatchingSettings Auto patching settings for applying critical security updates to SQL virtual machine. AutoPatchingSettings
keyVaultCredentialSettings Key vault credential settings. KeyVaultCredentialSettings
serverConfigurationsManagementSettings SQL Server configuration management settings. ServerConfigurationsManagementSettings
sqlImageOffer SQL image offer. Examples include SQL2016-WS2016, SQL2017-WS2016. string
sqlImageSku SQL Server edition type. 'Developer'
'Enterprise'
'Express'
'Standard'
'Web'
sqlManagement SQL Server Management type. 'Full'
'LightWeight'
'NoAgent'
sqlServerLicenseType SQL Server license type. 'AHUB'
'DR'
'PAYG'
sqlVirtualMachineGroupResourceId ARM resource id of the SQL virtual machine group this SQL virtual machine is or will be part of. string
storageConfigurationSettings Storage Configuration Settings. StorageConfigurationSettings
virtualMachineResourceId ARM Resource id of underlying virtual machine created from SQL marketplace image. string
wsfcDomainCredentials Domain credentials for setting up Windows Server Failover Cluster for SQL availability group. WsfcDomainCredentials

AssessmentSettings

Name Description Value
enable Enable or disable assessment feature on SQL virtual machine. bool
runImmediately Run assessment immediately on SQL virtual machine. bool
schedule Schedule for Assessment. Schedule

Schedule

Name Description Value
dayOfWeek Day of the week to run assessment. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
enable Enable or disable assessment schedule on SQL virtual machine. bool
monthlyOccurrence Occurrence of the DayOfWeek day within a month to schedule assessment. Takes values: 1,2,3,4 and -1. Use -1 for last DayOfWeek day of the month int
startTime Time of the day in HH:mm format. Eg. 17:30 string
weeklyInterval Number of weeks to schedule between 2 assessment runs. Takes value from 1-6 int

AutoBackupSettings

Name Description Value
backupScheduleType Backup schedule type. 'Automated'
'Manual'
backupSystemDbs Include or exclude system databases from auto backup. bool
daysOfWeek Days of the week for the backups when FullBackupFrequency is set to Weekly. String array containing any of:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
enable Enable or disable autobackup on SQL virtual machine. bool
enableEncryption Enable or disable encryption for backup on SQL virtual machine. bool
fullBackupFrequency Frequency of full backups. In both cases, full backups begin during the next scheduled time window. 'Daily'
'Weekly'
fullBackupStartTime Start time of a given day during which full backups can take place. 0-23 hours. int
fullBackupWindowHours Duration of the time window of a given day during which full backups can take place. 1-23 hours. int
logBackupFrequency Frequency of log backups. 5-60 minutes. int
password Password for encryption on backup. string
retentionPeriod Retention period of backup: 1-90 days. int
storageAccessKey Storage account key where backup will be taken to. string
storageAccountUrl Storage account url where backup will be taken to. string
storageContainerName Storage container name where backup will be taken to. string

AutoPatchingSettings

Name Description Value
dayOfWeek Day of week to apply the patch on. 'Everyday'
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
enable Enable or disable autopatching on SQL virtual machine. bool
maintenanceWindowDuration Duration of patching. int
maintenanceWindowStartingHour Hour of the day when patching is initiated. Local VM time. int

KeyVaultCredentialSettings

Name Description Value
azureKeyVaultUrl Azure Key Vault url. string
credentialName Credential name. string
enable Enable or disable key vault credential setting. bool
servicePrincipalName Service principal name to access key vault. string
servicePrincipalSecret Service principal name secret to access key vault. string

ServerConfigurationsManagementSettings

Name Description Value
additionalFeaturesServerConfigurations Additional SQL feature settings. AdditionalFeaturesServerConfigurations
sqlConnectivityUpdateSettings SQL connectivity type settings. SqlConnectivityUpdateSettings
sqlInstanceSettings SQL Instance settings. SQLInstanceSettings
sqlStorageUpdateSettings SQL storage update settings. SqlStorageUpdateSettings
sqlWorkloadTypeUpdateSettings SQL workload type settings. SqlWorkloadTypeUpdateSettings

AdditionalFeaturesServerConfigurations

Name Description Value
isRServicesEnabled Enable or disable R services (SQL 2016 onwards). bool

SqlConnectivityUpdateSettings

Name Description Value
connectivityType SQL Server connectivity option. 'LOCAL'
'PRIVATE'
'PUBLIC'
port SQL Server port. int
sqlAuthUpdatePassword SQL Server sysadmin login password. string
sqlAuthUpdateUserName SQL Server sysadmin login to create. string

SQLInstanceSettings

Name Description Value
collation SQL Server Collation. string
isOptimizeForAdHocWorkloadsEnabled SQL Server Optimize for Adhoc workloads. bool
maxDop SQL Server MAXDOP. int
maxServerMemoryMB SQL Server maximum memory. int
minServerMemoryMB SQL Server minimum memory. int

SqlStorageUpdateSettings

Name Description Value
diskConfigurationType Disk configuration to apply to SQL Server. 'ADD'
'EXTEND'
'NEW'
diskCount Virtual machine disk count. int
startingDeviceId Device id of the first disk to be updated. int

SqlWorkloadTypeUpdateSettings

Name Description Value
sqlWorkloadType SQL Server workload type. 'DW'
'GENERAL'
'OLTP'

StorageConfigurationSettings

Name Description Value
diskConfigurationType Disk configuration to apply to SQL Server. 'ADD'
'EXTEND'
'NEW'
sqlDataSettings SQL Server Data Storage Settings. SQLStorageSettings
sqlLogSettings SQL Server Log Storage Settings. SQLStorageSettings
sqlSystemDbOnDataDisk SQL Server SystemDb Storage on DataPool if true. bool
sqlTempDbSettings SQL Server TempDb Storage Settings. SQLTempDbSettings
storageWorkloadType Storage workload type. 'DW'
'GENERAL'
'OLTP'

SQLStorageSettings

Name Description Value
defaultFilePath SQL Server default file path string
luns Logical Unit Numbers for the disks. int[]

SQLTempDbSettings

Name Description Value
dataFileCount SQL Server default file count int
dataFileSize SQL Server default file size int
dataGrowth SQL Server default file autoGrowth size int
defaultFilePath SQL Server default file path string
logFileSize SQL Server default file size int
logGrowth SQL Server default file autoGrowth size int
luns Logical Unit Numbers for the disks. int[]

WsfcDomainCredentials

Name Description Value
clusterBootstrapAccountPassword Cluster bootstrap account password. string
clusterOperatorAccountPassword Cluster operator account password. string
sqlServiceAccountPassword SQL service account password. string

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Deploy SQL Always ON setup with existing SQL Virtual Machines

Deploy to Azure		 Deploy SQL Always ON setup with existing SQL Virtual Machines. The virtual machines should already be joined to an existing domain and must be running enterprise version of SQL Server.
SQL Server VM with performance optimized storage settings

Deploy to Azure		 Create a SQL Server Virtual Machine with performance optimized storage settings on PremiumSSD
SQL VM Performance Optimized Storage Settings on UltraSSD

Deploy to Azure		 Create a SQL Server Virtual Machine with performance optimized storage settings, using UltraSSD for SQL Log files