Microsoft. SQL servers/elasticPools

Bicep kaynak tanımı

Sunucular/elasticPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kullanım Örnekleri

Bicep Örnekleri

Azure SQL Elastic Pool'un dağıtımına temel bir örnek.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@secure()
@description('The administrator login password for the SQL server')
param administratorLoginPassword string

resource server 'Microsoft.Sql/servers@2021-02-01-preview' = {
  name: resourceName
  location: location
  properties: {
    administratorLogin: '4dm1n157r470r'
    administratorLoginPassword: administratorLoginPassword
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

resource elasticPool 'Microsoft.Sql/servers/elasticPools@2020-11-01-preview' = {
  name: resourceName
  location: location
  parent: server
  sku: {
    capacity: 50
    family: ''
    name: 'BasicPool'
    tier: 'Basic'
  }
  properties: {
    maintenanceConfigurationId: resourceId('Microsoft.Maintenance/publicMaintenanceConfigurations', 'SQL_Default')
    maxSizeBytes: 5242880000
    perDatabaseSettings: {
      maxCapacity: 5
      minCapacity: 0
    }
    zoneRedundant: false
  }
}

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/servers/elasticPools kaynağı, aşağıdaki Bicep'i şablonunuza ekleyin.

resource symbolicname 'Microsoft.Sql/servers/elasticPools@2025-02-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoPauseDelay: int
    availabilityZone: 'string'
    highAvailabilityReplicaCount: int
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    maxSizeBytes: int
    minCapacity: int
    perDatabaseSettings: {
      autoPauseDelay: int
      maxCapacity: int
      minCapacity: int
    }
    preferredEnclaveType: 'string'
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Özellik Değerleri

Microsoft. Sql/servers/elasticPools

Name Description Value
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı dize (gerekli)
parent Bicep'te, bir çocuk kaynağın ana kaynağını belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.
Kaynak türü için sembolik ad: sunucuları
properties Kaynak özellikleri. ElasticPoolProperties
sku Elastik havuz SKU'su.

SKU'ların listesi bölgeye ve destek teklifine göre farklılık gösterebilir. Azure bölgede aboneliğinize sunulabilecek SKU'ları (SKU adı, seviye/sürüm, aile ve kapasite dahil) belirlemek için Capabilities_ListByLocation REST API'sini veya aşağıdaki komutu kullanın:

azurecli<br />az sql elastic-pool list-editions -l &lt;location&gt; -o table<br />
Sku
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Havuz içindeki veritabanı başına Otomatik Duraklatma Gecikmesi int
maxCapacity Herhangi bir veritabanının kullanabileceği maksimum kapasite. int
minCapacity Tüm veritabanları için minimum kapasite garanti edilir. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Elastik havuzun otomatik olarak duraklatıldığı dakika cinsinden süre. -1 değeri, otomatik duraklatma'nın devre dışı bırakıldığını gösterir int
availabilityZone Havuzun birincil çoğaltmasının sabitlendiği kullanılabilirlik alanını belirtir. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount yüksek kullanılabilirlik sağlamak için kullanılan İş Açısından Kritik, Premium veya Hiper Ölçek sürümü elastik havuzuyla ilişkili ikincil çoğaltmaların sayısı. Yalnızca Hiper Ölçek elastik havuzları için geçerlidir. int
licenseType Bu elastik havuz için uygulanacak lisans türü. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Elastik havuza atanan bakım yapılandırma kimliği. Bu yapılandırma, bakım güncelleştirmelerinin gerçekleşeceği dönemi tanımlar. string
maxSizeBytes Veritabanı elastik havuzu için bayt cinsinden depolama sınırı. int
minCapacity Duraklatılmadıysa sunucusuz havuzun altta küçülmediği en düşük kapasite int
perDatabaseSettings Elastik havuzun veritabanı başına ayarları. ElasticPoolPerDatabaseSettings
preferredEnclaveType Elastik havuzda istenen kapanım türü. 'Default'
'VBS'
zoneRedundant Bu elastik havuzun alanlar arası yedekli olup olmadığı, bu elastik havuzun çoğaltmalarının birden çok kullanılabilirlik alanına yayılacağı anlamına gelir. bool

Sku

Name Description Value
capacity Belirli bir SKU'nun kapasitesi. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
size Belirli SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

TrackedResourceTags

Name Description Value

ARM şablonu kaynak tanımı

Sunucular/elasticPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Azure Quickstart Şablonları

Aşağıdaki Azure Hızlı başlat şablonları bu kaynak tipini dağıtır.

Template Description
Yeni bir SQL Elastic Pool

Azure
Bu şablon, yeni bir SQL Elastik Havuzu, ona bağlı yeni SQL Server ve yeni SQL Veritabanları ile birlikte dağıtmanıza olanak tanır.

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/servers/elasticPools kaynağı, aşağıdaki JSON'u şablonunuza ekleyin.

{
  "type": "Microsoft.Sql/servers/elasticPools",
  "apiVersion": "2025-02-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "autoPauseDelay": "int",
    "availabilityZone": "string",
    "highAvailabilityReplicaCount": "int",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "maxSizeBytes": "int",
    "minCapacity": "int",
    "perDatabaseSettings": {
      "autoPauseDelay": "int",
      "maxCapacity": "int",
      "minCapacity": "int"
    },
    "preferredEnclaveType": "string",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Özellik Değerleri

Microsoft. Sql/servers/elasticPools

Name Description Value
apiVersion API sürümü '2025-02-01-önizleme'
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı dize (gerekli)
properties Kaynak özellikleri. ElasticPoolProperties
sku Elastik havuz SKU'su.

SKU'ların listesi bölgeye ve destek teklifine göre farklılık gösterebilir. Azure bölgede aboneliğinize sunulabilecek SKU'ları (SKU adı, seviye/sürüm, aile ve kapasite dahil) belirlemek için Capabilities_ListByLocation REST API'sini veya aşağıdaki komutu kullanın:

azurecli<br />az sql elastic-pool list-editions -l &lt;location&gt; -o table<br />
Sku
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
type Kaynak türü 'Microsoft. Sql/servers/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Havuz içindeki veritabanı başına Otomatik Duraklatma Gecikmesi int
maxCapacity Herhangi bir veritabanının kullanabileceği maksimum kapasite. int
minCapacity Tüm veritabanları için minimum kapasite garanti edilir. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Elastik havuzun otomatik olarak duraklatıldığı dakika cinsinden süre. -1 değeri, otomatik duraklatma'nın devre dışı bırakıldığını gösterir int
availabilityZone Havuzun birincil çoğaltmasının sabitlendiği kullanılabilirlik alanını belirtir. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount yüksek kullanılabilirlik sağlamak için kullanılan İş Açısından Kritik, Premium veya Hiper Ölçek sürümü elastik havuzuyla ilişkili ikincil çoğaltmaların sayısı. Yalnızca Hiper Ölçek elastik havuzları için geçerlidir. int
licenseType Bu elastik havuz için uygulanacak lisans türü. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Elastik havuza atanan bakım yapılandırma kimliği. Bu yapılandırma, bakım güncelleştirmelerinin gerçekleşeceği dönemi tanımlar. string
maxSizeBytes Veritabanı elastik havuzu için bayt cinsinden depolama sınırı. int
minCapacity Duraklatılmadıysa sunucusuz havuzun altta küçülmediği en düşük kapasite int
perDatabaseSettings Elastik havuzun veritabanı başına ayarları. ElasticPoolPerDatabaseSettings
preferredEnclaveType Elastik havuzda istenen kapanım türü. 'Default'
'VBS'
zoneRedundant Bu elastik havuzun alanlar arası yedekli olup olmadığı, bu elastik havuzun çoğaltmalarının birden çok kullanılabilirlik alanına yayılacağı anlamına gelir. bool

Sku

Name Description Value
capacity Belirli bir SKU'nun kapasitesi. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
size Belirli SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

TrackedResourceTags

Name Description Value

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Sunucular/elasticPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Terraform Örnekleri

Azure SQL Elastic Pool'un dağıtımına temel bir örnek.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azurerm_client_config" "current" {
}

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

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

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

resource "azapi_resource" "elasticPool" {
  type      = "Microsoft.Sql/servers/elasticPools@2020-11-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      maintenanceConfigurationId = data.azapi_resource_id.publicMaintenanceConfiguration.id
      maxSizeBytes               = 5.24288e+09
      perDatabaseSettings = {
        maxCapacity = 5
        minCapacity = 0
      }
      zoneRedundant = false
    }
    sku = {
      capacity = 50
      family   = ""
      name     = "BasicPool"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure SQL Elastic Pool'un dağıtımına temel bir örnek.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azurerm_client_config" "current" {
}

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

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

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

resource "azapi_resource" "elasticPool" {
  type      = "Microsoft.Sql/servers/elasticPools@2020-11-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      maintenanceConfigurationId = data.azapi_resource_id.publicMaintenanceConfiguration.id
      maxSizeBytes               = 5.24288e+09
      perDatabaseSettings = {
        maxCapacity = 5
        minCapacity = 0
      }
      zoneRedundant = false
    }
    sku = {
      capacity = 50
      family   = ""
      name     = "BasicPool"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/servers/elasticPools kaynağı için aşağıdaki Terraform'u şablonunuza ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/elasticPools@2025-02-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      autoPauseDelay = int
      availabilityZone = "string"
      highAvailabilityReplicaCount = int
      licenseType = "string"
      maintenanceConfigurationId = "string"
      maxSizeBytes = int
      minCapacity = int
      perDatabaseSettings = {
        autoPauseDelay = int
        maxCapacity = int
        minCapacity = int
      }
      preferredEnclaveType = "string"
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Özellik Değerleri

Microsoft. Sql/servers/elasticPools

Name Description Value
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı dize (gerekli)
parent_id Bu kaynağın üst öğesi olan kaynağın kimliği. Tür kaynağı kimliği: sunucuları
properties Kaynak özellikleri. ElasticPoolProperties
sku Elastik havuz SKU'su.

SKU'ların listesi bölgeye ve destek teklifine göre farklılık gösterebilir. Azure bölgede aboneliğinize sunulabilecek SKU'ları (SKU adı, seviye/sürüm, aile ve kapasite dahil) belirlemek için Capabilities_ListByLocation REST API'sini veya aşağıdaki komutu kullanın:

azurecli<br />az sql elastic-pool list-editions -l &lt;location&gt; -o table<br />
Sku
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
type Kaynak türü "Microsoft. Sql/servers/elasticPools@2025-02-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Havuz içindeki veritabanı başına Otomatik Duraklatma Gecikmesi int
maxCapacity Herhangi bir veritabanının kullanabileceği maksimum kapasite. int
minCapacity Tüm veritabanları için minimum kapasite garanti edilir. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Elastik havuzun otomatik olarak duraklatıldığı dakika cinsinden süre. -1 değeri, otomatik duraklatma'nın devre dışı bırakıldığını gösterir int
availabilityZone Havuzun birincil çoğaltmasının sabitlendiği kullanılabilirlik alanını belirtir. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount yüksek kullanılabilirlik sağlamak için kullanılan İş Açısından Kritik, Premium veya Hiper Ölçek sürümü elastik havuzuyla ilişkili ikincil çoğaltmaların sayısı. Yalnızca Hiper Ölçek elastik havuzları için geçerlidir. int
licenseType Bu elastik havuz için uygulanacak lisans türü. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Elastik havuza atanan bakım yapılandırma kimliği. Bu yapılandırma, bakım güncelleştirmelerinin gerçekleşeceği dönemi tanımlar. string
maxSizeBytes Veritabanı elastik havuzu için bayt cinsinden depolama sınırı. int
minCapacity Duraklatılmadıysa sunucusuz havuzun altta küçülmediği en düşük kapasite int
perDatabaseSettings Elastik havuzun veritabanı başına ayarları. ElasticPoolPerDatabaseSettings
preferredEnclaveType Elastik havuzda istenen kapanım türü. 'Default'
'VBS'
zoneRedundant Bu elastik havuzun alanlar arası yedekli olup olmadığı, bu elastik havuzun çoğaltmalarının birden çok kullanılabilirlik alanına yayılacağı anlamına gelir. bool

Sku

Name Description Value
capacity Belirli bir SKU'nun kapasitesi. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
size Belirli SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

TrackedResourceTags

Name Description Value