BR を使用して Amazon S3 でデータをバックアップおよび復元する

バックアップと復元 (BR) ツールは、Amazon S3 またはその他の Amazon S3 互換ファイルストレージを、データのバックアップと復元用の外部ストレージとして使用することをサポートしています。

アプリケーションシナリオ

Amazon S3 を使用すると、Amazon EC2 にデプロイされた TiDB クラスターのデータを Amazon S3 にすばやくバックアップしたり、Amazon S3 のバックアップデータから TiDB クラスターをすばやく復元したりできます。

S3 にアクセスする権限を設定する

S3 を使用してバックアップまたは復元を実行する前に、S3 へのアクセスに必要な権限を構成する必要があります。

S3 ディレクトリへのアクセスを構成する

バックアップの前に、S3 のバックアップディレクトリにアクセスするために次の権限を設定します。

バックアップ中に TiKV および BR がs3:ListBucket 、 s3:PutObject 、およびs3:AbortMultipartUploadのバックアップディレクトリにアクセスするための最小権限
TiKV と BR が復元時にs3:ListBucketとs3:GetObjectのバックアップディレクトリにアクセスするための最小限の権限

バックアップディレクトリをまだ作成していない場合は、 AWS 公式ドキュメントを参照して、指定したリージョンに S3 バケットを作成します。必要に応じて、 AWS 公式ドキュメント - フォルダーの作成を参照してバケットにフォルダーを作成することもできます。

S3 にアクセスするようにユーザーを構成する

次のいずれかの方法を使用して、S3 へのアクセスを構成することをお勧めします。

S3 にアクセスできるIAMロールを、TiKV および BR ノードが実行される EC2 インスタンスに関連付けます。関連付け後、BR は S3 のバックアップディレクトリにアクセスできます。
```
br backup full --pd "${PDIP}:2379" --storage "s3://${Bucket}/${Folder}" --s3.region "${region}"
```

br CLI で S3 にアクセスするためにaccess-keyとsecret-access-keyを設定し、 --send-credentials-to-tikv=trueを設定して BR から各 TiKV にアクセスキーを渡します。

br backup full --pd "${PDIP}:2379" --storage "s3://${Bucket}/${Folder}?access-key=${accessKey}&secret-access-key=${secretAccessKey}" --s3.region "${region}" --send-credentials-to-tikv=true

コマンドのアクセスキーは漏洩しやすいため、 IAMロールを EC2 インスタンスに関連付けて S3 にアクセスすることをお勧めします。

データを S3 にバックアップする

br backup full \
    --pd "${PDIP}:2379" \
    --storage "s3://${Bucket}/${Folder}?access-key=${accessKey}&secret-access-key=${secretAccessKey}" \
    --s3.region "${region}" \
    --send-credentials-to-tikv=true \
    --ratelimit 128 \
    --log-file backuptable.log

前述のコマンドでは:

--s3.region : S3 の領域を指定します。
--send-credentials-to-tikv : アクセスキーが TiKV ノードに渡されることを指定します。

S3 からデータを復元する

br restore full \
    --pd "${PDIP}:2379" \
    --storage "s3://${Bucket}/${Folder}?access-key=${accessKey}&secret-access-key=${secretAccessKey}" \
    --s3.region "${region}" \
    --ratelimit 128 \
    --send-credentials-to-tikv=true \
    --log-file restorefull.log

こちらもご覧ください

BR がサポートする外部ストレージの詳細については、外部ストレージを参照してください。