다음을 통해 공유

Azure CLI 및 REST API를 사용하여 Azure Database for MariaDB에서 읽기 복제본을 만들고 관리하는 방법

  • 아티클

Important

Azure Database for MariaDB는 사용 중지될 예정입니다. Azure Database for MySQL로 마이그레이션하는 것이 좋습니다. Azure Database for MySQL로 마이그레이션하는 방법에 대한 자세한 내용은 Azure Database for MariaDB에 대한 새로운 소식을 참조하세요.

이 문서에서는 Azure CLI 및 REST API를 사용하여 Azure Database for MariaDB 서비스에서 읽기 복제본을 만들고 관리하는 방법을 알아봅니다.

Azure CLI

Azure CLI를 사용하여 읽기 복제본을 생성하고 관리할 수 있습니다.

필수 조건

Important

읽기 복제본 기능은 범용 또는 메모리 최적화 가격 책정 계층의 Azure Database for MariaDB 서버에서만 사용 가능합니다. 원본 서버가 이러한 가격 책정 계층 중 하나에 포함되어 있는지 확인합니다.

읽기 복제본 만들기

Important

기존 복제본이 없는 원본에 대한 복제본을 만드는 경우 원본이 먼저 다시 시작하여 자체적으로 복제할 준비를 합니다. 이를 고려하고 사용량이 적은 기간 동안 이러한 작업을 수행합니다.

다음 명령을 사용하여 읽기 복제본 서버를 만들 수 있습니다.

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup

az mariadb server replica create 명령에는 다음과 같은 매개 변수가 필요합니다.

설정 예제 값 설명
resource-group  myresourcegroup  복제본 서버가 만들어지는 리소스 그룹입니다. 
name mydemoreplicaserver 만들어지는 새 복제본 서버의 이름입니다.
source-server mydemoserver 복제할 기존 원본 서버의 이름 또는 ID입니다.

영역 간 읽기 복제본을 만들려면 --location 매개 변수를 사용합니다.

아래 CLI 예제에서는 미국 서부에 복제본을 만듭니다.

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup --location westus

참고 항목

복제본을 만들 수 있는 지역에 대해 자세히 알아보려면 읽기 복제본 개념 문서를 참조하세요.

참고 항목

읽기 복제본은 마스터와 같은 서버 구성을 사용하여 생성됩니다. 복제본이 생성된 후에 복제본 서버 구성을 변경할 수 있습니다. 복제본이 마스터를 유지할 수 있도록 복제본 서버 구성을 원본과 같거나 더 큰 값으로 유지하는 것이 좋습니다.

원본 서버에 대한 복제본 나열

지정된 원본 서버에 대한 모든 복제본을 보려면 다음 명령을 실행합니다.

az mariadb server replica list --server-name mydemoserver --resource-group myresourcegroup

az mariadb server replica list 명령에는 다음과 같은 매개 변수가 필요합니다.

설정 예제 값 설명
resource-group  myresourcegroup  복제본 서버가 만들어지는 리소스 그룹입니다. 
서버 이름 mydemoserver 원본 서버의 이름 또는 ID입니다.

복제본 서버로의 복제 중지

Important

서버로의 복제는 중지하고 나면 취소할 수 없습니다. 원본과 복제본 사이의 복제가 중단된 경우, 중단을 취소할 수 없습니다. 복제를 중지하고 나면 복제본 서버는 독립 실행형 서버가 되어 읽기와 쓰기를 모두 지원합니다. 이 서버를 다시 복제본으로 설정할 수는 없습니다.

다음 명령을 사용하여 읽기 복제본 서버에 대한 복제를 중지할 수 있습니다.

az mariadb server replica stop --name mydemoreplicaserver --resource-group myresourcegroup

az mariadb server replica stop 명령에는 다음과 같은 매개 변수가 필요합니다.

설정 예제 값 설명
resource-group  myresourcegroup  복제본 서버가 있는 리소스 그룹입니다. 
name mydemoreplicaserver 복제를 중지할 복제본 서버의 이름입니다.

복제본 서버 삭제

읽기 복제본 서버 삭제는 az mariadb server delete 명령을 실행하여 수행할 수 있습니다.

az mariadb server delete --resource-group myresourcegroup --name mydemoreplicaserver

원본 서버 삭제

Important

원본 서버를 삭제하면 모든 복제본 서버에 대한 복제가 중지되며 원본 서버 자체도 삭제됩니다. 그러면 복제본 서버는 읽기와 쓰기를 모두 지원하는 독립 실행형 서버로 설정됩니다.

원본 서버를 삭제하려면 az mariadb server delete 명령을 실행하면 됩니다.

az mariadb server delete --resource-group myresourcegroup --name mydemoserver

REST API

Azure REST API를 사용하여 읽기 복제본을 생성하고 관리할 수 있습니다.

읽기 복제본 만들기

API 만들기를 사용하여 읽기 복제본을 만들 수 있습니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{replicaName}?api-version=2017-12-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}"
  }
}

참고 항목

복제본을 만들 수 있는 지역에 대해 자세히 알아보려면 읽기 복제본 개념 문서를 참조하세요.

범용 또는 메모리 최적화 원본 서버에서 azure.replication_support 매개 변수를 REPLICA로 설정하지 않은 경우 서버를 다시 시작하면 오류가 발생합니다. 복제본을 만들기 전에 이러한 두 단계를 완료합니다.

복제본은 마스터와 동일한 컴퓨팅 및 스토리지 설정을 사용하여 생성됩니다. 복제본을 만든 후에는 컴퓨팅 세대, vCores, 스토리지 및 백업 보존 기간 등 여러 설정을 원본 서버와 독립적으로 변경할 수 있습니다. 가격 책정도 기본 계층에서 다른 계층으로 또는 다른 계층에서 기본 계층으로 변경하는 경우를 제외하고 독립적으로 변경할 수 있습니다.

Important

원본 서버 설정을 새 값으로 업데이트하기 전에 복제본 설정을 같거나 더 큰 값으로 업데이트합니다. 이렇게 하면 복제본이 마스터에 대한 변경 내용을 유지할 수 있습니다.

복제본 목록

복제본 목록 API를 사용하여 원본 서버의 복제본 목록을 볼 수 있습니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}/Replicas?api-version=2017-12-01

복제본 서버로의 복제 중지

업데이트 API를 사용하여 원본 서버와 읽기 복제본 간의 복제를 중지할 수 있습니다.

원본 서버와 읽기 복제본에 대한 복제를 중지하면 실행 취소할 수 없습니다. 읽기 복제본은 읽기 및 쓰기를 둘 다 지원하는 독립 실행형 서버가 됩니다. 독립 실행형 서버를 다시 복제본으로 만들 수 없습니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}?api-version=2017-12-01

{
  "properties": {
    "replicationRole":"None"  
   }
}

원본 또는 복제본 서버 삭제

원본 또는 복제본 서버를 삭제하려면 API 삭제를 사용합니다.

원본 서버를 삭제하면 모든 읽기 복제본에 대한 복제가 중지됩니다. 그러면 읽기 복제본은 읽기와 쓰기를 모두 지원하는 독립 실행형 서버가 됩니다.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2017-12-01

다음 단계