Condividi tramite

Lavorare con i pool elastici Hyperscale usando strumenti da riga di comando

  • Articolo

Si applica a:Database SQL di Azure

Questo articolo illustra come creare, dimensionare e spostare i database in un pool elastico Hyperscale con utilità da riga di comando come l'interfaccia della riga di comando di Azure e PowerShell. Oltre a questi metodi, è sempre possibile usare il portale di Azure per la maggior parte delle operazioni.

Prerequisiti

Per lavorare con il pool elastico Hyperscale, è necessario disporre di:

Creare un nuovo pool elastico Hyperscale

Per creare un pool elastico Hyperscale, è possibile usare l'interfaccia della riga di comando di Azure o Azure PowerShell.

Usare il comando az sql elastic-pool create per creare un pool elastico Hyperscale.

L'esempio seguente crea un pool elastico Hyperscale con quattro vCore e due repliche secondarie del pool:

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

L'esempio seguente crea un pool elastico Hyperscale con ridondanza della zona con quattro vCore e una replica secondaria del pool.

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

Aumentare le istanze di un pool elastico Hyperscale

Per ridimensionare verso l'alto un pool elastico Hyperscale esistente, è possibile usare la CLI di Azure o Azure PowerShell.

Usare il comando az sql elastic-pool update per aumentare le istanze di un pool elastico Hyperscale esistente.

L'esempio seguente scala un pool elastico Hyperscale esistente a 8 vCore e imposta i valori minimo e massimo per ogni database rispettivamente su 0 e 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

Espandere o ridurre un pool elastico Hyperscale

Usare Azure CLI o Azure PowerShell per aggiungere o rimuovere repliche secondarie per un pool elastico Hyperscale esistente. Questo processo è noto anche come scalare orizzontalmente o verticalmente.

Usare il comando az sql elastic-pool update per ridurre il numero di istanze di un pool elastico Hyperscale esistente aggiungendo una replica secondaria del pool o per aumentare il numero di istanze in un pool elastico rimuovendo le repliche secondarie del pool.

L'esempio che segue estende un pool elastico Hyperscale esistente per utilizzare quattro repliche secondarie del pool:

# 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

Il seguente esempio ridimensiona un pool elastico Hyperscale esistente per utilizzare una replica secondaria del pool:

# 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

Spostare un database esistente in un pool elastico Hyperscale

È possibile usare l'interfaccia della riga di comando di Azure o Azure PowerShell per spostare un database esistente in database SQL di Azure in un pool elastico Hyperscale esistente.

Usare il comando az sql db update per spostare un database esistente in un pool elastico Hyperscale esistente.

L'esempio seguente sposta il database my_existing_db nel pool elastico Hyperscale esistente 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"

Aggiornare un pool elastico esistente da Gen5 a hardware di serie premium

È possibile usare l'interfaccia della riga di comando di Azure o Azure PowerShell per aggiornare un pool elastico esistente da Gen5 a hardware di serie premium.

Opzione attualmente non disponibile tramite l'interfaccia della riga di comando di Azure. In alternativa, usare Azure PowerShell o il portale di Azure.

Convertire un database Esistente di Scopo Generale in un pool elastico di tipo Hyperscale con ridondanza zonale

È possibile usare l'interfaccia della riga di comando di Azure o Azure PowerShell per convertire un database per utilizzo generico esistente a un pool elastico Hyperscale con ridondanza della zona.

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

API REST

Usare l'API REST 2021-11-01 (o versione successiva) per lavorare con le repliche secondarie per i pool elastici Hyperscale.

Il seguente esempio espande un pool elastico Hyperscale esistente per utilizzare quattro repliche secondarie:

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

Contenuto correlato