Werken met elastische Hyperscale-pools met opdrachtregelprogramma's

Van toepassing op: Azure SQL Database

In dit artikel leert u hoe u databases kunt maken, schalen en verplaatsen naar een elastische Hyperscale-pool met behulp van opdrachtregelprogramma's zoals de Azure CLI en PowerShell. Naast deze methoden kunt u azure Portal altijd gebruiken voor de meeste bewerkingen.

Notitie

Elastische pools voor Hyperscale zijn momenteel beschikbaar als preview-versie.

Vereisten

Als u wilt werken met uw elastische Hyperscale-pool, hebt u het volgende nodig:

• Een Azure-abonnement. Als u nog geen Azure-abonnement hebt, maakt u een gratis account.
• Een logische server in Azure die is geïmplementeerd in een resourcegroep. In de voorbeelden in dit artikel wordt de naam my-example-rg voor de resourcegroep en my-example-sql-svr voor de logische server gebruikt.
• De nieuwste versie van Azure PowerShell Az.Sql.3.11.0 of hoger of de Azure CLI Az versie 2.40.0 of hoger

Een nieuwe elastische Hyperscale-pool maken

U kunt de Azure CLI of Azure PowerShell gebruiken om een elastische Hyperscale-pool te maken.

Azure-CLI

Gebruik de opdracht az sql elastic-pool create om een elastische Hyperscale-pool te maken.

In het volgende voorbeeld wordt een elastische Hyperscale-pool gemaakt met vier vCores en twee secundaire poolreplica's:

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

Gebruik de cmdlet New-AzSqlElasticPool om een elastische Hyperscale-pool te maken.

In het volgende voorbeeld wordt een elastische Hyperscale-pool gemaakt die is geconfigureerd met vier vCores en twee secundaire poolreplica's:

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

Een elastische Hyperscale-pool omhoog schalen

U kunt de Azure CLI of Azure PowerShell gebruiken om een bestaande elastische Hyperscale-pool omhoog te schalen.

Azure-CLI

Gebruik de opdracht az sql elastic-pool update om een bestaande elastische Hyperscale-pool omhoog te schalen.

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool opgeschaald naar 8 vCores en wordt het minimum en maximum per db ingesteld op respectievelijk 0 en 2:

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

Gebruik de cmdlet Set-AzSqlElasticPool om een bestaande elastische Hyperscale-pool omhoog te schalen.

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool opgeschaald naar 8 vCores en wordt het minimum en maximum per db ingesteld op respectievelijk 0 en 2:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -VCore 8 -DatabaseVCoreMin 0 -DatabaseVCoreMax 2

Een elastische Hyperscale-pool uitschalen (of in)

Gebruik de Azure CLI of Azure PowerShell om secundaire poolreplica's toe te voegen of te verwijderen voor een bestaande elastische Hyperscale-pool, ook wel bekend als uitschalen of inschalen.

Azure-CLI

Gebruik de opdracht az sql elastic-pool update om een bestaande elastische Hyperscale-pool uit te schalen door een secundaire poolreplica toe te voegen of in een elastische pool te schalen door secundaire poolreplica's te verwijderen.

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool uitgeschaald om vier secundaire poolreplica's te gebruiken:

# 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

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool geschaald om één secundaire poolreplica te gebruiken:

# 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

Gebruik de opdracht Set-AzSqlElasticPool om een bestaande elastische Hyperscale-pool uit te schalen door een secundaire poolreplica toe te voegen of in een elastische pool te schalen door secundaire poolreplica's te verwijderen.

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool uitgeschaald om vier secundaire poolreplica's te gebruiken:

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

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool geschaald om één secundaire poolreplica te gebruiken:

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

Een bestaande database verplaatsen naar een elastische Hyperscale-pool

U kunt de Azure CLI of Azure PowerShell gebruiken om een bestaande database in Azure SQL Database te verplaatsen naar een bestaande elastische Hyperscale-pool.

Azure-CLI

Gebruik de opdracht az sql db update om een bestaande database te verplaatsen naar een bestaande elastische Hyperscale-pool.

In het volgende voorbeeld wordt de database my_existing_db verplaatst naar een bestaande elastische Hyperscale-pool 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

Gebruik de cmdlet Set-AzSqlDatabase om een bestaande database te verplaatsen naar een bestaande elastische Hyperscale-pool.

In het volgende voorbeeld wordt de database my_existing_db verplaatst naar een bestaande elastische Hyperscale-pool my_hs_pool:

Set-AzSqlDatabase -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -DatabaseName "my_existing_db" -ElasticPoolName "my_hs_pool"

Een bestaande elastische pool upgraden van Gen5 naar hardware uit de premium-serie

U kunt de Azure CLI of Azure PowerShell gebruiken om een bestaande elastische pool van Gen5 te upgraden naar hardware uit de premium-serie.

Azure-CLI

Momenteel niet beschikbaar via Azure CLI. Gebruik in plaats daarvan Azure PowerShell of Azure Portal.

PowerShell

Gebruik de cmdlet Set-AzSqlElasticPool om een bestaande elastische Hyperscale-pool omhoog te schalen.

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool my_hs_pool bijgewerkt naar hardware uit de Premium-serie:

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

REST-API

Gebruik de REST API 2021-11-01 (of hoger) om te werken met secundaire replica's voor elastische Hyperscale-pools.

In het volgende voorbeeld wordt een bestaande elastische Hyperscale-pool uitgeschaald om vier secundaire replica's te gebruiken:

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
  }
}

Gerelateerde inhoud

• Azure SQL Database CLI-opdrachten.
• Azure SQL Database PowerShell-cmdlets.
• REST API voor elastische pools van Azure SQL Database.
• Overzicht van elastische Hyperscale-pools.