읽기 복제본 만들기

콘솔

1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

   Cloud SQL 인스턴스로 이동

2. 복제본을 만들 인스턴스를 찾은 후 등록정보 옆에 있는 more actions 메뉴를 엽니다.
3. 읽기 복제본 만들기를 선택합니다.

   해당 선택 옵션이 표시되지 않으면 인스턴스가 복제본인 것입니다. 복제본의 복제본을 만들 수 없습니다.

4. 인스턴스의 백업 및 바이너리 로깅이 사용 설정된 경우 다음 단계를 진행합니다. 그렇지 않으면 백업 자동화 및 바이너리 로깅 사용 설정을 선택하고 계속을 클릭한 후 저장 및 다시 시작을 클릭하여 인스턴스를 다시 시작합니다.

   바이너리 로깅을 사용 설정하면 인스턴스가 다시 시작됩니다.

5. 페이지의 인스턴스 맞춤설정 섹션에서 복제본의 설정을 업데이트합니다. 구성 옵션 표시를 클릭하여 설정 그룹을 표시합니다. 그런 다음 원하는 그룹을 펼쳐 설정을 검토하고 맞춤설정합니다. 선택한 모든 옵션의 요약이 오른쪽에 표시됩니다. 이 설정을 맞춤설정하는 것은 선택사항입니다. 맞춤설정이 수행되지 않는 모든 경우에 기본값이 할당됩니다.

   각 설정에 대한 자세한 내용은 인스턴스 설정 정보 페이지를 참조하세요.

   예를 들어 BigQuery와 같은 다른 Google Cloud 서비스가 Cloud SQL의 데이터에 액세스하고 내부 연결을 통해 이 데이터에 대해 쿼리하도록 허용하려면 연결 그룹을 확장한 후 공개 IP 체크박스를 선택 해제합니다.

6. 복제본 만들기를 클릭합니다.

   Cloud SQL이 백업을 만들고, 필요한 경우 복제본을 만듭니다. 기본 인스턴스에 대한 인스턴스 페이지로 돌아갑니다.

gcloud

1. 기본 인스턴스의 상태를 확인합니다.

   gcloud sql instances describe PRIMARY_INSTANCE_NAME
         

   databaseReplicationEnabled 속성이 true인 경우 인스턴스는 복제본입니다. 복제본의 복제본은 만들 수 없습니다.

2. backupConfiguration 아래의 enabled 속성이 false이면 기본 인스턴스에 백업을 사용 설정합니다.

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --backup-start-time=>HH:MM
         

   backup-start-time 파라미터는 UTC±00 시간대의 24시간 형식으로 지정되며 백업 기간(4시간)의 시작 시간을 지정합니다. 백업 기간에는 언제든지 백업이 시작될 수 있습니다.
3. binaryLogEnabled 속성이 false이면 기본 인스턴스에 바이너리 로그를 사용 설정합니다.

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --enable-bin-log

   바이너리 로그를 사용 설정하면 인스턴스가 다시 시작됩니다.
4. 복제본을 만듭니다.

   gcloud sql instances create REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME

   필요한 경우 --tier 매개변수를 사용하여 다른 등급 크기를 지정할 수 있습니다. MySQL 8.4 이상용 기본 인스턴스에서 복제본을 만들고 인스턴스의 Cloud SQL 버전이 Enterprise 또는 Enterprise Plus인 경우 이 파라미터의 값을 지정할 필요가 없습니다. 복제본은 기본 인스턴스에서 머신 유형을 상속합니다.

   --region 매개변수를 사용하여 다른 리전을 지정할 수 있습니다.

   다른 인스턴스 설정에 매개변수를 더 추가할 수 있습니다. 자세한 내용은 gcloud sql instances create를 참조하세요.

   기본 인스턴스에 내부 IP 주소만 포함되었고 BigQuery와 같은 다른 Google Cloud 서비스가 Cloud SQL의 데이터에 액세스하고 내부 연결을 통해 이 데이터에 대해 쿼리하도록 허용하려면 명령어에 --enable-google-private-path 매개변수를 추가합니다.

   복제본은 기본 인스턴스와 동일한 VPC 네트워크에 만들어야 합니다. 또한 해당 VPC 네트워크에 allocated-ip-range-name을 지정할 수 있습니다. 범위가 지정되지 않으면 복제본이 무작위 범위로 생성됩니다.

