명령줄 도구를 사용한 하이퍼스케일 탄력적 풀 작업
적용 대상: 
Azure SQL Database
이 문서에서는 Azure CLI 및 PowerShell과 같은 명령줄 도구를 사용하여 데이터베이스를 만들고, 크기를 조정하고, 하이퍼스케일 탄력적 풀로 이동하는 방법을 알아봅니다. 이러한 방법 외에도 대부분의 작업에 항상 Azure Portal을 사용할 수 있습니다.
필수 조건
하이퍼스케일 탄력적 풀을 사용하려면 다음이 필요합니다.
- 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 명령을 사용하여 하이퍼스케일 탄력적 풀을 만듭니다.
다음 예제에서는 vCore 4개와 보조 풀 복제본 2개가 있는 하이퍼스케일 탄력적 풀을 만듭니다.
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
다음 예제에서는 vCore 4개와 보조 풀 복제본 1개가 있는 영역 중복 하이퍼스케일 탄력적 풀을 만듭니다.
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
하이퍼스케일 탄력적 풀 확장
Azure CLI 또는 Azure PowerShell을 사용하여 기존 하이퍼스케일 탄력적 풀을 확장할 수 있습니다.
az sql elastic-pool update 명령을 사용하여 기존 하이퍼스케일 탄력적 풀을 확장합니다.
다음 예제에서는 기존 하이퍼스케일 탄력적 풀을 vCore 8개로 확장하고 DB당 최소 및 최대값을 각각 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을 사용하여 기존 하이퍼스케일 탄력적 풀에 보조 풀 복제본을 추가하거나 제거합니다(확장 또는 축소라고도 함).
az sql elastic-pool update 명령을 사용해 보조 풀 복제본을 추가하여 기존 하이퍼스케일 탄력적 풀을 확장하거나 보조 풀 복제본을 제거하여 탄력적 풀을 축소합니다.
다음 예제에서는 보조 풀 복제본 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 4
다음 예제에서는 보조 풀 복제본 1개를 사용하기 위해 기존 하이퍼스케일 탄력적 풀을 축소합니다.
# 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을 사용하여 Azure SQL Database의 기존 데이터베이스를 기존 하이퍼스케일 탄력적 풀로 이동할 수 있습니다.
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"
기존 탄력적 풀을 Gen5에서 프리미엄 시리즈 하드웨어로 업그레이드
Azure CLI 또는 Azure PowerShell을 사용하여 기존 탄력적 풀을 Gen5에서 프리미엄 시리즈 하드웨어로 업그레이드할 수 있습니다.
현재 Azure CLI를 통해 사용할 수 없습니다. 대신 PowerShell 또는 Azure Portal을 사용합니다.
기존 범용 데이터베이스를 영역 중복 하이퍼스케일 탄력적 풀로 전환
Azure CLI 또는 Azure PowerShell을 사용하여 기존 범용 데이터베이스를 영역 중복 하이퍼스케일 탄력적 풀로 전환할 수 있습니다.
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
2021-11-01 REST API(또는 그 이상)를 사용하여 하이퍼스케일 탄력적 풀의 보조 복제본으로 작업합니다.
다음 예제에서는 보조 복제본 4개를 사용하기 위해 기존 하이퍼스케일 탄력적 풀을 확장합니다.
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
}
}