자체 클라우드 계정으로 백업 내보내기

자체 Cloud 계정으로 백업을 내보내는 방법을 설명합니다

ClickHouse Cloud는 자체 클라우드 서비스 제공업체(CSP) 계정(AWS S3, Google Cloud Storage 또는 Azure Blob Storage)으로 백업을 내보내는 기능을 지원합니다. “전체” 백업과 “증분” 백업의 차이를 포함해 ClickHouse Cloud 백업의 작동 방식에 관한 자세한 내용은 백업 문서를 참조하십시오. 한 가지 중요한 차이점은 자체 클라우드 계정으로 내보내는 백업은 제자리 Cloud 백업과 다르게 동작한다는 점입니다. 즉, 네이티브 복사(아래 참고 참조)를 사용할 수 없습니다.

이 가이드에서는 AWS, GCP, Azure 객체 스토리지로 전체 및 증분 백업을 수행하는 방법과 해당 백업에서 복원하는 방법에 대한 예시를 보여드립니다.

동일한 클라우드 제공업체 내에서 백업을 다른 리전으로 내보내면 데이터 전송 요금이 부과됩니다.

클라우드 간 백업은 이 페이지에 설명된 백업/복원 명령을 통해서만 지원되며 UI에서는 지원되지 않습니다.

제자리 백업 대비 성능 영향 자체 버킷으로 내보내는 백업은 네이티브(서버 측) 복사를 사용할 수 없습니다. 네이티브 복사를 사용하려면 소스와 대상이 동일한 자격 증명을 공유해야 하지만, 여기서는 그렇지 않습니다. 소스는 ClickHouse가 관리하는 버킷이고 대상은 별도의 자격 증명으로 인증되는 자체 버킷입니다.

네이티브 복사를 사용할 수 없으므로 데이터는 소스에서 다운로드된 후 사용자 버킷으로 다시 업로드됩니다(“copy-through-buffers”). 그 결과, 자체 버킷으로 백업을 내보내는 작업은 표준 제자리 Cloud 백업보다 더 느리고 더 많은 리소스를 사용합니다.

​

요구 사항

BACKUP 명령을 실행하기 전에 ClickHouse 사용자에게 BACKUP privilege가 있는지 확인하십시오. ClickHouse Cloud의 default_role에는 이 privilege가 포함되어 있지 않습니다. 백업을 내보내기 전에 이 privilege가 필요하면 ClickHouse 지원팀에 문의하십시오.

백업을 사용자의 CSP 스토리지 버킷으로 내보내거나 해당 버킷에서 복원하려면 다음 정보가 필요합니다.

​

AWS

1. AWS S3 엔드포인트(형식은 다음과 같음):

  s3://<bucket_name>.s3.amazonaws.com/<directory>

예를 들어:

  s3://testchbackups.s3.amazonaws.com/backups/

여기서:

• testchbackups는 백업을 내보낼 S3 버킷의 이름입니다.
  • backups는 선택 사항인 하위 디렉터리입니다.

2. AWS 액세스 키와 시크릿 키. AWS 액세스 키와 시크릿 키 대신 역할 기반 인증도 지원합니다.

역할 기반 인증을 사용하려면 Secure s3 설정을 따르십시오. 또한 여기에 설명된 IAM 정책에 s3:PutObject 및 s3:DeleteObject 권한을 추가해야 합니다.

​

Azure

1. Azure 스토리지 연결 문자열.
2. 스토리지 계정의 Azure 컨테이너 이름.
3. 컨테이너의 Azure Blob.

​

Google Cloud Storage (GCS)

1. 다음 포맷의 GCS 엔드포인트:

   https://storage.googleapis.com/<bucket_name>/
   

2. 액세스 HMAC 키와 HMAC 시크릿.

---

​

백업 / 복원

​

AWS S3 버킷에 백업 / 복원

​

DB 백업 생성

전체 백업

BACKUP DATABASE test_backups 
TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>')

여기서 uuid는 백업 세트를 구분하는 데 사용하는 고유 식별자입니다.

이 하위 디렉터리에서는 새 백업을 만들 때마다 다른 UUID를 사용해야 합니다. 그렇지 않으면 BACKUP_ALREADY_EXISTS 오류가 발생합니다. 예를 들어 매일 백업하는 경우에는 매일 새로운 UUID를 사용해야 합니다.

증분 백업

BACKUP DATABASE test_backups 
TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>') 
SETTINGS base_backup = S3('https://testchbackups.s3.amazonaws.com/backups/<base-backup-uuid>', '<key id>', '<key secret>')

​

백업에서 복원하기

RESTORE DATABASE test_backups 
AS test_backups_restored 
FROM S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>')

참고: 자세한 내용은 S3 엔드포인트를 사용하도록 BACKUP/RESTORE 구성하기를 참조하십시오.

​

Azure Blob Storage로 백업 / 복원

​

DB 백업 생성

전체 백업

BACKUP DATABASE test_backups 
TO AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>');

여기서 uuid는 각 백업 세트를 구분하는 데 사용되는 고유 식별자입니다.

증분 백업

BACKUP DATABASE test_backups 
TO AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>/my_incremental') 
SETTINGS base_backup = AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>')

​

백업에서 복원

RESTORE DATABASE test_backups 
AS test_backups_restored_azure 
FROM AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>')

참조: 자세한 내용은 AzureBlobStorage 엔드포인트를 사용하도록 BACKUP/RESTORE 구성하기 문서를 참고하십시오.

​

Google Cloud Storage (GCS)로 백업 / 복원하기

​

DB 백업 생성

전체 백업

BACKUP DATABASE test_backups 
TO S3('https://storage.googleapis.com/<bucket>/<uuid>', <hmac-key>', <hmac-secret>)

여기서 uuid는 백업 세트를 구분하는 데 사용되는 고유 식별자입니다.

증분 백업

BACKUP DATABASE test_backups 
TO S3('https://storage.googleapis.com/test_gcs_backups/<uuid>/my_incremental', 'key', 'secret')
SETTINGS base_backup = S3('https://storage.googleapis.com/test_gcs_backups/<uuid>', 'key', 'secret')

​

백업에서 복원하기

RESTORE DATABASE test_backups 
AS test_backups_restored_gcs 
FROM S3('https://storage.googleapis.com/test_gcs_backups/<uuid>', 'key', 'secret')