다음을 통해 공유


az postgres flexible-server replica

읽기 복제본을 관리합니다.

명령

Name Description 형식 상태
az postgres flexible-server replica create

서버용 읽기 복제본을 만듭니다.

Core GA
az postgres flexible-server replica list

지정된 서버의 모든 읽기 복제본을 나열합니다.

Core GA
az postgres flexible-server replica promote

읽기 복제본의 복제를 중지하고 독립 서버 또는 주 서버로 승격합니다.

Core GA

az postgres flexible-server replica create

서버용 읽기 복제본을 만듭니다.

az postgres flexible-server replica create --replica-name
                                           --resource-group
                                           --source-server
                                           [--address-prefixes]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--subnet]
                                           [--subnet-prefixes]
                                           [--tags]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

예제

사용 가능한 경우 지정된 영역 및 위치에 공용 또는 프라이빗 액세스 권한이 있는 'testserver'에 대한 읽기 복제본 'testreplicaserver'를 만듭니다.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --zone 3 --location testLocation

프라이빗 액세스 권한이 있는 'testserver'에 대한 새 서브넷을 사용하여 읽기 복제본 'testreplicaserver'를 만듭니다.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com \
  --tags "key=value"

사용 가능한 경우 지정된 위치에 퍼블릭 또는 프라이빗 액세스 권한이 있는 'testserver'에 대한 읽기 복제본 'testreplicaserver'를 만듭니다. 영역이 전달되지 않으므로 원본 서버와 다른 복제본 위치에서 영역이 자동으로 선택되고, 사용 가능한 경우 복제본 위치의 원본 서버와 동일한 영역을 선택합니다. 그렇지 않으면 영역을 None으로 설정합니다. 즉, 기본 설정 없음

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --location testLocation

사용자 지정 --storage-size 및 --sku를 사용하여 'testserver'에 대한 읽기 복제본 'testreplicaserver'를 만듭니다.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --sku-name Standard_D4ds_v5 --storage-size 256

'testserver'에 대한 읽기 복제본 'testreplicaserver'를 만듭니다. 여기서 'testreplicaserver'는 다른 리소스 그룹 'newTestGroup'에 있습니다. 여기서 --resource-group은 읽기 복제본의 리소스 그룹에 대한 것이며 --source-server는 리소스 ID로 전달되어야 합니다.

az postgres flexible-server replica create --replica-name testreplicaserver -g newTestGroup         --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName} --location testLocation

필수 매개 변수

--replica-name

복원할 서버의 이름입니다.

--resource-group -g

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

--source-server

복원할 원본 서버의 이름 또는 리소스 ID입니다.

선택적 매개 변수

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

--address-prefixes

CIDR 형식으로 새 가상 네트워크를 만들 때 사용할 IP 주소 접두사입니다. 기본값은 10.0.0.0/16입니다.

--identity

데이터 암호화에 대한 사용자 할당 ID의 이름 또는 리소스 ID입니다.

--key

데이터 암호화에 대한 기본 키 자격 증명 모음 키의 리소스 ID입니다.

--location -l

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

--no-wait

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

속성
Default value: False
--performance-tier

서버의 성능 계층입니다.

--private-dns-zone

이 매개 변수는 프라이빗 액세스 권한이 있는 서버에만 적용됩니다. 새 또는 기존 프라이빗 dns 영역의 이름 또는 ID입니다. 동일한 리소스 그룹, 다른 리소스 그룹 또는 다른 구독에서 프라이빗 dns 영역을 사용할 수 있습니다. 다른 리소스 그룹 또는 구독의 영역을 사용하려면 리소스 ID를 제공하세요. CLI는 사용자가 제공하지 않는 경우 가상 네트워크와 동일한 리소스 그룹 내에 새 프라이빗 DNS 영역을 만듭니다.

--sku-name

컴퓨팅 SKU의 이름입니다. {VM 이름}Standard_ 규칙을 따릅니다. 예: Standard_B1ms.

--storage-size

서버의 스토리지 용량입니다. 최소값은 32GiB이고 최대값은 16TiB입니다.

--subnet

새 서브넷 또는 기존 서브넷의 이름 또는 리소스 ID입니다. 다른 리소스 그룹 또는 구독의 서브넷을 사용하려면 이름 대신 리소스 ID를 제공하세요. 서브넷은 flexibleServers에 위임됩니다. 위임 후에는 다른 유형의 Azure 리소스에 이 서브넷을 사용할 수 없습니다.

--subnet-prefixes

CIDR 형식으로 새 서브넷을 만들 때 사용할 서브넷 IP 주소 접두사입니다. 기본값은 10.0.0.0/24입니다.

--tags

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

--tier

서버의 컴퓨팅 계층입니다. 허용되는 값: 버스트 가능, GeneralPurpose, MemoryOptimized.

--vnet

새 가상 네트워크 또는 기존 가상 네트워크의 이름 또는 ID입니다. 다른 리소스 그룹 또는 구독의 vnet을 사용하려면 리소스 ID를 제공하세요. 이름은 2~64자 사이여야 합니다. 이름은 문자 또는 숫자로 시작하고 문자, 숫자 또는 밑줄로 끝나야 하며 문자, 숫자, 밑줄, 마침표 또는 하이픈만 포함할 수 있습니다.

--yes -y

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

속성
Default value: False
--zone -z

리소스를 프로비전할 가용성 영역입니다.

전역 매개 변수
--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 postgres flexible-server replica list

지정된 서버의 모든 읽기 복제본을 나열합니다.

az postgres flexible-server replica list --name
                                         --resource-group

예제

마스터 서버 'testserver'에 대한 모든 읽기 복제본을 나열합니다.

az postgres flexible-server replica list -g testGroup -n testserver

필수 매개 변수

--name -n

원본 서버의 이름입니다.

--resource-group -g

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

전역 매개 변수
--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 postgres flexible-server replica promote

읽기 복제본의 복제를 중지하고 독립 서버 또는 주 서버로 승격합니다.

az postgres flexible-server replica promote [--ids]
                                            [--name]
                                            [--promote-mode {standalone, switchover}]
                                            [--promote-option {forced, planned}]
                                            [--resource-group]
                                            [--subscription]
                                            [--yes]

예제

'testreplicaserver'에 대한 복제를 중지하고 독립 실행형 읽기/쓰기 서버로 승격합니다.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver

'testreplicaserver'에 대한 복제를 중지하고 강제 데이터 동기화를 사용하여 독립 실행형 읽기/쓰기 서버로 승격합니다.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode standalone --promote-option forced

'testreplicaserver'에 대한 복제를 중지하고 계획된 데이터 동기화를 사용하여 주 서버로 승격합니다. 승격하려는 복제본에는 판독기 가상 엔드포인트가 할당되어 있어야 합니다. 그렇지 않으면 승격 시 오류가 발생합니다.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode switchover --promote-option planned

선택적 매개 변수

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

--ids

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

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

서버의 이름입니다. 이름에는 소문자, 숫자, 하이픈(-) 문자만 사용할 수 있습니다. 최소 3자 및 최대 63자

속성
매개 변수 그룹: Resource Id Arguments
--promote-mode

읽기 복제본을 독립 서버로 승격할지 또는 주 서버로 승격할지 여부입니다.

속성
Default value: standalone
허용되는 값: standalone, switchover
--promote-option

읽기 복제본을 승격하기 전에 데이터를 동기화할지 또는 가능한 한 빨리 승격할지 여부입니다.

속성
Default value: planned
허용되는 값: forced, planned
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<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