Compartilhar via


az sql elastic-pool

Gerenciar pools elásticos.

Comandos

Nome Description Tipo Status
az sql elastic-pool create

Crie um pool elástico.

Core GA
az sql elastic-pool delete

Exclui um pool elástico.

Core GA
az sql elastic-pool list

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

Core GA
az sql elastic-pool list-dbs

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

Core GA
az sql elastic-pool list-editions

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

Core GA
az sql elastic-pool op

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

Core GA
az sql elastic-pool op cancel

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

Core GA
az sql elastic-pool op list

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

Core GA
az sql elastic-pool show

Obtém um pool elástico.

Core GA
az sql elastic-pool update

Atualize um pool elástico.

Core GA

az sql elastic-pool create

Crie um pool elástico.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--ha-replicas --read-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--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 desabilitada explicitamente

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

Crie um pool elástico DTU Standard 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 edição de Hiperescala, 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 enclave de 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--capacity --dtu -c

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

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--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 de minumum (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.

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--family -f

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

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--ha-replicas --read-replicas

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

--license-type

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

Propriedade Valor
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 do 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 prolongada.

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

O tipo de enclave preferencial para o Pool Elástico do SQL do Azure. Os valores permitidos incluem: Padrão, VBS.

Propriedade Valor
Valores aceitos: Default, VBS
--tags

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

--zone-redundant -z

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

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do pool elástico.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--server -s

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--server -s

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--skip

O número de elementos na coleção a ser ignorada. O valor padrão é None.

--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do pool elástico.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--server -s

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

az sql elastic-pool list-editions

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

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

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition --tier]
                                  [--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 do 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 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 as configurações disponíveis por banco de dados para pools elásticos de DTU Standard 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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--available -a

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

Propriedade Valor
Valor padrão: False
--dtu

Número de DTUs a serem pesquisada. Se não for especificado, todos os tamanhos de DTU serão mostrados.

Propriedade Valor
Grupo de parâmetros: Search Arguments
--edition --tier -e

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

Propriedade Valor
Grupo de parâmetros: Search Arguments
--show-details -d

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

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

Número de vcores a serem pesquisados. Se não for especificado, todos os tamanhos vcores serão mostrados.

Propriedade Valor
Grupo de parâmetros: Search Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql elastic-pool show

Obtém um pool elástico.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do pool elástico.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--server -s

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

az sql elastic-pool update

Atualize um pool elástico.

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

Exemplos

Atualizar o 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 desabilitada explicitamente

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

Atualizar o 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 o pool elástico com enclave de VBS

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--capacity --dtu -c

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

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--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 de minumum (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.

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--family -f

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

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--force-string

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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. Somente configurável para a edição Hyperscale.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--maint-config-id -m

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

--max-size --storage

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

--name -n

O nome do pool elástico.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

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

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

Propriedade Valor
Valores aceitos: Default, VBS
--remove

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--server -s

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--set

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--zone-redundant -z

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

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False