• 바이너리 로깅은 읽기 복제본 인스턴스에서 지원됩니다(MySQL 5.7 이상만 해당). 기존 HA 장애 조치 복제본에서는 지원되지 않음). 기본 인스턴스 이름 대신 복제본의 인스턴스 이름을 사용하여 동일한 gcloud CLI 명령어로 복제본에 바이너리 로깅을 사용 설정합니다.

  gcloud sql instances patch REPLICA_INSTANCE_NAME \
  --enable-bin-log
      

  복제본 인스턴스(기본 인스턴스 아님)의 바이너리 로깅 내구성은 MySQL 서버가 바이너리 로그를 디스크에 동기화하는 빈도를 관리하는 sync_binlog 플래그를 사용하여 설정할 수 있습니다.

  복제본 인스턴스에서 백업을 사용 설정할 수 없지만 기본 인스턴스와 달리 백업을 사용하지 않는 경우에도 복제본에서 바이너리 로깅을 사용 설정할 수 있습니다.

  복제본 인스턴스의 binlog 보관 기간은 기본 인스턴스의 7일과 달리 1일로 자동 설정됩니다.

Terraform

읽기 복제본을 만들려면 Terraform 리소스를 사용합니다.

resource "google_sql_database_instance" "read_replica" {
  name                 = "mysql-replica-instance-name"
  master_instance_name = google_sql_database_instance.primary.name
  region               = "europe-west4"
  database_version     = "MYSQL_8_0"

  replica_configuration {
    failover_target = false
  }

  settings {
    tier              = "db-n1-standard-2"
    availability_type = "ZONAL"
    disk_size         = "100"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

변경사항 적용

Google Cloud 프로젝트에 Terraform 구성을 적용하려면 다음 섹션의 단계를 완료하세요.

Cloud Shell 준비

1. Cloud Shell을 실행합니다.

2. Terraform 구성을 적용할 기본 Google Cloud 프로젝트를 설정합니다.

   이 명령어는 프로젝트당 한 번만 실행하면 되며 어떤 디렉터리에서도 실행할 수 있습니다.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Terraform 구성 파일에서 명시적 값을 설정하면 환경 변수가 재정의됩니다.

디렉터리 준비

각 Terraform 구성 파일에는 자체 디렉터리(루트 모듈이라고도 함)가 있어야 합니다.

1. Cloud Shell에서 디렉터리를 만들고 해당 디렉터리 내에 새 파일을 만드세요. 파일 이름에는 .tf 확장자가 있어야 합니다(예: main.tf). 이 튜토리얼에서는 파일을 main.tf라고 합니다.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 튜토리얼을 따라 하는 경우 각 섹션이나 단계에서 샘플 코드를 복사할 수 있습니다.

   샘플 코드를 새로 만든 main.tf에 복사합니다.

   필요한 경우 GitHub에서 코드를 복사합니다. 이는 Terraform 스니펫이 엔드 투 엔드 솔루션의 일부인 경우에 권장됩니다.

3. 환경에 적용할 샘플 매개변수를 검토하고 수정합니다.
4. 변경사항을 저장합니다.
5. Terraform을 초기화합니다. 이 작업은 디렉터리당 한 번만 수행하면 됩니다.

   terraform init

   원하는 경우 최신 Google 공급업체 버전을 사용하려면 -upgrade 옵션을 포함합니다.

   terraform init -upgrade

변경사항 적용

1. 구성을 검토하고 Terraform에서 만들거나 업데이트할 리소스가 예상과 일치하는지 확인합니다.

   terraform plan

   필요에 따라 구성을 수정합니다.

2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 Terraform 구성을 적용합니다.

   terraform apply

   Terraform에 '적용 완료' 메시지가 표시될 때까지 기다립니다.

3. 결과를 보려면 Google Cloud 프로젝트를 엽니다. Google Cloud 콘솔에서 UI의 리소스로 이동하여 Terraform이 리소스를 만들었거나 업데이트했는지 확인합니다.

변경사항 삭제

변경사항을 삭제하려면 다음 단계를 따르세요.

1. Terraform 구성 파일에서 삭제 보호를 사용 중지하려면 deletion_protection 인수를 false로 설정합니다.

   deletion_protection =  "false"

2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 업데이트된 Terraform 구성을 적용합니다.

   terraform apply

3. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 이전에 Terraform 구성에 적용된 리소스를 삭제합니다.

   terraform destroy

REST v1

1. 현재 백업 구성 확인

   인스턴스 리소스의 get 메서드를 사용하여 데이터베이스 버전과 기본 인스턴스의 현재 백업 구성을 반환합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • project-id: 프로젝트 ID
   • primary-instance-name: 기본 인스턴스 이름

   HTTP 메서드 및 URL:

   GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   다음 명령어를 실행합니다.

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name"

   PowerShell(Windows)

   다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name" | Select-Object -Expand Content

   다음과 비슷한 JSON 응답이 표시됩니다.

   응답

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": false,
       "binaryLogEnabled": false
   }
   

2. 복제 필드가 설정되었는지 확인

   enabled 또는 pointInTimeEnabled가 false이면 인스턴스 리소스의 patch 메서드를 사용하여 둘 다 사용 설정합니다. 요청에서 변경하려는 백업 구성의 모든 속성을 지정합니다.

   백업을 사용 설정하려면 enabled를 true로, startTime을 HH:MM 형식의 시간으로 설정합니다. startTime 매개변수는 UTC±00 시간대의 24시간 형식으로 지정되며 백업 기간(4시간)의 시작 시간을 지정합니다. 백업 기간에는 언제든지 백업이 시작될 수 있습니다.

   point-in-time recovery를 사용 설정하려면 pointInTimeEnabled를 true로 설정합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
   • INSTANCE_NAME: 고가용성으로 구성하려는 기본 또는 읽기 복제본 인스턴스의 이름
   • START_TIME: 시간(시간 및 분)

   HTTP 메서드 및 URL:

   PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

   JSON 요청 본문:

   {
     "settings":
     {
       "backupConfiguration":
       {
         "startTime": "START_TIME",
         "enabled": true,
         "binaryLogEnabled": true
       }
     }
   }
   

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell(Windows)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   다음과 비슷한 JSON 응답이 표시됩니다.

   응답

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

3. 읽기 복제본 만들기

   인스턴스 리소스의 insert 메서드를 사용하여 읽기 복제본을 만듭니다. databaseVersion 속성은 기본 인스턴스와 동일해야 합니다. 기본 인스턴스에서 내부 IP 주소를 사용하는 경우 기본 인스턴스를 만들 때와 동일한 방식으로 allocatedIpRange를 지정할 수 있습니다. 범위가 지정되지 않으면 복제본이 무작위 범위로 생성됩니다. 리전 간 읽기 복제본의 경우 기본 인스턴스의 리전이 아닌 다른 리전을 지정합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • project-id: 프로젝트 ID
   • database-version: Enum 버전 문자열(예: MYSQL_8_0)
   • primary-instance-name: 기본 인스턴스 이름
   • primary-instance-region: 기본 인스턴스의 리전
   • replica-region: 복제본 인스턴스의 리전
   • replica-name: 복제본 인스턴스의 이름
   • machine-type: 머신 유형의 열거형 문자열 (예: 'db-custom-1-3840')
   • private-network: 비공개 연결을 만들기 위해 추가하거나 선택하는 네트워크

   HTTP 메서드 및 URL:

   POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

   JSON 요청 본문:

   {
     "masterInstanceName": "primary-instance-name",
     "project": "project-id",
     "databaseVersion": "database-version",
     "name": "replica-name",
     "region": "replica-region",
     "settings":
     {
       "tier": "machine-type",
       "settingsVersion": 0,
       "ipConfiguration": {
       object (IpConfiguration)
     },
     {
     "ipv4Enabled": false,
     "privateNetwork": private-network,
     "requireSsl": boolean,
     "authorizedNetworks": [
       {
         object (AclEntry)
       }
     ],
     "allocatedIpRange": string
       }
     }
   }
   

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances"

   PowerShell(Windows)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances" | Select-Object -Expand Content

   다음과 비슷한 JSON 응답이 표시됩니다.

   응답

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE_REPLICA",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

REST v1beta4

1. 현재 백업 구성 확인

   인스턴스 리소스의 get 메서드를 사용하여 데이터베이스 버전과 마스터의 현재 백업 구성을 반환합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • project-id: 프로젝트 ID
   • primary-instance-name: 기본 인스턴스 이름

   HTTP 메서드 및 URL:

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   다음 명령어를 실행합니다.

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name"

   PowerShell(Windows)

   다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name" | Select-Object -Expand Content

   다음과 비슷한 JSON 응답이 표시됩니다.

   응답

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": false,
       "binaryLogEnabled": false
   }
   

