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

  • Artigo

Aplica-se a: Banco de Dados SQL do Azure

Neste artigo, aprenda a criar, dimensionar e mover bancos de dados para um pool elástico de Hiperescala 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 o pool elástico de Hiperescala, você deve ter:

Criar um pool elástico de Hiperescala

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

Use 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 com redundância 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

Escalar verticalmente um pool elástico de Hiperescala

Você pode usar a CLI do Azure ou Azure PowerShell para escalar verticalmente um pool elástico de Hiperescala existente.

Use o comando az sql elastic-pool update para escalar verticalmente um pool elástico de Hiperescala existente.

O exemplo a seguir escala verticalmente um pool elástico de Hiperescala existente para 8 vCores e define o mínimo por banco de dados e o máximo 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 (ou reduzir) um pool elástico de Hiperescala

Use a CLI do Azure ou Azure PowerShell para adicionar ou remover réplicas de pool secundário para um pool elástico de Hiperescala existente, também conhecido como escalar ou reduzir horizontalmente.

Use o comando az sql elastic-pool update para escalar horizontalmente um pool elástico de Hiperescala existente adicionando uma réplica de pool secundário ou reduzir horizontalmente em um pool elástico removendo réplicas de pool secundárias.

O exemplo a seguir escala horizontalmente um pool elástico de Hiperescala existente para usar quatro réplicas de pool secundário:

# 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 a seguir reduz horizontalmente um pool elástico de Hiperescala existente para usar uma réplica de pool secundário:

# 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 de Hiperescala

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 de Hiperescala existente.

O exemplo a seguir move o banco de dados my_existing_db para o pool elástico de Hiperescala 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"

Atualizar 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 por meio da CLI do Azure. Use o Azure PowerShell ou o portal do Azure.

Converter um banco de dados de uso geral existente para um pool elástico de Hiperescala com redundância de zona

Você pode usar a CLI do Azure ou o Azure PowerShell para converter um banco de dados de uso geral existente para um pool elástico de Hiperescala 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

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

O exemplo a seguir escala horizontalmente 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