Partilhar via


az sql elastic-pool

Gerencie pools elásticos.

Comandos

Name Description Tipo Status
az sql elastic-pool create

Crie um pool elástico.

Principal GA
az sql elastic-pool delete

Exclui um pool elástico.

Principal GA
az sql elastic-pool list

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

Principal GA
az sql elastic-pool list-dbs

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

Principal GA
az sql elastic-pool list-editions

Liste as edições do pool elástico disponíveis para a assinatura ativa.

Principal GA
az sql elastic-pool op

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

Principal GA
az sql elastic-pool op cancel

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

Principal GA
az sql elastic-pool op list

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

Principal GA
az sql elastic-pool show

Obtém uma piscina elástica.

Principal GA
az sql elastic-pool update

Atualize um pool elástico.

Principal GA

az sql elastic-pool create

Crie 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 Standard 100 DTU.

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

Crie um pool elástico com a 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 edição Hyperscale, 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 Obrigatórios

--name -n

O nome do pool elástico.

--resource-group -g

o 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>.

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 (apenas para vcore skus). 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 para esse pool elástico.

Valores aceites: 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 espere que a operação de longa duração termine.

Default value: False
--preferred-enclave-type

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

Valores aceites: Default, VBS
--tags

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

--zone-redundant -z

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

Valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql elastic-pool delete

Exclui um pool elástico.

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

Parâmetros Opcionais

--ids

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

--name -n

O nome do pool elástico.

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--resource-group -g

o 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>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql elastic-pool list

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

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

--resource-group -g

o 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>.

--skip

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql elastic-pool list-dbs

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

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

--name -n

O nome do pool elástico.

--resource-group -g

o 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>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql elastic-pool list-editions

Liste as edições do pool elástico disponíveis para a assinatura ativa.

Também inclui configurações de DTU de pool disponíveis, limites de armazenamento e configurações por banco de dados. Para reduzir a verbosidade, limites de armazenamento adicionais e configurações por banco de dados são 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 do 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 piscinas elásticas 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 Standard 100 DTU 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 Obrigatórios

--location -l

Localização. 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.

Default value: False
--dtu

Número de DTUs a pesquisar. Se não for especificado, todos os tamanhos de DTU serã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 incluir na saída.

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

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql elastic-pool show

Obtém uma piscina elástica.

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

Parâmetros Opcionais

--ids

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

--name -n

O nome do pool elástico.

--resource-group -g

o 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>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql elastic-pool update

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 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 valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--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 (apenas para vcore skus). Os valores permitidos incluem: Gen4, Gen5.

--force-string

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

Default value: 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. 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 espere que a operação de longa duração termine.

Default value: False
--preferred-enclave-type

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

Valores aceites: Default, VBS
--remove

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

Default value: []
--resource-group -g

o 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>.

--set

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

Default value: []
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--zone-redundant -z

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

Valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.