Uso dei pool elastici Hyperscale con utilità 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 due repliche secondarie 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 aumentare le istanze di un pool elastico Hyperscale esistente, è possibile usare l'interfaccia della riga di comando 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 aumenta le istanze di un pool elastico Hyperscale esistente a 8 vCore e imposta rispettivamente il valore minimo e massimo per ogni database 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

Ridurre o aumentare le istanze di un pool elastico Hyperscale

Usare l'interfaccia della riga di comando di Azure o Azure PowerShell per aggiungere o rimuovere repliche secondarie del pool per un pool elastico Hyperscale esistente, noto anche come scalabilità orizzontale o verticale.

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 riduce il numero di istanze di un pool elastico Hyperscale esistente per usare 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

L'esempio che segue aumenta il numero di istanze di un pool elastico Hyperscale esistente per usare 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 per utilizzo generico esistente a un pool elastico Hyperscale con ridondanza della zona

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

L'esempio che segue riduce il numero di istanze di un pool elastico Hyperscale esistente per usare 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