ご自身のクラウドアカウントへのバックアップのエクスポート

ClickHouse Cloud では、ご自身のクラウドサービスプロバイダー (CSP) アカウント (AWS S3、Google Cloud Storage、または Azure Blob Storage) へのバックアップの取得をサポートしています。 ClickHouse Cloud のバックアップの仕組み (「フル」バックアップと「増分」バックアップの違いを含む) について詳しくは、バックアップのドキュメントを参照してください。なお、ご自身のクラウドアカウントへのバックアップは、Cloud 内に保存されるバックアップとは重要な点で動作が異なります。ネイティブコピーを使用できません (以下の注記を参照)。このガイドでは、AWS、GCP、Azure のオブジェクトストレージにフルバックアップおよび増分バックアップを取得する方法と、それらのバックアップから復元する方法の例を紹介します。

同じクラウドプロバイダー内であっても、バックアップを別のリージョンにエクスポートする場合は、データ転送料金が発生します。クラウド間バックアップは、このページで説明するバックアップ／復元コマンド経由でのみサポートされており、UI からはサポートされていません。

Cloud 内バックアップと比べた場合のパフォーマンスへの影響 ご自身のバケットへのバックアップでは、ネイティブ (サーバー側) コピーを使用できません。ネイティブコピーでは、ソースと宛先が同じ認証情報を共有している必要がありますが、このケースでは該当しません。ソースは ClickHouse が管理するバケットであり、宛先は別個の認証情報で認証されるご自身のバケットだからです。ネイティブコピーが利用できないため、データはいったんソースからダウンロードされ、その後ご自身のバケットへ再アップロードされます (「copy-through-buffers」)。その結果、ご自身のバケットへのバックアップのエクスポートは、標準的な Cloud 内バックアップよりも時間がかかり、より多くのリソースを消費します。

要件

BACKUP コマンドを実行する前に、ClickHouse ユーザーに BACKUP 権限があることを確認してください。ClickHouse Cloud の default_role にはこの権限が含まれていません。バックアップをエクスポートする前に、これをリクエストするには ClickHouse Support にお問い合わせください。バックアップをお客様自身のCSPのストレージバケットにエクスポートまたは復元するには、以下の情報が必要です。

AWS

以下の形式の AWS S3 エンドポイント:

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

例:

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

各項目の意味は次のとおりです。

testchbackups は、バックアップのエクスポート先となる S3 バケットの名前です。
- backups は省略可能なサブディレクトリです。

AWS アクセスキーとシークレットアクセスキー。AWS ロールベース認証もサポートされており、AWS アクセスキーとシークレットアクセスキーの代わりに使用できます。

ロールベース認証を使用するには、Secure s3 の設定に従ってください。さらに、こちらで説明されている IAM ポリシーに s3:PutObject および s3:DeleteObject の権限を追加する必要があります。

Azure

Azure Storage の接続文字列。
ストレージアカウント内の Azure コンテナー名。
コンテナー内の Azure ブロブ。

Google Cloud Storage (GCS)

GCS エンドポイント (形式は以下のとおり) :
https://storage.googleapis.com/<bucket_name>/
アクセス用の 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>')

詳しくは、BACKUP/RESTORE で S3 エンドポイントを使用するための設定を参照してください。

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')

ClickHouse Cloud

Bring Your Own Cloud

ClickHouse Private

ご自身のクラウドアカウントへのバックアップのエクスポート

要件

AWS

Azure

Google Cloud Storage (GCS)

バックアップ / 復元

AWS S3 バケットへのバックアップ / 復元

DB のバックアップを取得する

バックアップから復元する

Azure Blob Storage へのバックアップ / 復元

DB のバックアップを取得する

バックアップから復元

Google Cloud Storage (GCS) へのバックアップ／復元

DB のバックアップを取得する

バックアップから復元

​要件

​AWS

​Azure

​Google Cloud Storage (GCS)

​バックアップ / 復元

​AWS S3 バケットへのバックアップ / 復元

​DB のバックアップを取得する

​バックアップから復元する

​Azure Blob Storage へのバックアップ / 復元

​DB のバックアップを取得する

​バックアップから復元

​Google Cloud Storage (GCS) へのバックアップ／復元

​DB のバックアップを取得する

​バックアップから復元

要件

AWS

Azure

Google Cloud Storage (GCS)

バックアップ / 復元

AWS S3 バケットへのバックアップ / 復元

DB のバックアップを取得する

バックアップから復元する

Azure Blob Storage へのバックアップ / 復元

DB のバックアップを取得する

バックアップから復元

Google Cloud Storage (GCS) へのバックアップ／復元

DB のバックアップを取得する

バックアップから復元