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

적용 대상: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을 사용하여 하이퍼스케일 탄력적 풀을 만들 수 있습니다.

Azure CLI

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

PowerShell

New-AzSqlElasticPool cmdlet을 사용하여 하이퍼스케일 탄력적 풀을 만듭니다.

다음 예제에서는 vCore 4개와 보조 풀 복제본 2개로 구성된 하이퍼스케일 탄력적 풀을 만듭니다.

New-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -Edition "Hyperscale" -VCore 4 -ComputeGeneration Gen5 -HighAvailabilityReplicaCount 2

다음 예제에서는 vCore 4개와 보조 풀 복제본 1개로 구성된 영역 중복 하이퍼스케일 탄력적 풀을 만듭니다.

New-AzSqlElasticPool -ResourceGroupName "myresourcegroup" -ServerName "mylogicalserver" -ElasticPoolName "zr-hs-ep" -Edition Hyperscale -ComputeGeneration Gen5 -VCore 4 -HighAvailabilityReplicaCount 1 -ZoneRedundant

하이퍼스케일 탄력적 풀 확장

Azure CLI 또는 Azure PowerShell을 사용하여 기존 하이퍼스케일 탄력적 풀을 확장할 수 있습니다.

Azure CLI

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

PowerShell

Set-AzSqlElasticPool cmdlet을 사용하여 기존 하이퍼스케일 탄력적 풀을 확장합니다.

다음 예제에서는 기존 하이퍼스케일 탄력적 풀을 vCore 8개로 확장하고 DB당 최소 및 최대값을 각각 0과 2로 설정합니다.

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -VCore 8 -DatabaseVCoreMin 0 -DatabaseVCoreMax 2

하이퍼스케일 탄력적 풀 확장(또는 축소)

Azure CLI 또는 Azure PowerShell을 사용하여 기존 하이퍼스케일 탄력적 풀에 보조 풀 복제본을 추가하거나 제거합니다(확장 또는 축소라고도 함).

Azure CLI

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

PowerShell

Set-AzSqlElasticPool 명령을 사용해 보조 풀 복제본을 추가하여 기존 하이퍼스케일 탄력적 풀을 확장하거나 보조 풀 복제본을 제거하여 탄력적 풀을 축소합니다.

다음 예제에서는 보조 풀 복제본 4개를 사용하기 위해 기존 하이퍼스케일 탄력적 풀을 확장합니다.

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 4

다음 예제에서는 보조 풀 복제본 1개를 사용하기 위해 기존 하이퍼스케일 탄력적 풀을 축소합니다.

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 1

기존 데이터베이스를 하이퍼스케일 탄력적 풀로 이동

Azure CLI 또는 Azure PowerShell을 사용하여 Azure SQL Database의 기존 데이터베이스를 기존 하이퍼스케일 탄력적 풀로 이동할 수 있습니다.

Azure CLI

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"

PowerShell

Set-AzSqlDatabase cmdlet을 사용하여 기존 데이터베이스를 기존 하이퍼스케일 탄력적 풀로 이동합니다.

다음 예제에서는 my_existing_db 데이터베이스를 my_hs_pool 기존 하이퍼스케일 탄력적 풀로 이동합니다.

Set-AzSqlDatabase -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -DatabaseName "my_existing_db" -ElasticPoolName "my_hs_pool"

기존 탄력적 풀을 Gen5에서 프리미엄 시리즈 하드웨어로 업그레이드

Azure CLI 또는 Azure PowerShell을 사용하여 기존 탄력적 풀을 Gen5에서 프리미엄 시리즈 하드웨어로 업그레이드할 수 있습니다.

Azure CLI

현재 Azure CLI를 통해 사용할 수 없습니다. 대신 PowerShell 또는 Azure Portal을 사용합니다.

PowerShell

Set-AzSqlElasticPool cmdlet을 사용하여 기존 하이퍼스케일 탄력적 풀을 확장합니다.

다음 예제에서는 my_hs_pool 기존 하이퍼스케일 탄력적 풀을 프리미엄 시리즈 하드웨어로 업그레이드합니다.

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -ComputeGeneration "PRMS"

기존 범용 데이터베이스를 영역 중복 하이퍼스케일 탄력적 풀로 마이그레이션

Azure CLI 또는 Azure PowerShell을 사용하여 기존 범용 데이터베이스를 영역 중복 하이퍼스케일 탄력적 풀로 마이그레이션할 수 있습니다.

Azure CLI

az sql db update --resource-group "myresourcegroup" --server "mylogicalserver" --name "gp_zrs_standalone_db" --elastic-pool "zr-hs-ep" --backup-storage-redundancy Zone

PowerShell

Set-AzSqlDatabase -ResourceGroupName "myResourceGroup" -ServerName "mylogicalserver" -DatabaseName gp1 -ElasticPoolName "my-ZR-Hyperscale-EP" -BackupStorageRedundancy 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
  }
}

관련 콘텐츠

• Azure SQL Database CLI 명령.
• Azure SQL Database PowerShell cmdlet.
• Azure SQL Database 탄력적 풀 REST API.
• 하이퍼스케일 탄력적 풀 개요.