TiDB 増分バックアップおよび復元ガイド
TiDB クラスターの増分データは、期間の開始スナップショットと終了スナップショット間の差分データ、およびこの期間中に生成された DDL です。完全 (スナップショット) バックアップ データと比較すると、増分データは小さいため、スナップショット バックアップの補足となり、バックアップ データのボリュームが削減されます。増分バックアップを実行するには、指定された期間内に生成された MVCC データがTiDB GC メカニズムによってガベージ コレクションされないようにします。たとえば、1 時間ごとに増分バックアップを実行するには、 tidb_gc_life_time 1 時間より大きい値に設定する必要があります。
制限事項
増分バックアップの復元では、増分 DDL ステートメントをフィルター処理するためにバックアップ時点のデータベース テーブルのスナップショットに依存するため、増分バックアップ プロセス中に削除されたテーブルはデータの復元後も存在する可能性があり、手動で削除する必要があります。
増分バックアップでは、テーブルのバッチ名前変更はサポートされていません。増分バックアップ プロセス中にテーブルのバッチ名前変更が発生すると、データの復元が失敗する可能性があります。テーブルのバッチ名前変更後に完全バックアップを実行し、復元中に最新の完全バックアップを使用して増分データを置き換えることをお勧めします。
v8.3.0 以降では、増分バックアップと後続のログ バックアップに互換性があるかどうかを制御するための--allow-pitr-from-incremental構成パラメータが導入されました。デフォルト値はtrueで、増分バックアップが後続のログ バックアップと互換性があることを意味します。
デフォルト値
true維持すると、増分リストアを開始する前に、再生する必要がある DDL が厳密にチェックされます。このモードでは、ADD INDEX、MODIFY COLUMN、またはREORG PARTITIONまだサポートされていません。増分バックアップをログ バックアップと一緒に使用する場合は、増分バックアップ プロセス中に前述の DDL が存在しないことを確認してください。そうしないと、これら 3 つの DDL を正しく再生できません。リカバリプロセス全体でログ バックアップなしで増分復元を使用する場合は、
--allow-pitr-from-incrementalからfalseに設定して増分リカバリ フェーズでのチェックをスキップできます。
増分データをバックアップする
増分データをバックアップするには、最後のバックアップ タイムスタンプ--lastbackuptsを指定してtiup br backupコマンドを実行します。このようにして、br コマンドライン ツールはlastbackuptsから現在の時刻の間に生成された増分データを自動的にバックアップします--lastbackupts取得するには、 validateコマンドを実行します。次に例を示します。
LAST_BACKUP_TS=`tiup br validate decode --field="end-version" --storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}"| tail -n1`
次のコマンドは、 (LAST_BACKUP_TS, current PD timestamp]からこの期間中に生成された DDL までの増分データをバックアップします。
tiup br backup full --pd "${PD_IP}:2379" \
--storage "s3://backup-101/snapshot-202209081330/incr?access-key=${access-key}&secret-access-key=${secret-access-key}" \
--lastbackupts ${LAST_BACKUP_TS} \
--ratelimit 128
--lastbackupts: 最後のバックアップのタイムスタンプ。--ratelimit: バックアップ タスクを実行するTiKV あたりの最大速度 (MiB/秒)。storage: バックアップデータのstorageパス。増分バックアップデータは、前回のスナップショットバックアップとは別のパスに保存する必要があります。上記の例では、増分バックアップデータはフルバックアップデータの下のincrディレクトリに保存されます。詳細については、 外部ストレージサービスの URI 形式参照してください。
増分データを復元する
増分データを復元する場合、 LAST_BACKUP_TSより前にバックアップされたすべてのデータがターゲット クラスターに復元されていることを確認してください。また、増分復元ではデータが更新されるため、復元中に他の書き込みが行われないようにする必要があります。そうしないと、競合が発生する可能性があります。
次のコマンドは、 backup-101/snapshot-202209081330ディレクトリに保存されている完全バックアップ データを復元します。
tiup br restore full --pd "${PD_IP}:2379" \
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}"
次のコマンドは、 backup-101/snapshot-202209081330/incrディレクトリに保存されている増分バックアップ データを復元します。
tiup br restore full --pd "${PD_IP}:2379" \
--storage "s3://backup-101/snapshot-202209081330/incr?access-key=${access-key}&secret-access-key=${secret-access-key}"