Uso dei pool elastici Hyperscale con utilità da riga di comando

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.

Nota

I pool elastici per Hyperscale sono attualmente disponibili in anteprima.

Prerequisiti

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

• Una sottoscrizione di Azure. Se non hai una sottoscrizione di Azure, crea un account gratuito.
• Un server logico in Azure distribuito in un gruppo di risorse. Gli esempi mostrati in questo articolo usano il nome my-example-rg per il gruppo di risorse e my-example-sql-svr per il server logico.
• L'ultima versione di Azure PowerShell Az.Sql.3.11.0 o versione successiva o l'interfaccia della riga di comando di Azure Az versione 2.40.0 o successiva

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.

Interfaccia della riga di comando di Azure

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

PowerShell

Usare il cmdlet New-AzSqlElasticPool per creare un pool elastico Hyperscale.

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

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

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

New-AzSqlElasticPool -ResourceGroupName "myresourcegroup" -ServerName "mylogicalserver" -ElasticPoolName "zr-hs-ep" -Edition Hyperscale -ComputeGeneration Gen5 -VCore 4 -HighAvailabilityReplicaCount 1 -ZoneRedundant

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.

Interfaccia della riga di comando di Azure

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

PowerShell

Usare il cmdlet Set-AzSqlElasticPool 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:

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

Interfaccia della riga di comando di Azure

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

PowerShell

Usare il comando Set-AzSqlElasticPool 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:

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

L'esempio che segue aumenta il numero di istanze di un pool elastico Hyperscale esistente per usare una replica secondaria del pool:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 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.

Interfaccia della riga di comando di Azure

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"

PowerShell

Usare il cmdlet Set-AzSqlDatabase 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:

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

Interfaccia della riga di comando di Azure

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

PowerShell

Usare il cmdlet Set-AzSqlElasticPool per aumentare le istanze di un pool elastico Hyperscale esistente.

L'esempio seguente aggiorna un pool elastico Hyperscale esistente my_hs_pool all'hardware di serie premium:

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

Eseguire la migrazione di 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 eseguire la migrazione di un database per utilizzo generico esistente a un pool elastico Hyperscale con ridondanza della zona.

Interfaccia della riga di comando di Azure

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

PowerShell

Set-AzSqlDatabase -ResourceGroupName "myResourceGroup" -ServerName "mylogicalserver" -DatabaseName gp1 -ElasticPoolName "my-ZR-Hyperscale-EP" -BackupStorageRedundancy 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

• Comandi dell'interfaccia della riga di comando del database SQL di Azure.
• Cmdlet PowerShell del database SQL di Azure.
• API REST dei pool elastici del database SQL di Azure.
• Informazioni generali sui pool elastici Hyperscale.