Partilhar via

Trabalhar com pools elásticos de hiperescala usando ferramentas de linha de comando

Aplica-se a: do Banco de Dados SQL do Azure

Neste artigo, aprenda a criar, dimensionar e mover bancos de dados para um pool elástico Hyperscale usando ferramentas de linha de comando, como a CLI do Azure e o PowerShell. Além desses métodos, você sempre pode usar o portal do Azure para a maioria das operações.

Pré-requisitos

Para trabalhar com seu pool elástico Hyperscale, você deve ter:

** Criar um novo pool elástico de hiperescala

Você pode usar a CLI do Azure ou o Azure PowerShell para criar um pool elástico de hiperescala.

Utilize o comando az sql elastic-pool create para criar um pool elástico de hiperescala.

O exemplo a seguir cria um pool elástico de hiperescala com quatro vCores e duas réplicas de pool secundário:

az sql elastic-pool create --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --edition "Hyperscale" --capacity 4 --family Gen5 --ha-replicas 2

O exemplo a seguir cria um pool elástico de hiperescala redundante de zona com quatro vCores e uma réplica de pool secundário:

az sql elastic-pool create --resource-group "myresourcegroup" --server "mylogicalserver" --name "zr-hs-ep" --family Gen5 --edition Hyperscale --capacity 4 --ha-replicas 1 --zone-redundant

Expandir um pool elástico de hiperescala

Você pode usar a CLI do Azure ou o Azure PowerShell para dimensionar um pool elástico de hiperescala existente.

Use o comando az sql elastic-pool update para aumentar a escala de um pool elástico Hyperscale existente.

O exemplo a seguir dimensiona um pool elástico Hyperscale existente para 8 vCores e define o min e max por DB como 0 e 2, respectivamente:

az sql elastic-pool update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --capacity 8 --db-min-capacity 0 --db-max-capacity 2

Escalar horizontalmente (para fora ou para dentro) uma plataforma elástica de hiperescala

Utilize o Azure CLI ou o Azure PowerShell para adicionar ou remover réplicas de pool secundárias para um pool elástico de hiperescala já existente - também conhecido como dimensionar para fora ou dimensionar para dentro.

Use o comando az sql elastic-pool update para expandir um pool elástico Hyperscale existente ao adicionar uma réplica secundária de pool ou para reduzir um pool elástico ao remover réplicas secundárias de pool.

O exemplo seguinte expande um pool elástico de hiperescala existente para usar quatro réplicas secundárias do pool.

# use the --ha-replicas (--read-replicas can also be used) parameter to specify the new number of high-availability replicas:
az sql elastic-pool update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --ha-replicas 4

O exemplo seguinte escala num pool elástico de hiperescala existente para utilizar uma réplica secundária do pool:

# use the --ha-replicas (--read-replicas can also be used) parameter to specify the new number of high-availability replicas:
az sql elastic-pool update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --ha-replicas 1

Mover um banco de dados existente para um pool elástico Hyperscale

Você pode usar a CLI do Azure ou o Azure PowerShell para mover um banco de dados existente no Banco de Dados SQL do Azure para um pool elástico de hiperescala existente.

Use o comando az sql db update para mover um banco de dados existente para um pool elástico Hyperscale existente.

O exemplo a seguir move o banco de dados my_existing_db para o pool elástico Hyperscale existente my_hs_pool:

az sql db update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_existing_db" --elastic-pool "my_hs_pool"

Atualize um pool elástico existente do Gen5 para o hardware da série premium

Você pode usar a CLI do Azure ou o Azure PowerShell para atualizar um pool elástico existente do Gen5 para o hardware da série premium.

Atualmente indisponível através da CLI do Azure. Em vez disso, use o Azure PowerShell ou o portal do Azure.

Converter um banco de dados de uso geral existente em um pool elástico de hiperescala redundante de zona

Você pode usar a CLI do Azure ou o Azure PowerShell para converter uma base de dados de Uso Geral existente num elastic pool Hyperscale com redundância de zona.

az sql db update --resource-group "myresourcegroup" --server "mylogicalserver" --name "gp_zrs_standalone_db" --elastic-pool "zr-hs-ep" --backup-storage-redundancy Zone

REST API

Utilize a API REST 2021-11-01 (ou posterior) para trabalhar com réplicas secundárias para pools elásticos de hiperescala.

O exemplo a seguir dimensiona um pool elástico de hiperescala existente para usar quatro réplicas secundárias:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01-preview

{
  "properties": {
    "highAvailabilityReplicaCount": 4
  }
}

Conteúdo relacionado

  • Last updated on