Delen via


Werken met Hyperscale-elastische pools met behulp van opdrachtregelhulpmiddelen

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 opdrachtregelprogramma's zoals de Azure CLI en PowerShell. Naast deze methoden kunt u azure Portal altijd gebruiken voor de meeste bewerkingen.

Voorwaarden

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

Een nieuwe elastische Hyperscale-pool maken

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

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

In het volgende voorbeeld wordt een zoneredundante elastische Hyperscale-pool gemaakt met vier vCores en één secundaire poolreplica:

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

Een elastische Hyperscale-pool omhoog schalen

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

Gebruik de az sql elastic-pool update opdracht 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

Een elastische Hyperscale-pool uitschalen of inschalen

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 op- en afschalen.

Gebruik de az sql elastic-pool update opdracht 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

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.

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

In het volgende voorbeeld wordt 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"

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.

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

Een bestaande database voor algemeen gebruik converteren naar een zoneredundante elastische Hyperscale-pool

U kunt de Azure CLI of Azure PowerShell gebruiken om een bestaande database voor algemeen gebruik te converteren naar een zoneredundante elastische Hyperscale-pool.

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

Gebruik de 2021-11-01 REST API (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
  }
}