az sql elastic-pool

  • Referência

Gerenciar pools elásticos.

Comandos

Nome Description Tipo Status
az sql elastic-pool create

Criar um pool elástico.

 Núcleo GA
az sql elastic-pool delete

Exclui um pool elástico.

 Núcleo GA
az sql elastic-pool list

Obtém todos os pools elásticos em um servidor.

 Núcleo GA
az sql elastic-pool list-dbs

Obtém uma lista de bancos de dados em um pool elástico.

 Núcleo GA
az sql elastic-pool list-editions

Listar edições de pool elástico disponíveis para a assinatura ativa.

 Núcleo GA
az sql elastic-pool op

Gerenciar operações em um pool elástico.

 Núcleo GA
az sql elastic-pool op cancel

Cancela a operação assíncrona no pool elástico.

 Núcleo GA
az sql elastic-pool op list

Obtém uma lista de operações executadas no pool elástico.

 Núcleo GA
az sql elastic-pool show

Obtém um pool elástico.

 Núcleo GA
az sql elastic-pool update

Atualize um pool elástico.

 Núcleo GA

az sql elastic-pool create

Editar

Criar um pool elástico.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

Exemplos

Criar pool elástico com redundância de zona habilitada

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

Criar pool elástico com redundância de zona explicitamente desabilitada

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

Crie um pool elástico DTU padrão de 100.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

Crie um pool elástico com edição GeneralPurpose, hardware Gen4 e 1 vcore.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

Crie um pool elástico com Hyperscale edition, hardware Gen5, 4 vcore e 2 réplicas de alta disponibilidade.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

Crie um pool elástico com o enclave VBS.

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

Parâmetros Exigidos

--name -n

O nome do pool elástico.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>o .

Parâmetros Opcionais

--capacity --dtu -c

O componente de capacidade do sku em número inteiro de DTUs ou vcores.

--db-dtu-max --db-max-capacity --db-max-dtu

A capacidade máxima (em DTUs ou vcores) que qualquer banco de dados pode consumir.

--db-dtu-min --db-min-capacity --db-min-dtu

A capacidade mínima (em DTUs ou vcores) de cada banco de dados é garantida.

--edition --tier -e

O componente de edição do sku. Os valores permitidos incluem: Basic, Standard, Premium, GeneralPurpose, BusinessCritical.

--family -f

O componente de geração de computação do sku (somente para skus vcore). Os valores permitidos incluem: Gen4, Gen5.

--ha-replicas --read-replicas

O número de réplicas de alta disponibilidade a serem provisionadas para o banco de dados. Apenas configurável para a edição Hyperscale.

--license-type

O tipo de licença a ser aplicado a esse pool elástico.

Valores aceitos: BasePrice, LicenseIncluded
--maint-config-id -m

ID ou nome de configuração de manutenção especificado para este recurso.

--max-size --storage

O tamanho máximo de armazenamento. Se nenhuma unidade for especificada, o padrão será bytes (B).

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--preferred-enclave-type

O tipo de enclave preferencial para o Azure SQL Elastic Pool. Os valores permitidos incluem: Default, VBS.

Valores aceitos: Default, VBS
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--zone-redundant -z

Especifica se a redundância de zona deve ser habilitada. O padrão será true se nenhum valor for especificado.

Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql elastic-pool delete

Editar

Exclui um pool elástico.

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do pool elástico.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>o .

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql elastic-pool list

Editar

Obtém todos os pools elásticos em um servidor.

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>o .

--skip

O número de elementos na coleção a serem ignorados. O valor padrão é Nenhum.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql elastic-pool list-dbs

Editar

Obtém uma lista de bancos de dados em um pool elástico.

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do pool elástico.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>o .

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql elastic-pool list-editions

Editar

Listar edições de pool elástico disponíveis para a assinatura ativa.

Também inclui as configurações DTU do pool disponível, limites de armazenamento e configurações por banco de dados. Para reduzir o detalhamento, os limites de armazenamento adicionais e as configurações por banco de dados ficam ocultos por padrão.

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

Exemplos

Mostrar todas as edições de pool elástico e limites de DTU de pool na região Oeste dos EUA.

az sql elastic-pool list-editions -l westus -o table

Mostrar todos os limites de DTU de pool para a edição Standard na região Oeste dos EUA.

az sql elastic-pool list-editions -l westus --edition Standard -o table

Mostrar tamanhos máximos disponíveis para pools elásticos com pelo menos 100 DTUs na região Oeste dos EUA.

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

Mostrar configurações disponíveis por banco de dados para pools elásticos DTU padrão 100 na região Oeste dos EUA.

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

Parâmetros Exigidos

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

Parâmetros Opcionais

--available -a

Se especificado, mostre apenas os resultados disponíveis na região especificada.

Valor padrão: False
--dtu

Número de DTUs a serem pesquisadas. Se não especificado, todos os tamanhos de DTU são mostrados.

--edition --tier -e

Edição para pesquisar. Se não for especificado, todas as edições serão mostradas.

--show-details -d

Lista de detalhes adicionais a serem incluídos na saída.

Valores aceitos: db-max-dtu, db-max-size, db-min-dtu, max-size
--vcores

Número de vcores para pesquisar. Se não especificado, todos os tamanhos vcore são mostrados.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql elastic-pool show

Editar

Obtém um pool elástico.

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do pool elástico.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>o .

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql elastic-pool update

Editar

Atualize um pool elástico.

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

Exemplos

Atualizar pool elástico com redundância de zona habilitada

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

Atualizar pool elástico com redundância de zona explicitamente desabilitada

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

Atualizar pool elástico com 2 réplicas de alta disponibilidade

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

Atualizar pool elástico com o enclave VBS

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []
--capacity --dtu -c

O componente de capacidade do sku em número inteiro de DTUs ou vcores.

--db-dtu-max --db-max-capacity --db-max-dtu

A capacidade máxima (em DTUs ou vcores) que qualquer banco de dados pode consumir.

--db-dtu-min --db-min-capacity --db-min-dtu

A capacidade mínima (em DTUs ou vcores) de cada banco de dados é garantida.

--edition --tier -e

O componente de edição do sku. Os valores permitidos incluem: Basic, Standard, Premium, GeneralPurpose, BusinessCritical.

--family -f

O componente de geração de computação do sku (somente para skus vcore). Os valores permitidos incluem: Gen4, Gen5.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.

Valor padrão: False
--ha-replicas --read-replicas

O número de réplicas de alta disponibilidade a serem provisionadas para o banco de dados. Apenas configurável para a edição Hyperscale.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--maint-config-id -m

ID ou nome de configuração de manutenção especificado para este recurso.

--max-size --storage

O tamanho máximo de armazenamento. Se nenhuma unidade for especificada, o padrão será bytes (B).

--name -n

O nome do pool elástico.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--preferred-enclave-type

Tipo de enclave a ser configurado para o pool elástico.

Valores aceitos: Default, VBS
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Valor padrão: []
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>o .

--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>.

Valor padrão: []
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--zone-redundant -z

Especifica se a redundância de zona deve ser habilitada. O padrão será true se nenhum valor for especificado.

Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.