point-in-time recovery(PITR) 사용

이 페이지에서는 PITR(point-in-time recovery)을 사용하여 기본 Cloud SQL 인스턴스를 복원하는 방법을 설명합니다.

PITR에 대한 자세한 내용은 PITR을 참조하세요.

PITR의 로그 스토리지

PITR은 트랜잭션 로그를 사용합니다. 이 로그는 정기적으로 업데이트되고 저장공간을 사용합니다. 트랜잭션 로그는 일반적으로 약 7일 후에 관련된 자동 백업과 함께 자동으로 삭제됩니다.

트랜잭션 로그 크기가 인스턴스에 문제를 일으키는 경우 다음 안내를 따르세요.

  • 인스턴스 스토리지 크기를 늘리면 됩니다. 하지만 트랜잭션 로그 크기에 따른 디스크 사용량 증가가 일시적인 것일 수도 있습니다.

  • 예기치 않은 스토리지 문제를 막으려면 스토리지 용량 자동 증가를 사용 설정하는 것이 좋습니다.

  • 로그를 삭제하고 스토리지를 복구하려면 PITR을 사용 중지하면 됩니다. 사용되는 스토리지를 줄여도 인스턴스에 프로비저닝된 스토리지 크기는 줄어들지 않습니다.

  • 로그는 매일 한 번씩 영구 삭제되며, 지속적으로 진행되지 않습니다. 로그 보관 기간을 2일로 설정하면 최소 2일 동안의 로그 및 최대 3일 동안의 로그가 보관됩니다. 지정된 최소 로그 보관 일수를 보장하려면 백업 수를 로그 보존 일수보다 2 이상으로 설정하는 것이 좋습니다.

PITR의 데이터베이스 복구 모델

인스턴스에서 PITR을 사용 설정하면 Cloud SQL에서 자동으로 기존 및 후속 데이터베이스의 복구 모델을 전체 복구 모델로 설정합니다.

SQL Server 복구 모델에 대한 자세한 내용은 Microsoft 문서를 참조하세요.

PITR 사용 설정

Google Cloud 콘솔에서 새 인스턴스를 만들면 자동 백업 설정이 자동으로 사용 설정됩니다.

다음 절차는 기존 인스턴스에서 PITR을 사용 설정합니다.

Console

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

    Cloud SQL 인스턴스로 이동

  2. PITR을 사용 설정할 인스턴스의 추가 작업 메뉴(추가 작업 아이콘)를 열고 수정을 클릭합니다.
  3. 인스턴스 맞춤설정에서 데이터 보호 섹션을 펼칩니다.
  4. point-in-time recovery 사용 설정 체크박스를 선택합니다.
  5. 고급 옵션을 펼칩니다.
  6. 로그를 보관할 일수(1~7)를 입력합니다.
  7. 저장을 클릭합니다.

gcloud

  1. 인스턴스 개요를 표시합니다. 
    gcloud sql instances describe INSTANCE_NAME
  2. backupConfiguration 섹션에 enabled: false가 표시되면 예약된 백업을 사용 설정합니다. 
    gcloud sql instances patch INSTANCE_NAME \
--backup-start-time=HH:MM

    UTC±00 시간대의 24시간제를 사용하여 backup-start-time 매개변수를 지정합니다.

  3. PITR을 사용 설정합니다. 
    gcloud sql instances patch INSTANCE_NAME \
--enable-point-in-time-recovery

    기본 인스턴스에서 PITR을 사용 설정하면 다음 매개변수를 추가하여 트랜잭션 로그 보관 일수를 구성할 수도 있습니다.

    --retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS
  4. 변경사항을 확인합니다. 
    gcloud sql instances describe INSTANCE_NAME

    변경이 성공하면 backupConfiguration 섹션에 pointInTimeRecoveryEnabled: true가 표시됩니다.

REST v1

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

  • 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,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

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

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

REST v1beta4

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

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

HTTP 메서드 및 URL: 

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

JSON 요청 본문:

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

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

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

PITR 수행

Console

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

    Cloud SQL 인스턴스로 이동

  2. 복구할 인스턴스의 추가 작업 메뉴(추가 작업 아이콘)를 열고 클론 만들기를 클릭합니다.
  3. 필요한 경우 클론 만들기 페이지에서 새 클론의 ID를 업데이트합니다.
  4. 이전 시점에서 클론을 선택합니다.
  5. PITR 시간을 입력합니다.
  6. 모든 데이터베이스를 선택하거나 데이터베이스 이름을 지정합니다.
    데이터베이스 이름을 지정하면 하나만 선택할 수 있습니다. 기본적으로 PITR은 모든 데이터베이스에서 사용됩니다.
  7. 클론 만들기를 클릭합니다.

gcloud

PITR을 사용하여 클론을 만듭니다.

다음을 바꿉니다.

  • SOURCE_INSTANCE_NAME - 복원할 인스턴스의 이름입니다.
  • NEW_INSTANCE_NAME - 클론 이름입니다.
  • TIMESTAMP - RFC 3339 형식의 소스 인스턴스 UTC 시간대입니다. 예를 들면 2012-11-15T16:19:00.094Z입니다.
gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time 'TIMESTAMP'

REST v1

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

  • project-id: 프로젝트 ID
  • target-instance-id: 대상 인스턴스 ID
  • source-instance-id: 소스 인스턴스 ID
  • restore-timestamp 복원할 특정 시점

JSON 요청에서 최대 1개의 특정 데이터베이스 이름을 "databaseNames": "my-database"로 지정할 수 있습니다.

HTTP 메서드 및 URL: 

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

JSON 요청 본문:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

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

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

REST v1beta4

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

  • project-id: 프로젝트 ID
  • target-instance-id: 대상 인스턴스 ID
  • source-instance-id: 소스 인스턴스 ID
  • restore-timestamp 복원할 특정 시점

JSON 요청에서 최대 1개의 특정 데이터베이스 이름을 "databaseNames": "my-database"로 지정할 수 있습니다.

HTTP 메서드 및 URL: 

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

JSON 요청 본문:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

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

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

PITR 사용 중지

Console

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

    Cloud SQL 인스턴스로 이동

  2. 중지할 인스턴스의 추가 작업 메뉴 추가 작업 아이콘를 열고 수정을 선택합니다.
  3. 인스턴스 맞춤설정에서 데이터 보호 섹션을 펼칩니다.
  4. point-in-time recovery 사용 설정을 선택 해제합니다.
  5. 저장을 클릭합니다.
  6. 인스턴스의 개요 페이지에 있는 구성에 PITR 설정이 중지됨으로 표시됩니다.

gcloud

  1. point-in-time recovery를 사용 중지합니다.
    gcloud sql instances patch INSTANCE_NAME \
--no-enable-point-in-time-recovery
  2. 변경사항을 확인합니다. 
    gcloud sql instances describe INSTANCE_NAME

    변경이 성공하면 backupConfiguration 섹션에 pointInTimeRecoveryEnabled: false가 표시됩니다.

REST v1

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

  • project-id: 프로젝트 ID
  • instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

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

REST v1beta4

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

  • project-id: 프로젝트 ID
  • instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

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

PITR에 사용되는 트랜잭션 로그의 스토리지 위치 확인

Cloud SQL 인스턴스가 PITR에 사용되는 트랜잭션 로그를 저장하는 위치를 확인할 수 있습니다.

gcloud

인스턴스가 PITR 로그를 디스크 또는 Cloud Storage에 저장하는지 확인하려면 다음 명령어를 사용합니다.

   gcloud sql instances describe INSTANCE_NAME

INSTANCE_NAME을 인스턴스 이름으로 바꿉니다.

명령어 출력의 transactionalLogStorageState 필드는 PITR의 트랜잭션 로그가 인스턴스에 대해 저장되는 위치에 대한 정보를 제공합니다.

반환된 트랜잭션 로그 스토리지 위치는 DISK입니다. SQL Server 인스턴스는 PITR에 사용된 트랜잭션 로그를 디스크에만 저장할 수 있습니다.

트랜잭션 로그 보관 설정

트랜잭션 로그를 보관할 일수를 설정하려면 다음 안내를 따르세요.

콘솔

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

    Cloud SQL 인스턴스로 이동

  2. 트랜잭션 로그를 설정할 인스턴스의 추가 작업 메뉴 추가 작업 아이콘를 열고 수정을 선택합니다.
  3. 인스턴스 맞춤설정에서 데이터 보호 섹션을 펼칩니다.
  4. point-in-time recovery 사용 설정 섹션에서 고급 옵션을 확장합니다.
  5. 로그를 보관할 일수(1~7)를 입력합니다.
  6. 저장을 클릭합니다.

gcloud

인스턴스를 수정하여 트랜잭션 로그를 보관할 일수를 설정합니다.

다음을 바꿉니다.

  • INSTANCE-NAME - 트랜잭션 로그를 설정할 인스턴스의 이름입니다.
  • DAYS-TO-RETAIN - 트랜잭션 로그 보관 일수입니다. 유효 범위는 1~7입니다. 지정하지 않으면 기본값은 7입니다. point-in-time recovery가 사용 설정된 경우에만 유효합니다. 트랜잭션 로그 보관 일수를 올리려면 더 큰 스토리지 크기가 필요합니다.

  gcloud sql instances patch INSTANCE-NAME \
    --retained-transaction-log-days=DAYS-TO-RETAIN

REST v1

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

  • days-to-retain: 트랜잭션 로그를 보관할 일수(1~7일)
  • project-id: 프로젝트 ID
  • instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "days-to-retain"
    }
  }
}

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

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

REST v1beta4

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

  • days-to-retain: 트랜잭션 로그를 보관할 일수(1~7일)
  • project-id: 프로젝트 ID
  • instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "days-to-retain"
    }
  }
}

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

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

다음 단계