Partager via


Utiliser des pools élastiques Hyperscale à l’aide d’outils en ligne de commande

S’applique à : Azure SQL Database

Dans cet article, découvrez comment créer, mettre à l’échelle et déplacer des bases de données dans un pool élastique Hyperscale à l’aide d’outils en ligne de commande comme Azure CLI et PowerShell. En plus de ces méthodes, vous pouvez toujours utiliser le Portail Azure pour la plupart des opérations.

Prérequis

Pour utiliser votre pool élastique Hyperscale, vous devez disposer des éléments suivants :

Créer un pool élastique Hyperscale

Vous pouvez utiliser Azure CLI ou Azure PowerShell pour créer un pool élastique Hyperscale.

Utilisez la commande az sql elastic-pool create pour créer un pool élastique Hyperscale.

L’exemple suivant crée un pool élastique Hyperscale avec quatre vCores et deux réplicas de pool secondaires :

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'exemple suivant crée un pool élastique Hyperscale redondant de zone avec quatre vCores et une réplica de pool secondaire :

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

Effectuer un scale-up d’un pool élastique Hyperscale

Vous pouvez utiliser Azure CLI ou Azure PowerShell pour effectuer un scale-up d’un pool élastique Hyperscale existant.

Utilisez la commande az sql elastic-pool update pour effectuer un scale-up d’un pool élastique Hyperscale existant.

L’exemple suivant met à l’échelle un pool élastique Hyperscale existant à 8 vCores et définit le min et le max par base de données sur 0 et 2, respectivement :

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

Effectuer un scale-out (ou in) d’un pool élastique Hyperscale

Utilisez Azure CLI ou Azure PowerShell pour ajouter ou supprimer des réplicas de pool secondaires pour un pool élastique Hyperscale existant, processus également appelé scale-out ou scale-in.

Utilisez la commande az sql elastic-pool update pour effectuer un scale-out d’un pool élastique Hyperscale existant en ajoutant un réplica de pool secondaire ou un scale-in d’un pool élastique en supprimant les réplicas de pool secondaires.

L’exemple suivant met à l’échelle un pool élastique Hyperscale existant pour utiliser quatre réplicas de pool secondaires :

# 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’exemple suivant met à l’échelle un pool élastique Hyperscale existant pour utiliser un réplica de pool secondaire :

# 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

Déplacer une base de données existante vers un pool élastique Hyperscale

Vous pouvez utiliser Azure CLI ou Azure PowerShell pour déplacer une base de données existante dans Azure SQL Database dans un pool élastique Hyperscale existant.

Utilisez la commande az sql db update pour déplacer une base de données existante dans un pool élastique Hyperscale existant.

L’exemple suivant déplace la base de données my_existing_db dans un pool élastique Hyperscale my_hs_pool existant :

az sql db update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_existing_db" --elastic-pool "my_hs_pool"

Changer de niveau d'un pool élastique existant de Gen5 vers un matériel de série Premium

Vous pouvez utiliser Azure CLI ou Azure PowerShell pour changer de niveau d'un pool élastique existant de Gen5 vers le matériel de série Premium.

Actuellement indisponible via Azure CLI. Utilisez Azure PowerShell ou le portail Azure.

Convertisseur d'une base de données à usage général existante en un pool élastique Hyperscale redondant par zone

Vous pouvez utiliser Azure CLI ou Azure PowerShell pour convertir une base de données à usage général existante vers un pool élastique Hyperscale redondant.

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

Utilisez l’API REST 2021-11-01 (ou version ultérieure) pour utiliser des réplicas secondaires pour les pools élastiques Hyperscale.

L’exemple suivant met à l’échelle un pool élastique Hyperscale existant pour utiliser quatre réplicas secondaires :

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