terraform/website/source/docs/providers/azurerm/r/sql_elasticpool.html.markdown

3.5 KiB

layout page_title sidebar_current description
azurerm Azure Resource Manager: azurerm_sql_elasticpool docs-azurerm-resource-sql-elasticpool Create a SQL Elastic Pool.

azurerm_sql_elasticpool

Allows you to manage an Azure SQL Elastic Pool.

Example Usage

resource "azurerm_resource_group" "test" {
  name = "test"
  location = "West US"
}

resource "azurerm_sql_server" "test" {
    name = "test"
    resource_group_name = "${azurerm_resource_group.test.name}"
    location = "West US"
    version = "12.0"
    administrator_login = "4dm1n157r470r"
    administrator_login_password = "4-v3ry-53cr37-p455w0rd"
}

resource "azurerm_sql_elasticpool" "test" {
    name = "test"
    resource_group_name = "${azurerm_resource_group.test.name}"
    location = "West US"
    server_name = "${azurerm_sql_server.test.name}"
    edition = "Basic"
    dtu = 100
    db_dtu_min = 0
    db_dtu_max = 5
    pool_size = 5000
}

~> NOTE on azurerm_sql_elasticpool: - The values of edition, dtu, and pool_size must be consistent with the Azure SQL Database Service Tiers. Any inconsistent argument configuration will be rejected.

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the elastic pool.

  • resource_group_name - (Required) The name of the resource group in which to create the elastic pool. This must be the same as the resource group of the underlying SQL server.

  • location - (Required) Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.

  • server_name - (Required) The name of the SQL Server on which to create the elastic pool. Changing this forces a new resource to be created.

  • edition - (Required) The edition of the elastic pool to be created. Valid values are Basic, Standard, and Premium. Refer to Azure SQL Database Service Tiers for details. Changing this forces a new resource to be created.

  • dtu - (Required) The total shared DTU for the elastic pool. Valid values depend on the edition which has been defined. Refer to Azure SQL Database Service Tiers for valid combinations.

  • db_dtu_min - (Optional) The minimum DTU which will be guaranteed to all databases in the elastic pool to be created.

  • db_dtu_max - (Optional) The maximum DTU which will be guaranteed to all databases in the elastic pool to be created.

  • pool_size - (Optional) The maximum size in MB that all databases in the elastic pool can grow to. The maximum size must be consistent with combination of edition and dtu and the limits documented in Azure SQL Database Service Tiers. If not defined when creating an elastic pool, the value is set to the size implied by edition and dtu.

  • tags - (Optional) A mapping of tags to assign to the resource.

Attributes Reference

The following attributes are exported:

  • id - The SQL Elastic Pool ID.

  • creation_date - The creation date of the SQL Elastic Pool.