2. 복제 필드가 설정되었는지 확인

   기본 인스턴스에서 enabled 또는 binaryLogEnabled가 false이면 인스턴스 리소스의 patch 메서드를 사용하여 둘 다 사용 설정합니다. 요청에서 변경하려는 백업 구성의 속성을 지정합니다.

   백업을 사용 설정하려면 enabled를 true로, startTime을 HH:MM 형식의 시간으로 설정합니다. startTime 매개변수는 UTC±00 시간대의 24시간 형식으로 지정되며 백업 기간(4시간)의 시작 시간을 지정합니다. 백업 기간에는 언제든지 백업이 시작될 수 있습니다.

   point-in-time recovery를 사용 설정하려면 기본 인스턴스에서 binaryLogEnabled를 true로 설정합니다.

   바이너리 로깅은 읽기 복제본 인스턴스에서 지원됩니다(MySQL 5.7 이상만 해당). 기본 인스턴스 ID 대신 복제본의 인스턴스 ID를 사용하여 동일한 API로 복제본에 바이너리 로깅을 사용 설정합니다.

   복제본 인스턴스(기본 인스턴스 아님)의 바이너리 로깅 내구성은 MySQL 서버가 바이너리 로그를 디스크에 동기화하는 빈도를 관리하는 sync_binlog 플래그를 사용하여 설정할 수 있습니다.

   복제본 인스턴스에서 백업을 사용 설정할 수 없지만 기본 인스턴스와 달리 백업을 사용하지 않는 경우에도 복제본에서 바이너리 로깅을 사용 설정할 수 있습니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
   • INSTANCE_NAME: 고가용성으로 구성하려는 기본 또는 읽기 복제본 인스턴스의 이름
   • START_TIME: 시간(시간 및 분)

   HTTP 메서드 및 URL:

   PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   JSON 요청 본문:

   {
     "settings":
     {
       "backupConfiguration":
       {
         "startTime": "START_TIME",
         "enabled": true,
         "binaryLogEnabled": true
       }
     }
   }
   

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell(Windows)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   다음과 비슷한 JSON 응답이 표시됩니다.

   응답

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

3. 읽기 복제본 만들기

   인스턴스 리소스의 insert 메서드를 사용하여 읽기 복제본을 만듭니다. databaseVersion 속성은 기본 인스턴스와 동일해야 합니다. 기본 인스턴스에서 내부 IP 주소를 사용하는 경우 기본 인스턴스를 만들 때와 동일한 방식으로 allocatedIpRange를 지정할 수 있습니다. 리전 간 읽기 복제본의 경우 기본 인스턴스의 리전이 아닌 다른 리전을 지정합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • project-id: 프로젝트 ID
   • database-version: Enum 버전 문자열(예: MYSQL_8_0)
   • primary-instance-name: 기본 인스턴스 이름
   • primary-instance-region: 기본 인스턴스의 리전
   • replica-region: 복제본 인스턴스의 리전
   • replica-name: 복제본 인스턴스의 이름
   • machine-type: 머신 유형의 열거형 문자열 (예: 'db-custom-1-3840')
   • private-network: 비공개 연결을 만들기 위해 추가하거나 선택하는 네트워크

   HTTP 메서드 및 URL:

   POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

   JSON 요청 본문:

   {
     "masterInstanceName": "primary-instance-name",
     "project": "project-id",
     "databaseVersion": "database-version",
     "name": "replica-name",
     "region": "replica-region",
     "settings":
     {
       "tier": "machine-type",
       "settingsVersion": 0,
       
       "ipConfiguration": {
       object (IpConfiguration)
     },
     {
     "ipv4Enabled": false,
     "privateNetwork": private-network,
     "requireSsl": boolean,
     "authorizedNetworks": [
       {
         object (AclEntry)
       }
     ],
     "allocatedIpRange": string
       }
       
     }
   }
   

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances"

   PowerShell(Windows)

   요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

   다음과 비슷한 JSON 응답이 표시됩니다.

   응답

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE_REPLICA",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

