다음을 통해 공유


az sql elastic-pool

탄력적 풀을 관리합니다.

명령

Name Description 형식 상태
az sql elastic-pool create

탄력적 풀을 만듭니다.

핵심 GA
az sql elastic-pool delete

탄력적 풀을 삭제합니다.

핵심 GA
az sql elastic-pool list

서버의 모든 탄력적 풀을 가져옵니다.

핵심 GA
az sql elastic-pool list-dbs

탄력적 풀의 데이터베이스 목록을 가져옵니다.

핵심 GA
az sql elastic-pool list-editions

활성 구독에 사용할 수 있는 탄력적 풀 버전을 나열합니다.

핵심 GA
az sql elastic-pool op

탄력적 풀에서 작업을 관리합니다.

핵심 GA
az sql elastic-pool op cancel

탄력적 풀에서 비동기 작업을 취소합니다.

핵심 GA
az sql elastic-pool op list

탄력적 풀에서 수행되는 작업 목록을 가져옵니다.

핵심 GA
az sql elastic-pool show

탄력적 풀을 가져옵니다.

핵심 GA
az sql elastic-pool update

탄력적 풀을 업데이트합니다.

핵심 GA

az sql elastic-pool create

탄력적 풀을 만듭니다.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

예제

영역 중복을 사용하도록 설정된 탄력적 풀 만들기

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

영역 중복을 명시적으로 사용하지 않도록 설정된 탄력적 풀 만들기

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

표준 100 DTU 탄력적 풀을 만듭니다.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

GeneralPurpose 버전, Gen4 하드웨어 및 1개의 vcore를 사용하여 탄력적 풀을 만듭니다.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

하이퍼스케일 버전, Gen5 하드웨어, 4개의 vcore 및 2개의 고가용성 복제본(replica) 사용하여 탄력적 풀을 만듭니다.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

VBS enclave를 사용하여 탄력적 풀을 만듭니다.

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

필수 매개 변수

--name -n

탄력적 풀의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--server -s

Azure SQL Server의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

선택적 매개 변수

--capacity --dtu -c

SKU의 용량 구성 요소(정수 DTU 또는 vcore)입니다.

--db-dtu-max --db-max-capacity --db-max-dtu

하나의 데이터베이스에서 사용할 수 있는 최대 용량(DTU 또는 vcore)입니다.

--db-dtu-min --db-min-capacity --db-min-dtu

각 데이터베이스의 최소 용량(DTU 또는 vcore)이 보장됩니다.

--edition --tier -e

sku의 버전 구성 요소입니다. 허용되는 값은 Basic, Standard, Premium, GeneralPurpose, BusinessCritical입니다.

--family -f

sku의 컴퓨팅 생성 구성 요소입니다(vcore sku에만 해당). 허용되는 값은 Gen4, Gen5입니다.

--ha-replicas --read-replicas

데이터베이스에 프로비전할 고가용성 복제본(replica) 수입니다. 하이퍼스케일 버전에 대해서만 설정할 수 있습니다.

--license-type

이 탄력적 풀에 적용할 라이선스 유형입니다.

허용되는 값: BasePrice, LicenseIncluded
--maint-config-id -m

이 리소스의 지정된 기본 테넌스 구성 ID 또는 이름입니다.

--max-size --storage

최대 스토리지 크기입니다. 단위가 지정되지 않은 경우 기본값은 바이트(B)입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--preferred-enclave-type

Azure SQL 탄력적 풀에 대한 기본 Enclave 형식입니다. 허용되는 값은 기본값, VBS입니다.

허용되는 값: Default, VBS
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--zone-redundant -z

영역 중복을 사용하도록 설정할지 여부를 지정합니다. 값이 지정되지 않은 경우 기본값은 true입니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql elastic-pool delete

탄력적 풀을 삭제합니다.

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

탄력적 풀의 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--server -s

Azure SQL Server의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql elastic-pool list

서버의 모든 탄력적 풀을 가져옵니다.

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--server -s

Azure SQL Server의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

--skip

건너뛸 컬렉션의 요소 수입니다. 기본값은 None입니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql elastic-pool list-dbs

탄력적 풀의 데이터베이스 목록을 가져옵니다.

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

탄력적 풀의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--server -s

Azure SQL Server의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql elastic-pool list-editions

활성 구독에 사용할 수 있는 탄력적 풀 버전을 나열합니다.

사용 가능한 풀 DTU 설정, 스토리지 용량 한도 및 데이터베이스별 설정이 포함됩니다. 세부 정보 표시를 줄이기 위해 추가 스토리지 용량 한도 및 데이터베이스별 설정은 기본적으로 숨겨져 있습니다.

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

예제

미국 서부 지역의 모든 탄력적 풀 버전 및 풀 DTU 제한을 표시합니다.

az sql elastic-pool list-editions -l westus -o table

미국 서부 지역의 Standard 버전에 대한 모든 풀 DTU 제한을 표시합니다.

az sql elastic-pool list-editions -l westus --edition Standard -o table

미국 서부 지역에서 DTU가 100개 이상인 탄력적 풀에 사용 가능한 최대 크기를 표시합니다.

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

미국 서부 지역의 표준 100 DTU 탄력적 풀에 대한 데이터베이스별 설정을 표시합니다.

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

필수 매개 변수

--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

선택적 매개 변수

--available -a

지정한 경우 지정된 지역에서 사용할 수 있는 결과만 표시합니다.

Default value: False
--dtu

검색할 DTU 수입니다. 지정되지 않은 경우 모든 DTU 크기가 표시됩니다.

--edition --tier -e

검색할 버전입니다. 지정되지 않은 경우 모든 버전이 표시됩니다.

--show-details -d

출력에 포함할 추가 세부 정보 목록입니다.

허용되는 값: db-max-dtu, db-max-size, db-min-dtu, max-size
--vcores

검색할 vcore 수입니다. 지정되지 않은 경우 모든 vcore 크기가 표시됩니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql elastic-pool show

탄력적 풀을 가져옵니다.

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

탄력적 풀의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--server -s

Azure SQL Server의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql elastic-pool update

탄력적 풀을 업데이트합니다.

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

예제

영역 중복을 사용하도록 설정된 탄력적 풀 업데이트

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

영역 중복을 명시적으로 사용하지 않도록 설정된 탄력적 풀 업데이트

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

2개의 고가용성 복제본(replica) 사용하여 탄력적 풀 업데이트

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

VBS enclave를 사용하여 탄력적 풀 업데이트

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []
--capacity --dtu -c

SKU의 용량 구성 요소(정수 DTU 또는 vcore)입니다.

--db-dtu-max --db-max-capacity --db-max-dtu

하나의 데이터베이스에서 사용할 수 있는 최대 용량(DTU 또는 vcore)입니다.

--db-dtu-min --db-min-capacity --db-min-dtu

각 데이터베이스의 최소 용량(DTU 또는 vcore)이 보장됩니다.

--edition --tier -e

sku의 버전 구성 요소입니다. 허용되는 값은 Basic, Standard, Premium, GeneralPurpose, BusinessCritical입니다.

--family -f

sku의 컴퓨팅 생성 구성 요소입니다(vcore sku에만 해당). 허용되는 값은 Gen4, Gen5입니다.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False
--ha-replicas --read-replicas

데이터베이스에 프로비전할 고가용성 복제본(replica) 수입니다. 하이퍼스케일 버전에 대해서만 설정할 수 있습니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--maint-config-id -m

이 리소스의 지정된 기본 테넌스 구성 ID 또는 이름입니다.

--max-size --storage

최대 스토리지 크기입니다. 단위가 지정되지 않은 경우 기본값은 바이트(B)입니다.

--name -n

탄력적 풀의 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--preferred-enclave-type

탄력적 풀에 대해 구성할 enclave 유형입니다.

허용되는 값: Default, VBS
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--server -s

Azure SQL Server의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []
--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--zone-redundant -z

영역 중복을 사용하도록 설정할지 여부를 지정합니다. 값이 지정되지 않은 경우 기본값은 true입니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.