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.

Core disponibilidade geral
az sql elastic-pool delete

Exclui um pool elástico.

Core disponibilidade geral
az sql elastic-pool list

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

Core disponibilidade geral
az sql elastic-pool list-dbs

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

Core disponibilidade geral
az sql elastic-pool list-editions

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

Core disponibilidade geral
az sql elastic-pool op

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

Core disponibilidade geral
az sql elastic-pool op cancel

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

Core disponibilidade geral
az sql elastic-pool op list

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

Core disponibilidade geral
az sql elastic-pool show

Obtém uma piscina elástica.

Core disponibilidade geral
az sql elastic-pool update

Atualize um pool elástico.

Core disponibilidade geral

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--capacity --dtu -c

O componente de capacidade do sku em 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 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.

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

O componente de geração de computação do sku (apenas 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. Apenas configurável para a edição Hyperscale.

--license-type

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

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

Propriedade Valor
Default value: False
--preferred-enclave-type

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

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

Propriedade Valor
Default value: 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>.

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

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

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

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

--subscription

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

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

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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

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 tornar-se necessários para que o comando seja executado com êxito.

--available -a

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

Propriedade Valor
Default value: False
--dtu

Número de DTUs a pesquisar. 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 para pesquisar. 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 incluir na saída.

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

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

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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
Default value: []
--capacity --dtu -c

O componente de capacidade do sku em 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 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.

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

O componente de geração de computação do sku (apenas 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 string em vez de tentar converter para JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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 que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Propriedade Valor
Default value: False
--preferred-enclave-type

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

Propriedade Valor
Valores aceites: Default, VBS
--remove

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: []
--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>.

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
Default value: []
--subscription

Nome ou ID da subscrição. 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 é true se nenhum valor for especificado.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False