ユーザーインターフェイスからのバックアップ／リストア

AWS

AWSへのバックアップ取得

1. AWSでの手順

注記

以下の手順は"S3データへの安全なアクセス"で説明されている安全なS3セットアップと類似していますが、ロール権限に追加のアクションが必要です

AWSアカウントで以下の手順を実行します:

AWS S3バケットの作成

バックアップをエクスポートするAWS S3バケットをアカウント内に作成します。

IAMロールの作成

AWSはロールベース認証を使用するため、ClickHouse Cloudサービスがこのバケットへの書き込みのために引き受けることができるIAMロールを作成します。

a. ClickHouse Cloudサービス設定ページのネットワークセキュリティ情報から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でロールの権限ポリシーを作成します。両方の箇所でリソースに自分のバケット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コンソールで以下の手順を実行して外部バケットを設定します:

外部バックアップの変更

設定ページで「外部バックアップの設定」をクリックします:

AWS IAMロールARNとS3バケット詳細の設定

次の画面で、作成したAWS IAMロールARNとS3バケットURLを以下の形式で入力します:

Configure AWS IAM Role ARN and S3 bucket details

変更の保存

設定を保存するには「外部バケットを保存」をクリックします

デフォルトスケジュールからバックアップスケジュールの変更

外部バックアップは、デフォルトスケジュールでバケット内に実行されるようになります。または、「設定」ページからバックアップスケジュールを設定することもできます。異なる設定を行った場合、カスタムスケジュールがバケットへのバックアップ書き込みに使用され、デフォルトスケジュール(24時間ごとのバックアップ)がClickHouse Cloud所有バケット内のバックアップに使用されます。

バケットに保存されたバックアップの表示

バックアップページには、以下のようにバケット内のこれらのバックアップが別のテーブルに表示されます:

AWSからのバックアップ復元

AWSからバックアップを復元するには、以下の手順を実行します:

復元先の新しいサービスの作成

バックアップを復元する新しいサービスを作成します。

サービスARNの追加

新しく作成したサービスのARN(ClickHouse Cloudコンソールのサービス設定ページから取得)をIAMロールの信頼ポリシーに追加します。これは上記のAWS手順セクションの2番目のステップと同じです。新しいサービスがS3バケットにアクセスできるようにするために必要です。

バックアップ復元用SQLコマンドの取得

UIのバックアップリストの上にある「access or restore a backup」リンクをクリックして、バックアップを復元するためのSQLコマンドを取得します。コマンドは次のようになります:

バックアップを別の場所に移動する場合

バックアップを別の場所に移動する場合は、新しい場所を参照するように復元コマンドをカスタマイズする必要があります。

ASYNCコマンド

大規模な復元の場合、Restoreコマンドの末尾にオプションで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キー)とSecret(HMACシークレット)を表示します。これらの値を保存してください。このウィンドウを閉じた後、シークレットは再表示されません。

ClickHouse Cloudでの実行手順

ClickHouse Cloudコンソールで以下の手順に従って外部バケットを設定します: