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
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>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.
O componente de capacidade do sku no 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 de minumum (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 (somente 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. Somente configurável para a edição Hyperscale.
O tipo de licença a ser aplicado a esse pool elástico.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | BasePrice, LicenseIncluded |
ID ou nome de configuração de manutenção especificado para este recurso.
O tamanho máximo do armazenamento. Se nenhuma unidade for especificada, o padrão será bytes (B).
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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 |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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.
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 |
O nome do pool elástico.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 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>o .
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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.
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 |
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>o .
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
O número de elementos na coleção a ser ignorada. O valor padrão é None.
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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.
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 |
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>o .
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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. 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.
Se especificado, mostre apenas os resultados disponíveis na região especificada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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 |
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 |
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 |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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.
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 |
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>o .
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
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.
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: | [] |
O componente de capacidade do sku no 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 de minumum (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 (somente 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 cadeia de caracteres em vez de tentar converter em JSON.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | False |
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.
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 |
ID ou nome de configuração de manutenção especificado para este recurso.
O tamanho máximo do 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 aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Tipo de enclave a ser configurado para o pool elástico.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Default, VBS |
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: | [] |
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>o .
| 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 |
| Valor padrão: | [] |
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 |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |