사용자 인터페이스를 통한 백업 / 복원

외부 버킷으로의 자동 백업은 24시간마다 “전체” 백업으로 실행되도록 구성되어 있으며, 실행 주기는 변경할 수 없습니다.

AWS

AWS에 백업하기

1. AWS에서 수행할 단계

이 단계는 “S3 데이터에 안전하게 액세스하기”에 설명된 보안 S3 설정과 유사하지만, 역할 권한에는 추가로 설정해야 할 항목이 있습니다.

아래 단계를 AWS 계정에서 수행하십시오:

AWS S3 버킷 생성

백업을 내보낼 AWS S3 버킷을 계정에 생성합니다.

IAM 역할 생성

AWS는 역할 기반 인증(authentication)을 사용하므로, ClickHouse Cloud 서비스가 이 버킷에 쓰기 작업을 수행할 수 있도록 Assume할 수 있는 IAM 역할을 생성합니다.

a. ClickHouse Cloud 서비스 설정 페이지의 Network security information에서 ARN을 확인합니다. 형식은 다음과 비슷합니다:

b. 이 역할에 대해 다음과 같이 신뢰 정책을 생성합니다:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "backup service",
      "Effect": "Allow",
      "Principal": {
        "AWS":  "arn:aws:iam::463754717262:role/CH-S3-bordeaux-ar-90-ue2-29-Role"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

역할 권한 업데이트

이 ClickHouse Cloud 서비스가 S3 버킷에 쓸 수 있도록 이 역할의 권한도 설정해야 합니다. 이를 위해 역할에 대한 권한 정책을 아래와 유사한 JSON으로 생성하고, 두 위치의 Resource에 사용자 버킷의 ARN을 입력합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "s3:GetBucketLocation",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::byob-ui"
      ],
      "Effect": "Allow"
    },
    {
      "Action": [
        "s3:Get*",
        "s3:List*",
        "s3:PutObject"
      ],
      "Resource": [
        "arn:aws:s3:::byob-ui/*"
      ],
      "Effect": "Allow"
    },
    {
      "Action": [
        "s3:DeleteObject"
      ],
      "Resource": [
        "arn:aws:s3:::byob-ui/*/.lock"
      ],
      "Effect": "Allow"
    }
  ]
}

2. ClickHouse Cloud에서 수행할 단계

외부 버킷을 구성하려면 아래 단계를 ClickHouse Cloud Console에서 수행하십시오.

외부 백업 변경

설정 페이지에서 “Set up external backup”을 클릭하십시오.

AWS IAM Role ARN 및 S3 버킷 세부 정보 구성

다음 화면에서 방금 생성한 AWS IAM Role ARN과 다음 형식의 S3 버킷 URL을 입력하십시오.

변경 사항 저장

설정을 저장하려면 “Save External Bucket”을 클릭하십시오.

기본 일정에서 백업 일정 변경

이제 외부 백업은 기본 일정에 따라 사용자의 버킷에 저장됩니다. 또는 “설정” 페이지에서 백업 일정을 구성할 수 있습니다. 다르게 구성한 경우에는 사용자 지정 일정이 사용자의 버킷에 백업을 저장하는 데 사용되며, 기본 일정(24시간마다 백업)은 ClickHouse Cloud 소유 버킷의 백업에 사용됩니다.

버킷에 저장된 백업 보기

아래와 같이 Backups 페이지에 사용자의 버킷에 있는 백업이 별도의 테이블로 표시됩니다.

AWS에서 백업 복원하기

아래 단계에 따라 AWS에서 백업을 복원하십시오.

복원할 새 서비스 만들기

백업을 복원할 새 서비스를 만드십시오.

서비스 ARN 추가

새로 생성한 서비스의 ARN을 IAM 역할의 신뢰 정책에 추가하십시오(ClickHouse Cloud Console의 서비스 설정 페이지에서 확인 가능). 이는 위 AWS 단계 섹션의 두 번째 단계와 동일합니다. 새 서비스가 S3 버킷에 액세스할 수 있도록 하려면 이 작업이 필요합니다.

백업 복원에 사용할 SQL 명령 가져오기

UI의 백업 목록 위에 있는 “access or restore a backup” 링크를 클릭하여 백업을 복원하는 SQL 명령을 확인하십시오. 명령은 다음과 같은 형태입니다.

백업을 다른 위치로 이동하는 경우백업을 다른 위치로 옮기면 새 위치를 참조하도록 복원 명령을 사용자 지정해야 합니다.

ASYNC 명령복원 명령의 경우 대용량 복원을 위해 끝에 ASYNC 명령을 선택적으로 추가할 수도 있습니다. 이렇게 하면 복원이 비동기적으로 수행되므로 연결이 끊겨도 복원이 계속 실행됩니다. 중요한 점은 ASYNC 명령이 즉시 성공 상태를 반환한다는 것입니다. 하지만 이것이 복원이 성공했다는 뜻은 아닙니다. 복원이 완료되었는지, 그리고 성공했는지 실패했는지 확인하려면 system.backups 테이블을 모니터링해야 합니다.

복원 명령 실행

새로 생성한 서비스의 SQL 콘솔에서 복원 명령을 실행하여 백업을 복원하십시오.

GCP

GCP에 백업 생성하기

아래 단계에 따라 GCP에 백업을 생성하십시오:

GCP에서 따라야 할 단계

GCP 스토리지 버킷 생성

백업을 내보내기 위해 GCP 계정에 스토리지 버킷을 생성하십시오.

HMAC 키 및 시크릿 생성

비밀번호 기반 인증에 필요한 HMAC 키 및 시크릿을 생성하십시오. 키를 생성하려면 아래 단계를 따르십시오.

a. 서비스 계정 만들기
- I. Google Cloud Console의 IAM & Admin 섹션으로 이동한 다음 Service Accounts를 선택하십시오.
- II. Create Service Account를 클릭하고 이름과 ID를 입력하십시오. Create and Continue를 클릭하십시오.
- III. 이 서비스 계정에 Storage Object User 역할을 부여하십시오.
- IV. Done을 클릭하여 서비스 계정 생성을 완료하십시오.
b. HMAC 키 생성
- I. Google Cloud Console의 Cloud Storage로 이동한 다음 Settings를 선택하십시오.
- II. Interoperability 탭으로 이동하십시오.
- III. Service account HMAC 섹션에서 Create a key for a service account를 클릭하십시오.
- IV. 드롭다운 메뉴에서 이전 단계에서 생성한 서비스 계정을 선택하십시오.
- V. Create key를 클릭하십시오.
c. 자격 증명을 안전하게 저장하기:
- I. 시스템에 Access ID(HMAC 키)와 시크릿(HMAC 시크릿)이 표시됩니다. 이 값은 저장해 두십시오. 이 창을 닫은 후에는 시크릿이 다시 표시되지 않습니다.

ClickHouse Cloud에서 수행할 단계

외부 버킷을 구성하려면 아래 단계를 ClickHouse Cloud Console에서 수행하십시오.

외부 백업 변경

설정 페이지에서 외부 백업 변경을 클릭합니다.

GCP HMAC 키 및 시크릿 구성

팝업 대화상자에서 이전 섹션에서 생성한 GCP 버킷 경로, HMAC 키, 시크릿을 입력합니다.

외부 버킷 저장

설정을 저장하려면 Save External Bucket을 클릭합니다.

기본 일정 대신 백업 일정 변경

이제 외부 백업은 기본 일정에 따라 버킷에 수행됩니다. 또는 설정 페이지에서 백업 일정을 구성할 수 있습니다. 다르게 구성한 경우 사용자 지정 일정은 버킷에 백업을 저장하는 데 사용되며, 기본 일정(24시간마다 백업)은 ClickHouse Cloud 소유 버킷의 백업에 사용됩니다.

버킷에 저장된 백업 보기

아래와 같이 Backups 페이지에 버킷에 저장된 백업이 별도의 테이블로 표시됩니다.

GCP에서 백업 복원

아래 단계에 따라 GCP에서 백업을 복원하세요:

복원할 새 서비스 만들기

백업을 복원할 새 서비스를 만드세요.

백업 복원에 사용할 SQL 명령 가져오기

UI의 백업 목록 위에 있는 access or restore a backup 링크를 클릭하여 백업 복원에 사용할 SQL 명령을 확인하세요. 명령은 다음과 같은 형태이며, 드롭다운에서 원하는 백업을 선택하면 해당 백업에 맞는 복원 명령을 확인할 수 있습니다. 명령에 시크릿 액세스 키를 추가해야 합니다:

백업을 다른 위치로 이동하는 경우백업을 다른 위치로 옮긴 경우에는 새 위치를 참조하도록 복원 명령을 직접 수정해야 합니다.

ASYNC 명령대용량 복원의 경우 복원 명령 끝에 ASYNC 명령을 선택적으로 추가할 수도 있습니다. 이렇게 하면 복원이 비동기적으로 수행되므로 connection이 끊겨도 복원이 계속 진행됩니다. 중요한 점은 ASYNC 명령이 즉시 성공 상태를 반환한다는 것입니다. 하지만 이것이 복원이 성공했다는 의미는 아닙니다. 복원이 완료되었는지, 그리고 성공 또는 실패했는지 확인하려면 system.backups 테이블을 모니터링해야 합니다.

백업 복원을 위한 SQL 명령 실행

새로 만든 서비스의 SQL 콘솔에서 복원 명령을 실행하여 백업을 복원하세요.

Azure

Azure에 백업하기

Azure에 백업하려면 아래 단계를 따르십시오:

Azure에서 수행할 단계

스토리지 계정 생성

백업을 저장할 Azure 포털에서 스토리지 계정을 생성하거나 기존 스토리지 계정을 선택합니다.

연결 문자열 가져오기

a. 스토리지 계정 Overview에서 Security + networking 섹션을 찾아 Access keys를 클릭합니다.
b. 여기에서 key1과 key2를 확인할 수 있습니다. 각 키 아래에 Connection string 필드가 있습니다.
c. Show를 클릭하여 연결 문자열을 표시합니다. ClickHouse Cloud 설정에 사용할 연결 문자열을 복사합니다.

ClickHouse Cloud에서 따라야 할 단계

외부 버킷을 구성하려면 아래 단계를 ClickHouse Cloud Console에서 수행하십시오.

외부 백업 변경

설정 페이지에서 외부 백업 변경을 클릭합니다.

Azure 스토리지 계정의 연결 문자열 및 Container name 제공

다음 화면에서 이전 섹션에서 생성한 Azure 스토리지 계정의 연결 문자열과 Container Name을 입력합니다.

외부 버킷 저장

설정을 저장하려면 Save External Bucket을 클릭합니다.

기본 schedule에서 backup schedule 변경

이제 외부 백업은 기본 schedule에 따라 사용자의 버킷에 생성됩니다. 또는 설정 페이지에서 backup schedule을 구성할 수 있습니다. 다르게 구성한 경우에는 사용자 지정 schedule이 사용자의 버킷에 백업을 기록하는 데 사용되며, 기본 schedule(24시간마다 백업)은 ClickHouse Cloud 소유 버킷의 백업에 사용됩니다.

버킷에 저장된 백업 보기

아래와 같이 Backups 페이지에 사용자의 버킷에 저장된 백업이 별도의 테이블로 표시되어야 합니다.

Azure에서 백업 복원

Azure에서 백업을 복원하려면 아래 단계를 따르십시오.

복원할 새 서비스 생성

백업을 복원할 새 서비스를 생성하십시오. 현재는 백업을 새 서비스로만 복원할 수 있습니다.

백업 복원에 사용할 SQL 명령 가져오기

UI의 백업 목록 위에 있는 access or restore a backup 링크를 클릭하여 백업 복원에 사용할 SQL 명령을 가져오십시오. 명령은 다음과 같은 형태이며, 드롭다운에서 적절한 백업을 선택해 해당 백업의 복원 명령을 확인할 수 있습니다. 명령에 Azure 스토리지 계정 연결 문자열을 추가해야 합니다.

백업을 다른 위치로 이동하는 경우백업을 다른 위치로 이동한 경우, 새 위치를 참조하도록 복원 명령을 직접 수정해야 합니다.

ASYNC 명령대규모 복원의 경우 복원 명령 끝에 ASYNC를 선택적으로 추가할 수도 있습니다. 이렇게 하면 복원이 비동기적으로 수행되므로 연결이 끊겨도 복원 작업은 계속 실행됩니다. 중요한 점은 ASYNC 명령이 즉시 성공 상태를 반환한다는 것입니다. 이것이 복원이 성공했다는 뜻은 아닙니다. 복원이 완료되었는지, 그리고 성공했는지 실패했는지 확인하려면 system.backups 테이블을 모니터링해야 합니다.

백업 복원을 위해 SQL 명령 실행

새로 생성한 서비스의 SQL 콘솔에서 복원 명령을 실행하여 백업을 복원하십시오.

​AWS

​AWS에 백업하기

​1. AWS에서 수행할 단계

​2. ClickHouse Cloud에서 수행할 단계

​AWS에서 백업 복원하기

​GCP

​GCP에 백업 생성하기

​GCP에서 따라야 할 단계

​ClickHouse Cloud에서 수행할 단계

​GCP에서 백업 복원

​Azure

​Azure에 백업하기

​Azure에서 수행할 단계

​ClickHouse Cloud에서 따라야 할 단계

​Azure에서 백업 복원

AWS

AWS에 백업하기

1. AWS에서 수행할 단계

2. ClickHouse Cloud에서 수행할 단계

AWS에서 백업 복원하기

GCP

GCP에 백업 생성하기

GCP에서 따라야 할 단계

ClickHouse Cloud에서 수행할 단계

GCP에서 백업 복원

Azure

Azure에 백업하기

Azure에서 수행할 단계

ClickHouse Cloud에서 따라야 할 단계

Azure에서 백업 복원