다음을 통해 공유


명령줄 도구를 사용한 하이퍼스케일 탄력적 풀 작업

적용 대상: Azure SQL Database

이 문서에서는 Azure CLI 및 PowerShell과 같은 명령줄 도구를 사용하여 데이터베이스를 만들고, 크기를 조정하고, 하이퍼스케일 탄력적 풀로 이동하는 방법을 알아봅니다. 이러한 방법 외에도 대부분의 작업에 항상 Azure Portal을 사용할 수 있습니다.

필수 조건

하이퍼스케일 탄력적 풀을 사용하려면 다음이 필요합니다.

새 하이퍼스케일 탄력적 풀 만들기

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