Работа с эластичными пулами с гипермасштабированием с помощью средств командной строки
Применимо к: База данных SQL Azure
В этой статье вы узнаете, как создавать, масштабировать и перемещать базы данных в эластичный пул гипермасштабирования с помощью таких средств командной строки, как Azure CLI и PowerShell. Помимо этих методов, всегда можно использовать портал Azure для большинства операций.
Предварительные условия
Чтобы работать с вашим эластичным пулом в Hyperscale, следует иметь:
- Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись.
- Логический сервер в Azure, развернутый в группе ресурсов. В примерах в этой статье используется имя
my-example-rg
группы ресурсов иmy-example-sql-svr
логического сервера. - Последняя версия Azure PowerShell Az.Sql.3.11.0 или более поздней версии или Azure CLI Az версии 2.40.0 или выше
Создание нового эластичного пула гипермасштабирования
Для создания эластичного пула гипермасштабирования можно использовать Azure CLI или Azure PowerShell.
Используйте команду az sql elastic-pool create для создания эластичного пула Гипермасштабирования.
В следующем примере создается эластичный пул Hyperscale с четырьмя виртуальными ядрами и двумя вторичными репликами пула.
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
В следующем примере создается межзонально избыточный Hyperscale эластичный пул с четырьмя виртуальными ядрами и одной репликой вторичного пула.
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
Масштабирование пула Hyperscale Elastic Pool
Вы можете использовать Azure CLI или Azure PowerShell для масштабирования существующего гипермасштабируемого эластичного пула.
Используйте команду az sql elastic-pool update для масштабирования существующего эластичного пула гипермасштабирования.
В следующем примере выполняется масштабирование существующего эластичного пула Hyperscale до 8 vCores и устанавливаются минимальные и максимальные значения для каждой базы данных на 0 и 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
Горизонтальное увеличение или уменьшение эластичного пула гипермасштабирования
Используйте Azure CLI или Azure PowerShell, чтобы добавить или удалить вторичные реплики для существующего эластичного пула ресурсов Hyperscale — также называемого масштабированием вширь или вовнутрь.
Используйте команду az sql elastic-pool update, чтобы горизонтально масштабировать существующий эластичный пул Hyperscale, добавив вторичную реплику пула, или уменьшить размер эластичного пула, удалив вторичные реплики пула.
В следующем примере выполняется масштабирование гипермасштабируемого эластичного пула для использования четырёх вторичных реплик в пуле:
# 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
Следующий пример масштабируется в существующем эластичном пуле гипермасштабирования для использования одной вторичной реплики пула:
# 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
Перенос существующей базы данных в эластичный пул гипермасштабирования
С помощью Azure CLI или Azure PowerShell можно переместить существующую базу данных в базе данных SQL Azure в существующий эластичный пул гипермасштабирования.
Используйте команду az sql db update, чтобы переместить существующую базу данных в существующий пул эластичных баз данных с гипермасштабированием.
В следующем примере база данных my_existing_db
перемещается в существующий эластичный пул гипермасштабирования 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"
Обновление существующего эластичного пула с 5-го поколения до оборудования серии "Премиум"
Azure CLI или Azure PowerShell можно использовать для обновления существующего эластичного пула с 5-го поколения до оборудования серии "Премиум".
В настоящее время недоступно через Azure CLI. Вместо этого используйте Azure PowerShell или портал Azure.
Преобразование существующей базы данных общего назначения в зонально-избыточный эластичный пул гипермасштабирования.
Вы можете использовать Azure CLI или Azure PowerShell для преобразования существующей базы данных общего назначения в зонально-избыточный эластичный пул Hyperscale.
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
Используйте REST API 2021-11-01 (или более поздней версии) для работы со вторичными репликами для эластичных пулов с гипермасштабированием.
В следующем примере выполняется расширение существующего эластичного пула Hyperscale для использования четырех вторичных реплик:
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
}
}