Partilhar via

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

Nota

Os pools elásticos para Hyperscale estão atualmente em visualização.

Pré-requisitos

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

Criar um novo pool elástico Hyperscale

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

Use o comando az sql elastic-pool create para criar um pool elástico Hyperscale.

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

Aumentar a escala de 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

Dimensionar (ou em) um pool elástico de hiperescala

Use a CLI do Azure ou o Azure PowerShell para adicionar ou remover réplicas de pool secundário para um pool elástico de hiperescala existente - também conhecido como dimensionamento ou dimensionamento.

Use o comando az sql elastic-pool update para expandir um pool elástico Hyperscale existente adicionando uma réplica de pool secundário ou dimensionando em um pool elástico removendo réplicas de pool secundário.

O exemplo a seguir dimensiona 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 é dimensionado em 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 Hyperscale existente.

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

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.

API REST

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

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údos relacionados

  • Comandos da CLI do Banco de Dados SQL do Azure.
  • Cmdlets do PowerShell do Banco de Dados SQL do Azure.
  • API REST dos pools elásticos do Banco de Dados SQL do Azure.
  • Visão geral de pools elásticos de hiperescala.