Udostępnij przez


Serwery Microsoft.Sql/elasticPools

Definicja zasobu Bicep

Typ zasobu servers/elasticPools można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Sql/servers/elasticPools, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Sql/servers/elasticPools@2024-11-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'
  }
}

Wartości właściwości

Microsoft.Sql/servers/elasticPools

Name Description Value
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
name Nazwa zasobu ciąg (wymagany)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: serwery
properties Właściwości zasobu. ElasticPoolProperties
sku Jednostka SKU puli elastycznej.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla Subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub następującego polecenia:

```azurecli
az SQL elastic-pool list-editions -l <location> -o table
````
Sku
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Automatyczne wstrzymywanie opóźnienia dla bazy danych w puli int
maxCapacity Maksymalna pojemność, jaką może zużywać dowolna baza danych. int
minCapacity Minimalna pojemność wszystkich baz danych jest gwarantowana. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Czas w minutach, po którym pula elastyczna jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone int
availabilityZone Określa strefę dostępności, do których jest przypięta replika podstawowa puli. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Liczba replik pomocniczych skojarzonych z elastyczną pulą warstwy Krytyczne dla działania firmy, Premium lub Hiperskala, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala. int
licenseType Typ licencji do zastosowania dla tej elastycznej puli. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Identyfikator konfiguracji konserwacji przypisany do elastycznej puli. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. ciąg
maxSizeBytes Limit magazynu dla elastycznej puli bazy danych w bajtach. int
minCapacity Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana int
perDatabaseSettings Ustawienia poszczególnych baz danych dla elastycznej puli. ElasticPoolPerDatabaseSettings
preferredEnclaveType Typ enklawy żądanej w puli elastycznej. 'Default'
'VBS'
zoneRedundant Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności. bool

Sku

Name Description Value
dyspozycyjność Pojemność określonej jednostki SKU. int
family Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
name Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. ciąg (wymagany)
size Rozmiar konkretnej jednostki SKU ciąg
warstwa Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

TrackedResourceTags

Name Description Value

Definicja zasobu szablonu usługi ARM

Typ zasobu servers/elasticPools można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Sql/servers/elasticPools, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Sql/servers/elasticPools",
  "apiVersion": "2024-11-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"
  }
}

Wartości właściwości

Microsoft.Sql/servers/elasticPools

Name Description Value
apiVersion Wersja interfejsu API '2024-11-01-preview'
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
name Nazwa zasobu ciąg (wymagany)
properties Właściwości zasobu. ElasticPoolProperties
sku Jednostka SKU puli elastycznej.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla Subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub następującego polecenia:

```azurecli
az SQL elastic-pool list-editions -l <location> -o table
````
Sku
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu 'Microsoft.Sql/servers/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Automatyczne wstrzymywanie opóźnienia dla bazy danych w puli int
maxCapacity Maksymalna pojemność, jaką może zużywać dowolna baza danych. int
minCapacity Minimalna pojemność wszystkich baz danych jest gwarantowana. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Czas w minutach, po którym pula elastyczna jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone int
availabilityZone Określa strefę dostępności, do których jest przypięta replika podstawowa puli. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Liczba replik pomocniczych skojarzonych z elastyczną pulą warstwy Krytyczne dla działania firmy, Premium lub Hiperskala, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala. int
licenseType Typ licencji do zastosowania dla tej elastycznej puli. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Identyfikator konfiguracji konserwacji przypisany do elastycznej puli. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. ciąg
maxSizeBytes Limit magazynu dla elastycznej puli bazy danych w bajtach. int
minCapacity Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana int
perDatabaseSettings Ustawienia poszczególnych baz danych dla elastycznej puli. ElasticPoolPerDatabaseSettings
preferredEnclaveType Typ enklawy żądanej w puli elastycznej. 'Default'
'VBS'
zoneRedundant Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności. bool

Sku

Name Description Value
dyspozycyjność Pojemność określonej jednostki SKU. int
family Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
name Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. ciąg (wymagany)
size Rozmiar konkretnej jednostki SKU ciąg
warstwa Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

TrackedResourceTags

Name Description Value

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template Description
Wdrażanie nowej elastycznej puli SQL

Wdrażanie na platformie Azure
Ten szablon umożliwia wdrożenie nowej elastycznej puli SQL wraz z nowym skojarzonym programem SQL Server i nowymi bazami danych SQL Database w celu przypisania do niego.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu servers/elasticPools można wdrożyć przy użyciu operacji docelowych:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Sql/servers/elasticPools, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/elasticPools@2024-11-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"
    }
  }
}

Wartości właściwości

Microsoft.Sql/servers/elasticPools

Name Description Value
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
name Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: serwerów
properties Właściwości zasobu. ElasticPoolProperties
sku Jednostka SKU puli elastycznej.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla Subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub następującego polecenia:

```azurecli
az SQL elastic-pool list-editions -l <location> -o table
````
Sku
tags Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Sql/servers/elasticPools@2024-11-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Automatyczne wstrzymywanie opóźnienia dla bazy danych w puli int
maxCapacity Maksymalna pojemność, jaką może zużywać dowolna baza danych. int
minCapacity Minimalna pojemność wszystkich baz danych jest gwarantowana. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Czas w minutach, po którym pula elastyczna jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone int
availabilityZone Określa strefę dostępności, do których jest przypięta replika podstawowa puli. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Liczba replik pomocniczych skojarzonych z elastyczną pulą warstwy Krytyczne dla działania firmy, Premium lub Hiperskala, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala. int
licenseType Typ licencji do zastosowania dla tej elastycznej puli. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Identyfikator konfiguracji konserwacji przypisany do elastycznej puli. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. ciąg
maxSizeBytes Limit magazynu dla elastycznej puli bazy danych w bajtach. int
minCapacity Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana int
perDatabaseSettings Ustawienia poszczególnych baz danych dla elastycznej puli. ElasticPoolPerDatabaseSettings
preferredEnclaveType Typ enklawy żądanej w puli elastycznej. 'Default'
'VBS'
zoneRedundant Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności. bool

Sku

Name Description Value
dyspozycyjność Pojemność określonej jednostki SKU. int
family Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
name Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. ciąg (wymagany)
size Rozmiar konkretnej jednostki SKU ciąg
warstwa Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

TrackedResourceTags

Name Description Value

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania elastycznej puli Azure SQL.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azurerm_client_config" "current" {
}

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

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "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    = ["*"]
}

Podstawowy przykład wdrażania elastycznej puli Azure SQL.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azurerm_client_config" "current" {
}

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

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "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    = ["*"]
}