다음을 통해 공유


az sql db replica

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

명령

Name Description 형식 상태
az sql db replica create

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

핵심 GA
az sql db replica delete-link

두 데이터베이스 복제본(replica) 간의 데이터 복제본(replica)tion을 영구적으로 중지합니다.

핵심 GA
az sql db replica list-links

데이터베이스의 복제본(replica) 및 해당 복제본(replica)tion 상태 나열합니다.

핵심 GA
az sql db replica set-primary

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

핵심 GA

az sql db replica create

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

를 실행 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]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--zone-redundant {false, true}]

예제

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

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

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

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

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

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

새 복제본(replica) 만들 서버의 이름입니다.

--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 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다.

--availability-zone

가용성 영역.

--backup-storage-redundancy --bsr

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

--capacity -c

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

--compute-model

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

허용되는 값: Provisioned, Serverless
--elastic-pool

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

--encryption-protector

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

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

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

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

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

--federated-client-id

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

--ha-replicas --read-replicas

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

--keys

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

--license-type

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

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

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

--no-wait

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

Default value: False
--partner-database

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

--partner-resource-group

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

--preferred-enclave-type

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

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

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

허용되는 값: 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.

--tags

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

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

SQL Database에 대한 사용자 할당 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를 사용합니다.

두 데이터베이스 복제본(replica) 간의 데이터 복제본(replica)tion을 영구적으로 중지합니다.

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

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

--ids

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

--name -n

Azure SQL Database의 이름입니다.

--partner-resource-group

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

--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기본 구독을 구성할 수 있습니다.

--yes -y

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

Default value: False
전역 매개 변수
--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를 사용합니다.

데이터베이스의 복제본(replica) 및 해당 복제본(replica)tion 상태 나열합니다.

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

데이터베이스의 복제본(replica) 및 해당 복제본(replica)tion 상태 나열합니다. (자동 생성됨)

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

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

--name -n

Azure SQL Database의 이름입니다.

--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 db replica set-primary

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

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

예제

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

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' 인수를 제공해야 합니다.

--name -n

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

--resource-group -g

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

--server -s

새 주 복제본이 될 보조 복제본(replica) 포함하는 서버의 이름입니다. 를 사용하여 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를 사용합니다.