Azure CLI 및 REST API에서 읽기 복제본 만들기 및 관리
적용 대상: 
Azure Database for PostgreSQL - 단일 서버
Important
Azure Database for PostgreSQL - 단일 서버는 곧 사용 중지됩니다. Azure Database for PostgreSQL - 유연한 서버로 업그레이드하는 것이 좋습니다. Azure Database for PostgreSQL - 유연한 서버로 마이그레이션하는 방법에 대한 자세한 내용은 Azure Database for PostgreSQL 단일 서버에 대한 새로운 소식을 참조하세요.
이 문서에서는 Azure CLI 및 REST API을 이용하여 Azure Database for PostgreSQL의 읽기 복제본을 만들고 관리하는 방법에 대해 알아봅니다. 읽기 복제본에 대한 자세한 내용은 개요를 참조하세요.
Azure 복제본 지원
읽기 복제본과 논리 디코딩은 모두 정보에 대한 Postgres WAL(Write Ahead Log)에 따라 달라집니다. 이러한 두 기능에는 Postgres의 다른 로깅 수준이 필요합니다. 논리 디코딩에는 읽기 복제본보다 높은 수준의 로깅이 필요합니다.
올바른 로깅 수준을 구성하려면 Azure 복제 지원 매개 변수를 사용하세요. Azure 복제 지원에는 다음 세 가지 설정 옵션이 있습니다.
- 해제 - WAL에 최소 정보를 저장합니다. 이 설정은 대부분의 Azure Database for PostgreSQL 서버에서 사용할 수 없습니다.
- 복제본 - 해제보다 자세한 정보를 표시합니다. 이는 읽기 복제본이 작동하는 데 필요한 최소 로깅 수준입니다. 이 설정은 대부분의 서버에서 기본값입니다.
- 논리 - 복제본보다 자세한 정보를 표시합니다. 논리 디코딩이 작동하기 위한 최소 로깅 수준입니다. 읽기 복제본도 이 설정에서 작동합니다.
참고 항목
지속적인 쓰기 집약적 주 워크로드에 대한 읽기 복제본을 배포할 때 복제 지연이 계속 증가할 수 있으며, 주 워크로드의 속도를 따라잡지 못할 수도 있습니다. WAL 파일은 복제본에서 수신될 때까지 삭제되지 않기 때문에 주 서버에서 스토리지 사용량이 증가할 수도 있습니다.
Azure CLI
Azure CLI를 사용하여 읽기 복제본을 생성하고 관리할 수 있습니다.
필수 조건
- Azure CLI 2.0 설치
- 주 서버가 될 Azure Database for PostgreSQL 서버입니다.
주 서버 준비
주 서버의
azure.replication_support값을 확인합니다. 읽기 복제본이 작동하려면 적어도 복제본이어야 합니다.az postgres server configuration show --resource-group myresourcegroup --server-name mydemoserver --name azure.replication_supportazure.replication_support가 적어도 복제본이 아닌 경우 다음을 참조하세요.az postgres server configuration set --resource-group myresourcegroup --server-name mydemoserver --name azure.replication_support --value REPLICA서버를 다시 시작하여 변경 내용을 적용합니다.
az postgres server restart --name mydemoserver --resource-group myresourcegroup
읽기 복제본 만들기
az postgres server replica create 명령에는 다음 매개 변수가 필요합니다.
| 설정 | 예제 값 | 설명 |
|---|---|---|
| resource-group | myresourcegroup | 복제본 서버가 만들어지는 리소스 그룹입니다. |
| name | mydemoserver-replica | 만들어지는 새 복제본 서버의 이름입니다. |
| source-server | mydemoserver | 복제할 기존 주 서버의 이름 또는 리소스 ID입니다. 복제본 및 주 리소스 그룹을 다르게 하려면 리소스 ID를 사용합니다. |
아래 CLI 예제에서는 복제본이 주 서버와 동일한 영역에 생성됩니다.
az postgres server replica create --name mydemoserver-replica --source-server mydemoserver --resource-group myresourcegroup
영역 간 읽기 복제본을 만들려면 --location 매개 변수를 사용합니다. 아래 CLI 예제에서는 미국 서부에 복제본을 만듭니다.
az postgres server replica create --name mydemoserver-replica --source-server mydemoserver --resource-group myresourcegroup --location westus
참고 항목
복제본을 만들 수 있는 지역에 대해 자세히 알아보려면 읽기 복제본 개념 문서를 참조하세요.
범용 또는 메모리 최적화 주 서버에서 azure.replication_support 매개 변수를 REPLICA로 설정하지 않고 서버를 다시 시작하지 않으면 오류가 발생합니다. 복제본을 만들기 전에 이러한 두 단계를 완료합니다.
Important
다음으로 읽기 복제본 개요의 고려 사항 섹션을 검토합니다.
주 서버 설정을 새 값으로 업데이트하기 전에 복제본 설정을 같거나 큰 값으로 업데이트합니다. 이렇게 하면 복제본이 주 서버에 대한 변경 내용을 유지할 수 있습니다.
복제본 목록
az postgres server replica list 명령을 사용하여 주 서버의 복제본 목록을 볼 수 있습니다.
az postgres server replica list --server-name mydemoserver --resource-group myresourcegroup
복제본 서버로의 복제 중지
az postgres server replica stop 명령을 사용하여 주 서버와 읽기 복제본 간의 복제를 중지할 수 있습니다.
주 서버와 읽기 복제본에 대한 복제를 중지한 경우 실행 취소할 수 없습니다. 읽기 복제본은 읽기 및 쓰기를 둘 다 지원하는 독립 실행형 서버가 됩니다. 독립 실행형 서버를 다시 복제본으로 만들 수 없습니다.
az postgres server replica stop --name mydemoserver-replica --resource-group myresourcegroup
주 서버 또는 복제 서버 삭제
주 서버 또는 복제 서버를 삭제하려면 az postgres server delete 명령을 사용합니다.
주 서버를 삭제하면 모든 읽기 복제본에 대한 복제가 중지됩니다. 그러면 읽기 복제본은 읽기와 쓰기를 모두 지원하는 독립 실행형 서버가 됩니다.
az postgres server delete --name myserver --resource-group myresourcegroup
REST API
Azure REST API를 사용하여 읽기 복제본을 생성하고 관리할 수 있습니다.
주 서버 준비
주 서버의
azure.replication_support값을 확인합니다. 읽기 복제본이 작동하려면 적어도 복제본이어야 합니다.GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{masterServerName}/configurations/azure.replication_support?api-version=2017-12-01azure.replication_support가 적어도 복제본이 아닌 경우 다음을 참조하세요.PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{masterServerName}/configurations/azure.replication_support?api-version=2017-12-01{ "properties": { "value": "replica" } }서버를 다시 시작하여 변경 내용을 적용합니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{masterServerName}/restart?api-version=2017-12-01
읽기 복제본 만들기
API 만들기를 사용하여 읽기 복제본을 만들 수 있습니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{replicaName}?api-version=2017-12-01
{
"location": "southeastasia",
"properties": {
"createMode": "Replica",
"sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{masterServerName}"
}
}
참고 항목
복제본을 만들 수 있는 지역에 대해 자세히 알아보려면 읽기 복제본 개념 문서를 참조하세요.
범용 또는 메모리 최적화 주 서버에서 azure.replication_support 매개 변수를 REPLICA로 설정하지 않고 서버를 다시 시작하지 않으면 오류가 발생합니다. 복제본을 만들기 전에 이러한 두 단계를 완료합니다.
복제본은 주 서버와 동일한 컴퓨팅 및 스토리지 설정을 사용하여 생성됩니다. 복제본을 만든 후에는 주 서버와는 별도로 컴퓨팅 생성, vCore, 스토리지 및 백업 보존 기간 등의 일부 설정을 변경할 수 있습니다. 가격 책정도 기본 계층에서 다른 계층으로 또는 다른 계층에서 기본 계층으로 변경하는 경우를 제외하고 독립적으로 변경할 수 있습니다.
Important
주 서버 설정을 새 값으로 업데이트하기 전에 복제본 설정을 같거나 큰 값으로 업데이트합니다. 이렇게 하면 복제본이 주 서버에 대한 변경 내용을 유지할 수 있습니다.
복제본 목록
복제본 목록 API를 사용하여 주 서버의 복제본 목록을 볼 수 있습니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{masterServerName}/Replicas?api-version=2017-12-01
복제본 서버로의 복제 중지
업데이트 API를 사용하여 주 서버와 읽기 복제본 간의 복제를 중지할 수 있습니다.
주 서버와 읽기 복제본에 대한 복제를 중지한 경우 실행 취소할 수 없습니다. 읽기 복제본은 읽기 및 쓰기를 둘 다 지원하는 독립 실행형 서버가 됩니다. 독립 실행형 서버를 다시 복제본으로 만들 수 없습니다.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{replicaServerName}?api-version=2017-12-01
{
"properties": {
"replicationRole":"None"
}
}
주 서버 또는 복제 서버 삭제
주 서버 또는 복제 서버를 삭제하려면 API 삭제를 사용합니다.
주 서버를 삭제하면 모든 읽기 복제본에 대한 복제가 중지됩니다. 그러면 읽기 복제본은 읽기와 쓰기를 모두 지원하는 독립 실행형 서버가 됩니다.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{serverName}?api-version=2017-12-01
다음 단계
- Azure Database for PostgreSQL의 읽기 복제본에 대해 자세히 알아봅니다.
- Azure Portal에서 읽기 복제본을 만들고 관리하는 방법을 알아봅니다.
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기