76 lines
3.5 KiB
Markdown
76 lines
3.5 KiB
Markdown
|
---
|
||
|
|
layout: "azurerm"
|
||
|
|
page_title: "Azure Resource Manager: azurerm_sql_elasticpool"
|
||
|
|
sidebar_current: "docs-azurerm-resource-sql-elasticpool"
|
||
|
|
description: |-
|
||
|
|
Create a SQL Elastic Pool.
|
||
|
|
---
|
||
|
|
|
||
|
|
# azurerm\_sql\_elasticpool
|
||
|
|
|
||
|
|
Allows you to manage an Azure SQL Elastic Pool.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```hcl
|
||
|
|
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_min_dtu = 0
|
||
|
|
db_max_dtu = 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](https://docs.microsoft.com/en-gb/azure/sql-database/sql-database-service-tiers#elastic-pool-service-tiers-and-performance-in-edtus). 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](https://docs.microsoft.com/en-gb/azure/sql-database/sql-database-service-tiers#elastic-pool-service-tiers-and-performance-in-edtus) 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](https://docs.microsoft.com/en-gb/azure/sql-database/sql-database-service-tiers#elastic-pool-service-tiers-and-performance-in-edtus) 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](https://docs.microsoft.com/en-gb/azure/sql-database/sql-database-service-tiers#elastic-pool-service-tiers-and-performance-in-edtus). 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_data` - The creation date of the SQL Elastic Pool.
|