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
O nome do pool elástico.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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.
O componente de capacidade do sku em número inteiro de DTUs ou vcores.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
A capacidade máxima (em DTUs ou vcores) que qualquer banco de dados pode consumir.
A capacidade mínima (em DTUs ou vcores) de cada banco de dados é garantida.
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 |
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 |
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.
O tipo de licença a ser aplicado para esse pool elástico.
| Propriedade | Valor |
|---|---|
| Valores aceites: | BasePrice, LicenseIncluded |
ID ou nome de configuração de manutenção especificado para este recurso.
O tamanho máximo de armazenamento. Se nenhuma unidade for especificada, o padrão será bytes (B).
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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 separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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.
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 |
O nome do pool elástico.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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 |
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 |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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.
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 |
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 |
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 |
O número de elementos na coleção a serem ignorados. O valor padrão é Nenhum.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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.
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 |
O nome do pool elástico.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
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 |
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 |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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. 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.
Se especificado, mostre apenas os resultados disponíveis na região especificada.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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 |
Edição para pesquisar. Se não for especificado, todas as edições serão mostradas.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Search Arguments |
Lista de detalhes adicionais a incluir na saída.
| Propriedade | Valor |
|---|---|
| Valores aceites: | db-max-dtu, db-max-size, db-min-dtu, max-size |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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.
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 |
O nome do pool elástico.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
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 |
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 |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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.
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: | [] |
O componente de capacidade do sku em número inteiro de DTUs ou vcores.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
A capacidade máxima (em DTUs ou vcores) que qualquer banco de dados pode consumir.
A capacidade mínima (em DTUs ou vcores) de cada banco de dados é garantida.
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 |
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 |
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 |
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.
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 |
ID ou nome de configuração de manutenção especificado para este recurso.
O tamanho máximo de armazenamento. Se nenhuma unidade for especificada, o padrão será bytes (B).
O nome do pool elástico.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Tipo de enclave a ser configurado para o pool elástico.
| Propriedade | Valor |
|---|---|
| Valores aceites: | Default, VBS |
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: | [] |
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 |
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 |
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: | [] |
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 |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |