다음을 통해 공유

az sql db replica

데이터베이스 간의 복제를 관리합니다.

명령

Name Description 형식 상태
az sql db replica create

기존 데이터베이스의 읽기 가능한 보조 복제본으로 데이터베이스를 만듭니다.

 Core GA
az sql db replica delete-link

두 데이터베이스 복제본 간의 데이터 복제를 영구적으로 중지합니다.

 Core GA
az sql db replica list-links

데이터베이스의 복제본과 해당 복제 상태를 나열합니다.

 Core GA
az sql db replica set-primary

현재 주 복제본 데이터베이스에서 장애 조치(failover)하여 주 복제본 데이터베이스를 설정합니다.

 Core GA

az sql db replica create

편집

기존 데이터베이스의 읽기 가능한 보조 복제본으로 데이터베이스를 만듭니다.

를 실행 az sql db list-editions -a -o table -l LOCATION하여 성능 수준 옵션의 전체 목록을 볼 수 있습니다. 보조 데이터베이스에는 주 데이터베이스와 동일한 버전이 있어야 합니다.

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy --bsr]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation --epauto {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas --read-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--partner-sub-id]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective --service-objective]
                         [--tags]
                         [--umi --user-assigned-identity-id]
                         [--zone-redundant {false, true}]

예제

성능 수준 S0이 있는 데이터베이스를 기존 표준 데이터베이스의 보조 복제본으로 만듭니다.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

GeneralPurpose 버전, Gen4 하드웨어 및 1개 vcore를 사용하여 기존 GeneralPurpose 데이터베이스의 보조 복제본으로 데이터베이스 만들기

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

영역 중복 백업 스토리지를 기존 데이터베이스의 보조 복제본으로 사용하여 데이터베이스를 만듭니다.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

필수 매개 변수

--name -n

Azure SQL Database의 이름입니다.

--partner-server

새 복제본을 만들 서버의 이름입니다.

--resource-group -g

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

--server -s

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--assign-identity -i

데이터베이스에 대한 ID를 할당합니다.

속성 값
허용되는 값: false, true
--auto-pause-delay

데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다.

속성 값
매개 변수 그룹: Serverless offering Arguments
--availability-zone

가용성 영역.

--backup-storage-redundancy --bsr

백업을 저장하는 데 사용되는 백업 스토리지 중복성입니다. 허용되는 값은 Local, Zone, GeoZone입니다.

--capacity -c

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

속성 값
매개 변수 그룹: Performance Level (components) Arguments
--compute-model

데이터베이스의 컴퓨팅 모델입니다.

속성 값
매개 변수 그룹: Serverless offering Arguments
허용되는 값: Provisioned, Serverless
--elastic-pool

데이터베이스를 만들 탄력적 풀의 이름 또는 리소스 ID입니다.

속성 값
매개 변수 그룹: Performance Level Arguments
--encryption-protector

데이터베이스 암호화 보호기 키로 사용할 Azure Key Vault 키를 지정합니다.

--encryption-protector-auto-rotation --epauto

데이터베이스 암호화 보호기 키 자동 회전 플래그를 지정합니다. true, false 또는 null일 수 있습니다.

속성 값
허용되는 값: false, true
--family -f

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

속성 값
매개 변수 그룹: Performance Level (components) Arguments
--federated-client-id

SQL Database의 페더레이션된 클라이언트 ID입니다. 테넌트 간 CMK 시나리오에 사용됩니다.

--ha-replicas --read-replicas

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

--keys

SQL Database에 대한 AKV 키 목록입니다.

--license-type

이 데이터베이스에 적용할 라이선스 유형입니다.라이선스가 필요한 경우 LicenseIncluded, 라이선스가 있고 Azure HybridBenefit에 적합한 경우 BasePrice.

속성 값
허용되는 값: BasePrice, LicenseIncluded
--min-capacity

일시 중지되지 않은 경우 데이터베이스에 항상 할당되는 최소 용량입니다.

속성 값
매개 변수 그룹: Serverless offering Arguments
--no-wait

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

속성 값
Default value: False
--partner-database

새 복제본의 이름입니다. 지정되지 않은 경우 기본값은 원본 데이터베이스 이름입니다.

--partner-resource-group

새 복제본을 만들 리소스 그룹의 이름입니다. 지정되지 않은 경우 기본값은 원본 리소스 그룹으로 설정됩니다.

--partner-sub-id

새 복제본을 만들 구독 ID입니다. 지정되지 않은 경우 기본값은 원본 구독 ID입니다.

--preferred-enclave-type

이 리소스의 enclave 유형을 지정합니다.

속성 값
허용되는 값: Default, VBS
--read-scale

사용하도록 설정된 경우 애플리케이션 의도가 연결 문자열에서 읽기 전용으로 설정된 연결은 읽기 전용 보조 복제본으로 라우팅될 수 있습니다. 이 속성은 프리미엄 및 중요 비즈니스용 데이터베이스에 대해서만 설정할 수 있습니다.

속성 값
허용되는 값: Disabled, Enabled
--secondary-type

만들 보조 형식입니다. 허용되는 값은 Geo, Named입니다.

--service-level-objective --service-objective

새 데이터베이스에 대한 서비스 목표입니다. 예: Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

속성 값
매개 변수 그룹: Performance Level Arguments
--tags

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

--umi --user-assigned-identity-id

SQL Database에 대한 사용자 할당 ID 목록입니다.

--zone-redundant -z

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

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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False
편집

두 데이터베이스 복제본 간의 데이터 복제를 영구적으로 중지합니다.

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

다른 복제본이 있는 서버의 이름입니다.

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--name -n

Azure SQL Database의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--partner-resource-group

다른 복제본이 있는 리소스 그룹의 이름입니다. 지정되지 않은 경우 기본값은 첫 번째 데이터베이스의 리소스 그룹입니다.

--resource-group -g

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

속성 값
매개 변수 그룹: Resource Id Arguments
--server -s

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

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
--yes -y

확인 메시지를 표시하지 않습니다.

속성 값
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False
편집

데이터베이스의 복제본과 해당 복제 상태를 나열합니다.

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

데이터베이스의 복제본과 해당 복제 상태를 나열합니다. (autogenerated)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--name -n

Azure SQL Database의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--resource-group -g

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

속성 값
매개 변수 그룹: Resource Id Arguments
--server -s

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

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az sql db replica set-primary

편집

현재 주 복제본 데이터베이스에서 장애 조치(failover)하여 주 복제본 데이터베이스를 설정합니다.

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

예제

현재 주 복제본 데이터베이스에서 장애 조치(failover)하여 주 복제본 데이터베이스를 설정합니다. (autogenerated)

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--allow-data-loss

지정된 경우 장애 조치(failover) 작업으로 데이터 손실이 허용됩니다.

속성 값
Default value: False
--ids

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

속성 값
매개 변수 그룹: Resource Id Arguments
--name -n

장애 조치(failover)할 데이터베이스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--resource-group -g

새 주 복제본이 될 보조 복제본을 포함하는 리소스 그룹의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--server -s

새 주 복제본이 될 보조 복제본을 포함하는 서버의 이름입니다. 를 사용하여 az configure --defaults sql-server=<name>기본값을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

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

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False