gcloud

인스턴스의 읽기 복제본을 만들려면 gcloud sql instances create 명령어를 사용합니다.

gcloud sql instances create REPLICA_INSTANCE_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip

다음을 바꿉니다.

• REPLICA_INSTANCE_NAME: 복제본 인스턴스의 이름입니다.
• PRIMARY_INSTANCE_NAME: 기본 인스턴스 이름입니다.
• PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호입니다.
• REGION_NAME: 복제본 인스턴스의 리전 이름입니다.

• ALLOWED_PROJECTS: 허용되는 프로젝트 ID 또는 숫자의 목록(쉼표로 구분). 프로젝트가 이 목록에 포함되지 않은 경우 이를 사용하여 인스턴스를 만들고 Private Service Connect를 사용 설정할 수 없습니다.

  Cloud SQL은 기본 인스턴스에 허용되는 프로젝트를 복제본으로 복사하지 않습니다. 복제본마다 Private Service Connect 엔드포인트를 만들어야 합니다. Cloud SQL 인증 프록시 또는 Cloud SQL 언어 커넥터를 사용하는 경우 복제본에 DNS 영역과 DNS 레코드를 만들어야 합니다.

• AVAILABILITY_TYPE: 인스턴스에 고가용성을 사용 설정합니다. 이 매개변수에 대해 다음 값 중 하나를 지정합니다.
  • REGIONAL: 고가용성을 사용 설정하며, 프로덕션 인스턴스에 권장됩니다. 인스턴스는 선택한 리전 내의 다른 영역으로 장애 조치됩니다.
  • ZONAL: 장애 조치 기능을 제공하지 않습니다. 이 설정이 기본 설정입니다.

  인스턴스의 고가용성 설정 및 삭제에 대한 자세한 내용은 기존 인스턴스를 고가용성으로 구성 및 인스턴스의 고가용성 비활성화를 참조하세요.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PRIMARY_INSTANCE_NAME: 기본 인스턴스 이름입니다.
• PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호입니다.
• REPLICA_INSTANCE_NAME: 복제본 인스턴스의 이름입니다.
• REGION_NAME: 복제본 인스턴스의 리전 이름입니다.
• MACHINE_TYPE: 인스턴스의 머신 유형입니다.
• AVAILABILITY_TYPE: 인스턴스에 고가용성을 사용 설정합니다. 이 매개변수에 대해 다음 값 중 하나를 지정합니다.
  • REGIONAL: 고가용성을 사용 설정하며, 프로덕션 인스턴스에 권장됩니다. 인스턴스는 선택한 리전 내의 다른 영역으로 장애 조치됩니다.
  • ZONAL: 장애 조치 기능을 제공하지 않습니다. 이 설정이 기본 설정입니다.

  인스턴스의 고가용성 설정 및 삭제에 대한 자세한 내용은 기존 인스턴스를 고가용성으로 구성 및 인스턴스의 고가용성 비활성화를 참조하세요.

• ALLOWED_PROJECTS: 허용되는 프로젝트 ID 또는 숫자의 목록(쉼표로 구분). 프로젝트가 이 목록에 포함되지 않은 경우 이를 사용하여 인스턴스를 만들고 Private Service Connect를 사용 설정할 수 없습니다.

  Cloud SQL은 기본 인스턴스에 허용되는 프로젝트를 복제본으로 복사하지 않습니다. 복제본마다 Private Service Connect 엔드포인트를 만들어야 합니다. Cloud SQL 인증 프록시 또는 Cloud SQL 언어 커넥터를 사용하는 경우 복제본에 DNS 영역과 DNS 레코드를 만들어야 합니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PRIMARY_INSTANCE_NAME: 기본 인스턴스 이름입니다.
• PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호입니다.
• REPLICA_INSTANCE_NAME: 복제본 인스턴스의 이름입니다.
• REGION_NAME: 복제본 인스턴스의 리전 이름입니다.
• MACHINE_TYPE: 인스턴스의 머신 유형입니다.
• AVAILABILITY_TYPE: 인스턴스에 고가용성을 사용 설정합니다. 이 매개변수에 대해 다음 값 중 하나를 지정합니다.
  • REGIONAL: 고가용성을 사용 설정하며, 프로덕션 인스턴스에 권장됩니다. 인스턴스는 선택한 리전 내의 다른 영역으로 장애 조치됩니다.
  • ZONAL: 장애 조치 기능을 제공하지 않습니다. 이 설정이 기본 설정입니다.

  인스턴스의 고가용성 설정 및 삭제에 대한 자세한 내용은 기존 인스턴스를 고가용성으로 구성 및 인스턴스의 고가용성 비활성화를 참조하세요.

• ALLOWED_PROJECTS: 허용되는 프로젝트 ID 또는 숫자의 목록(쉼표로 구분). 프로젝트가 이 목록에 포함되지 않은 경우 이를 사용하여 인스턴스를 만들고 Private Service Connect를 사용 설정할 수 없습니다.

  Cloud SQL은 기본 인스턴스에 허용되는 프로젝트를 복제본으로 복사하지 않습니다. 복제본마다 Private Service Connect 엔드포인트를 만들어야 합니다. Cloud SQL 인증 프록시 또는 Cloud SQL 언어 커넥터를 사용하는 경우 복제본에 DNS 영역과 DNS 레코드를 만들어야 합니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],  
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

콘솔

1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

   Cloud SQL 인스턴스로 이동

2. MySQL 5.7 이상인 경우 복제를 사용 설정합니다.
3. 만들려는 복제본의 상위 역할을 수행할 복제본의 복제본 탭을 클릭합니다.
4. 복제본 만들기를 클릭합니다.
5. 읽기 복제본 만들기 페이지에서 인스턴스 ID를 비롯해 이름, 리전, 영역 등의 기타 구성 옵션을 업데이트합니다.
6. 만들기를 클릭합니다.

   Cloud SQL은 복제본을 만듭니다. 상위 복제본의 인스턴스 페이지가 다시 표시됩니다.

7. 만들려는 새 연쇄 복제본마다 4~6단계를 수행합니다.

gcloud

1. MySQL 버전 5.7 이상을 사용하는 경우 새 복제본의 기본 인스턴스에 대해 binlog를 사용 설정합니다.
   

   gcloud sql instances patch --enable-bin-log PARENT_REPLICA_NAME

   PARENT_REPLICA_NAME을 상위 복제본의 이름으로 바꿉니다.
2. --master-instance-name 플래그를 사용하여 기본 복제본을 기본 인스턴스로 지정해 새 복제본을 생성합니다.

gcloud sql instances create REPLICA_NAME \
      --master-instance-name=PARENT_REPLICA_NAME \

다음을 바꿉니다.

• REPLICA_NAME: 만들려는 복제본의 고유 ID
• PARENT_REPLICA_NAME: 상위 복제본의 이름
3. 연쇄 복제본을 만든 후 기본 인스턴스에 수행된 변경사항이 연쇄 복제 체인에 있는 모든 복제본에 복제되었는지 확인할 수 있습니다.

curl

1. MySQL 버전 5.7 이상을 사용하는 경우 바이너리 로깅을 사용 설정합니다.
   
   바이너리 로깅을 사용 설정하려면 request.JSON이라는 파일에 다음 JSON을 저장한 다음 curl 명령어를 호출하여 바이너리 로깅을 사용 설정합니다.
   

   {
     "settings":
     {
       "backupConfiguration":
       {
         "enabled": false,
         "binaryLogEnabled": true
       }
     }
   }

2. 상위 복제본 아래에 복제본을 만들려면 다음 JSON 코드 샘플을 수정하고 request.json 파일에 저장합니다.

   {
     "masterInstanceName": "PARENT_REPLICA_NAME",
     "project": "PROJECT_ID",
     "name": "REPLICA_NAME",
     "region": "REPLICA_REGION",
     "settings":
       {
         "tier": "MACHINE_TYPE",
       }
   }

3. 다음 명령어를 실행합니다.

   curl -X POST
   -H "Authorization: Bearer "$(gcloud auth print-access-token)
   -H "Content-Type: application/json; charset=utf-8"
   -d @request.json
   "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"