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

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:

• Uma subscrição do Azure. Se não tiver uma subscrição 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 para o 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 a CLI do Azure Az versão 2.40.0 ou superior

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.

CLI do Azure

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

PowerShell

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

O exemplo a seguir cria um pool elástico Hyperscale 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

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.

CLI do Azure

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

PowerShell

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

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

CLI do Azure

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

PowerShell

Use o comando Set-AzSqlElasticPool para expandir um pool elástico de hiperescala 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:

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

O exemplo a seguir é dimensionado em 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 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"

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 my_hs_poolelástico Hyperscale existente:

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

CLI do Azure

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

PowerShell

Use o cmdlet Set-AzSqlElasticPool para dimensionar um pool elástico Hyperscale existente.

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

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

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.