Uso de grupo de bases de datos elásticas de Hiperescala mediante herramientas de línea de comandos
Se aplica a: 
Azure SQL Database
En este artículo, aprenderá a crear, escalar y mover bases de datos a un grupo elástico de Hiperescala mediante herramientas de línea de comandos como la CLI de Azure y PowerShell. Además de estos métodos, siempre puede usar Azure Portal para la mayoría de las operaciones.
Requisitos previos
Para trabajar con un grupo de bases de datos elásticas de Hiperescala, debe tener:
- Suscripción a Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita.
- Un servidor lógico en Azure implementado en un grupo de recursos. En los ejemplos de este artículo se usa el nombre
my-example-rgdel grupo de recursos ymy-example-sql-svrdel servidor lógico. - La versión más reciente de Azure PowerShell, Az.Sql.3.11.0 o posterior, o de la CLI de Azure, la versión 2.40.0 o posterior
Creación de un grupo de bases de datos elásticas de Hiperescala
Puede usar la CLI de Azure o Azure PowerShell para crear un grupo de bases de datos elásticas de Hiperescala.
Use el comando az sql elastic-pool create para crear un grupo de bases de datos elásticas de Hiperescala.
En el ejemplo siguiente se crea un grupo elástico de Hiperescala con cuatro núcleos virtuales y dos réplicas de grupo secundarias:
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
En el ejemplo siguiente se crea un grupo elástico de Hiperescala con redundancia de zona con cuatro núcleos virtuales y una réplica de grupo secundaria:
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
Escalado vertical de un grupo de bases de datos elásticas de Hiperescala
Tanto la CLI de Azure como Azure PowerShell se pueden usar para crear un grupo de bases de datos elásticas de Hiperescala existente.
Use el comando az sql elastic-pool update para escalar verticalmente un grupo de bases de datos elásticas de Hiperescala existente.
En el ejemplo siguiente se escala verticalmente un grupo de bases de datos elásticas de Hiperescala existente a ocho núcleos virtuales y se establece el mínimo y el máximo por base de datos en 0 y 2, respectivamente:
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
Escalado horizontal (o reducción horizontal) de un grupo elástico de Hiperescala
Use la CLI de Azure o Azure PowerShell para agregar o quitar réplicas de grupos secundarias para un grupo de bases de datos elásticas de Hiperescala existente (también conocido como escalado horizontal o reducción horizontal).
Use el comando az sql elastic-pool update para escalar horizontalmente un grupo elástico de Hiperescala existente mediante la incorporación de una réplica de grupo secundaria o la reducción horizontal de un grupo de bases de datos elásticas mediante la eliminación de réplicas de grupo secundarias.
En el ejemplo siguiente se escala horizontalmente un grupo de bases de datos elásticas de Hiperescala existente para usar cuatro réplicas de grupo secundarias:
# 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
En el ejemplo siguiente se reduce horizontalmente un grupo de bases de datos elásticas de Hiperescala existente para usar una réplica de grupo secundaria:
# 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
Traslado de una base de datos existente a un grupo de bases de datos elásticas de Hiperescala
Puede usar la CLI de Azure o Azure PowerShell para mover una base de datos existente en Azure SQL Database a un grupo elástico de Hiperescala existente.
Use el comando az sql db update para mover una base de datos existente a un grupo elástico de Hiperescala existente.
En el ejemplo siguiente se mueve la base de datos my_existing_db al grupo elástico de Hiperescala existentemy_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"
Actualización de un grupo elástico existente de Gen5 a hardware de la serie Premium
Puede usar la CLI de Azure o Azure PowerShell para actualizar un grupo elástico existente de Gen5 a hardware de la serie Premium.
Actualmente no está disponible a través de la CLI de Azure. Use Azure PowerShell o Azure Portal en su lugar.
Conversión de una base de datos de uso general existente a un grupo elástico de Hiperescala con redundancia de zona
Puede utilizar la CLI de Azure o Azure PowerShell para convertir una base de datos de uso general existente a un grupo elástico de Hiperescala con redundancia de zona.
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
Debe usarse la API de REST 2021-11-01 (o posterior) para trabajar con réplicas secundarias en grupo de bases de datos elásticas de Hiperescala.
En el ejemplo siguiente se escala horizontalmente un grupo de bases de datos elásticas de Hiperescala existente para usar cuatro réplicas de grupo secundarias:
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
}
}