TiDB バックアップとリストアのユースケース

TiDB スナップショットのバックアップと復元ガイドおよびTiDB ログバックアップと PITR ガイド 、TiDB が提供するバックアップおよびリストアソリューション、すなわちスナップショット（フル）バックアップとリストア、ログバックアップ、そしてポイントインタイムリカバリ（PITR）について紹介します。このドキュメントは、特定のユースケースにおいて TiDB のバックアップおよびリストアソリューションを迅速に導入するのに役立ちます。

AWS に TiDB本番クラスターをデプロイし、ビジネスチームが次の要件を要求しているとします。

• データの変更はタイムリーにバックアップしてください。データベースに災害が発生した場合でも、最小限のデータ損失（許容できるのは数分間のデータ損失のみ）でアプリケーションを迅速に復旧できます。
• 毎月、特定の時間に業務監査を実施します。監査依頼を受けた場合、要求に応じて過去1ヶ月間の特定の時点のデータにクエリを実行するためのデータベースを提供する必要があります。

PITR を使用すると、前述の要件を満たすことができます。

TiDBクラスタとBRをデプロイ

PITRを使用するには、TiDBクラスタ（v6.2.0以上）をデプロイし、 BRをTiDBクラスタと同じバージョンにアップデートする必要があります。このドキュメントでは、例としてv8.5.3を使用しています。

次の表は、TiDB クラスターで PITR を使用するために推奨されるハードウェア リソースを示しています。

注記：

• BRがバックアップおよび復元タスクを実行する際、PDとTiKVにアクセスする必要があります。BRがすべてのPDおよびTiKVノードに接続できることを確認してください。
• BRサーバーと PD サーバーは同じタイムゾーンを使用する必要があります。

TiUPを使用して TiDB クラスターをデプロイまたはアップグレードします。

• 新しい TiDB クラスターをデプロイするには、 TiDBクラスタをデプロイを参照してください。
• TiDB クラスターが v6.2.0 より前の場合は、 TiDBクラスタのアップグレードを参照してアップグレードしてください。

TiUPを使用してBRをインストールまたはアップグレードします。

• インストール：

  tiup install br:v8.5.3
  

• アップグレード:

  tiup update br:v8.5.3
  

バックアップstorage（Amazon S3）を構成する

バックアップ タスクを開始する前に、次の点を含めてバックアップstorageを準備します。

1. バックアップデータを保存する S3 バケットとディレクトリを準備します。
2. S3 バケットにアクセスするための権限を設定します。
3. 各バックアップ データを保存するサブディレクトリを計画します。

詳細な手順は次のとおりです。

1. バックアップデータを保存するディレクトリをS3に作成します。この例ではディレクトリはs3://tidb-pitr-bucket/backup-dataです。

   1. バケットを作成します。バックアップデータの保存先として既存のS3を選択できます。S3が存在しない場合は、 AWSドキュメント: バケットの作成を参照してS3バケットを作成してください。この例では、バケット名はtidb-pitr-bucketです。
   2. バックアップデータ用のディレクトリを作成します。バケット（ tidb-pitr-bucket ）内にbackup-dataという名前のディレクトリを作成します。詳細な手順はAWS ドキュメント: Amazon S3 コンソールでフォルダを使用してオブジェクトを整理するを参照してください。

2. BRとTiKVがS3ディレクトリにアクセスするための権限を設定します。S3バケットにアクセスする最も安全な方法であるIAMメソッドを使用して権限を付与することをお勧めします。詳細な手順については、 AWS ドキュメント: ユーザーポリシーによるバケットへのアクセス制御を参照してください。必要な権限は次のとおりです。

   • バックアップ クラスター内の TiKV とBRにs3:GetObject s3:DeleteObject s3://tidb-pitr-bucket/backup-dataディレクトリのs3:ListBucket 、およびs3:AbortMultipartUpload s3:PutObjectが必要です。
   • 復元クラスター内の TiKV とBRには、 s3://tidb-pitr-bucket/backup-dataディレクトリのs3:ListBucketとs3:GetObject権限が必要です。

3. スナップショット (完全) バックアップやログ バックアップなどのバックアップ データを保存するディレクトリ構造を計画します。

   • すべてのスナップショットバックアップデータはs3://tidb-pitr-bucket/backup-data/snapshot-${date}ディレクトリに保存されます。 ${date}スナップショットバックアップの開始時刻です。例えば、2022/05/12 00:01:30 に開始されたスナップショットバックアップはs3://tidb-pitr-bucket/backup-data/snapshot-20220512000130に保存されます。
   • ログバックアップデータはs3://tidb-pitr-bucket/backup-data/log-backup/ディレクトリに保存されます。

バックアップポリシーを決定する

最小限のデータ損失、迅速な回復、および 1 か月以内のビジネス監査の要件を満たすには、次のようにバックアップ ポリシーを設定できます。

• ログ バックアップを実行して、データベース内のデータの変更を継続的にバックアップします。
• 2 日ごとに午前 0 時にスナップショット バックアップを実行します。
• スナップショット バックアップ データとログ バックアップ データを 30 日以内に保持し、30 日以上経過したバックアップ データをクリーンアップします。

ログバックアップを実行する

ログバックアップタスクが開始されると、TiKVクラスター内でログバックアッププロセスが実行され、データベース内のデータ変更がS3storageに継続的に送信されます。ログバックアップタスクを開始するには、次のコマンドを実行します。

tiup br log start --task-name=pitr --pd="${PD_IP}:2379" \
--storage='s3://tidb-pitr-bucket/backup-data/log-backup'

ログ バックアップ タスクの実行中に、バックアップ ステータスを照会できます。

tiup br log status --task-name=pitr --pd="${PD_IP}:2379"

● Total 1 Tasks.
> #1 <
    name: pitr
    status: ● NORMAL
    start: 2022-05-13 11:09:40.7 +0800
      end: 2035-01-01 00:00:00 +0800
    storage: s3://tidb-pitr-bucket/backup-data/log-backup
    speed(est.): 0.00 ops/s
checkpoint[global]: 2022-05-13 11:31:47.2 +0800; gap=4m53s

スナップショットバックアップを実行する

crontabなどの自動ツールを使えば、スナップショットバックアップタスクを定期的に実行できます。例えば、2日ごとに00:00にスナップショットバックアップを実行するなどです。

以下に 2 つのスナップショット バックアップの例を示します。

• 2022/05/14 00:00:00にスナップショットバックアップを実行する

  tiup br backup full --pd="${PD_IP}:2379" \
  --storage='s3://tidb-pitr-bucket/backup-data/snapshot-20220514000000' \
  --backupts='2022/05/14 00:00:00 +08:00'
  

• 2022/05/16 00:00:00にスナップショットバックアップを実行する

  tiup br backup full --pd="${PD_IP}:2379" \
  --storage='s3://tidb-pitr-bucket/backup-data/snapshot-20220516000000' \
  --backupts='2022/05/16 00:00:00 +08:00'
  

PITRを実行する

2022/05/15 18:00:00 のデータに対してクエリを実行する必要がある場合、PITR を使用することで、2022/05/14 に取得したスナップショットバックアップと、そのスナップショットから 2022/05/15 18:00:00 までのログバックアップデータを復元することで、クラスターをその時点に復元できます。

コマンドは次のとおりです。

tiup br restore point --pd="${PD_IP}:2379" \
--storage='s3://tidb-pitr-bucket/backup-data/log-backup' \
--full-backup-storage='s3://tidb-pitr-bucket/backup-data/snapshot-20220514000000' \
--restored-ts '2022-05-15 18:00:00+0800'

Full Restore <--------------------------------------------------------------------------------------------------------------------------------------------------------> 100.00%
[2022/05/29 18:15:39.132 +08:00] [INFO] [collector.go:69] ["Full Restore success summary"] [total-ranges=12] [ranges-succeed=xxx] [ranges-failed=0] [split-region=xxx.xxxµs] [restore-ranges=xxx] [total-take=xxx.xxxs] [restore-data-size(after-compressed)=xxx.xxx] [Size=xxxx] [BackupTS={TS}] [total-kv=xxx] [total-kv-size=xxx] [average-speed=xxx]
Restore Meta Files <--------------------------------------------------------------------------------------------------------------------------------------------------> 100.00%
Restore KV Files <----------------------------------------------------------------------------------------------------------------------------------------------------> 100.00%
[2022/05/29 18:15:39.325 +08:00] [INFO] [collector.go:69] ["restore log success summary"] [total-take=xxx.xx] [restore-from={TS}] [restore-to={TS}] [total-kv-count=xxx] [total-size=xxx]

古いデータをクリーンアップする

crontab などの自動ツールを使用して、2 日ごとに古いデータをクリーンアップできます。

たとえば、次のコマンドを実行して古いデータをクリーンアップできます。

• 2022/05/14 00:00:00より前のスナップショットデータを削除します

  rm s3://tidb-pitr-bucket/backup-data/snapshot-20220514000000
  

• 2022/05/14 00:00:00より前のログバックアップデータを削除します

  tiup br log truncate --until='2022-05-14 00:00:00 +0800' --storage='s3://tidb-pitr-bucket/backup-data/log-backup'
  

参照

• バックアップストレージ
• スナップショットのバックアップと復元コマンドマニュアル
• ログバックアップとPITRコマンドマニュアル