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

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.

Observação

Os pools elásticos de Hiperescala estão atualmente em versão prévia.

Pré-requisitos

Para trabalhar com o pool elástico de Hiperescala, você deve ter:

• Uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita.
• Um servidor lógico no Azure implantado em um grupo de recursos. Os exemplos neste artigo usam o nome my-example-rg do grupo de recursos e my-example-sql-svr para o servidor lógico.
• A versão mais recente do Azure PowerShell Az.Sql.3.11.0 ou superior ou da CLI do Azure AZ versão 2.40.0 ou superior

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.

CLI do Azure

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

PowerShell

Use o cmdlet New-AzSqlElasticPool para criar um pool elástico de Hiperescala.

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

New-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -Edition "Hyperscale" -VCore 4 -ComputeGeneration Gen5 -HighAvailabilityReplicaCount 2

O exemplo a seguir cria um pool elástico de Hiperescala com redundância de zona configurado com quatro vCores e uma réplica de pool secundário:

New-AzSqlElasticPool -ResourceGroupName "myresourcegroup" -ServerName "mylogicalserver" -ElasticPoolName "zr-hs-ep" -Edition Hyperscale -ComputeGeneration Gen5 -VCore 4 -HighAvailabilityReplicaCount 1 -ZoneRedundant

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.

CLI do Azure

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

PowerShell

Use o cmdlet Set-AzSqlElasticPool 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:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -VCore 8 -DatabaseVCoreMin 0 -DatabaseVCoreMax 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.

CLI do Azure

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

PowerShell

Use o comando Set-AzSqlElasticPool 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:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 4

O exemplo a seguir reduz horizontalmente um pool elástico de Hiperescala existente para usar uma réplica de pool secundário:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 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.

CLI do Azure

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"

PowerShell

Use o cmdlet Set-AzSqlDatabase 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:

Set-AzSqlDatabase -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -DatabaseName "my_existing_db" -ElasticPoolName "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.

CLI do Azure

Atualmente indisponível por meio da CLI do Azure. Use o Azure PowerShell ou o portal do Azure.

PowerShell

Use o cmdlet Set-AzSqlElasticPool para escalar verticalmente um pool elástico de Hiperescala existente.

O exemplo a seguir atualiza um pool elástico de Hiperescala my_hs_pool existente para hardware da série premium:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -ComputeGeneration "PRMS"

Migrar 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 migrar um banco de dados de uso geral existente para um pool elástico de Hiperescala com redundância de zona.

CLI do Azure

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

PowerShell

Set-AzSqlDatabase -ResourceGroupName "myResourceGroup" -ServerName "mylogicalserver" -DatabaseName gp1 -ElasticPoolName "my-ZR-Hyperscale-EP" -BackupStorageRedundancy 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

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