📣
TiDB Cloud Essential はパブリックプレビュー中です。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者向け
ベストプラクティス
API

バックアップ

このステートメントは、TiDBクラスタの分散バックアップを実行するために使用されます。

BACKUPステートメントは、 BRツールと同じエンジンを使用しますが、バックアップ処理は別のBRツールではなくBR自体によって実行されます。BR のすべての利点と警告は、このステートメントにも適用されます。

BACKUPを実行するにはBACKUP_ADMINまたはSUPER権限が必要です。さらに、バックアップを実行する TiDB ノードとクラスタ内のすべての TiKV ノードの両方が、宛先への読み取りまたは書き込み権限を持っている必要があります。 Security強化モードが有効になっている場合、ローカルstorage( local://で始まるstorageパス) は許可されません。

BACKUPステートメントは、バックアップ タスク全体が完了、失敗、またはキャンセルされるまでブロックされます。 BACKUPを実行するには、長時間接続を準備する必要があります。タスクは、KILL TIDB QUERYステートメントを使用してキャンセルできます。

BACKUPおよびRESTOREタスクは、一度に 1 つしか実行できません。 BACKUPまたはRESTOREステートメントが同じ TiDBサーバーで既に実行されている場合、新しいBACKUPの実行は、以前のすべてのタスクが完了するまで待機します。

BACKUP 「tikv」storageエンジンでのみ使用できます。「unistore」エンジンでBACKUPを使用すると失敗します。

あらすじ

BackupStmt
BACKUPBRIETablesTOstringLitBackupOption
BRIETables
DATABASE*DBName,TABLETableNameList
BackupOption
CHECKSUM=BooleanCHECKSUM_CONCURRENCY=LengthNumCOMPRESSION_LEVEL=LengthNumCOMPRESSION_TYPE=stringLitCONCURRENCY=LengthNumIGNORE_STATS=BooleanLAST_BACKUP=BackupTSORATE_LIMIT=LengthNumMB/SECONDSEND_CREDENTIALS_TO_TIKV=BooleanSNAPSHOT=BackupTSOLengthNumTimestampUnitAGO
Boolean
NUMTRUEFALSE
BackupTSO
LengthNumstringLit

例

データベースのバックアップ

BACKUP DATABASE `test` TO 'local:///mnt/backup/2020/04/';

+------------------------------+-----------+-----------------+---------------------+---------------------+
| Destination                  | Size      | BackupTS        | Queue Time          | Execution Time      |
+------------------------------+-----------+-----------------+---------------------+---------------------+
| local:///mnt/backup/2020/04/ | 248665063 | 416099531454472 | 2020-04-12 23:09:48 | 2020-04-12 23:09:48 |
+------------------------------+-----------+-----------------+---------------------+---------------------+
1 row in set (58.453 sec)

上記の例では、 testデータベースがローカルファイルシステムにバックアップされます。データは、すべての TiDB および TiKV ノードに分散された/mnt/backup/2020/04/ディレクトリに SST ファイルとして保存されます。

上記の結果の最初の行は、次のように説明されています。

カラム説明
Destination宛先URL
Sizeバックアップアーカイブの合計サイズ（バイト単位）
BackupTSバックアップ作成時のスナップショットの TSO (増分バックアップに役立ちます)
Queue TimeBACKUPタスクがキューに入れられたときのタイムスタンプ（現在のタイムゾーン）。
Execution TimeBACKUPタスクの実行が開始されたときのタイムスタンプ（現在のタイムゾーン）。

バックアップテーブル

BACKUP TABLE `test`.`sbtest01` TO 'local:///mnt/backup/sbtest01/';

BACKUP TABLE sbtest02, sbtest03, sbtest04 TO 'local:///mnt/backup/sbtest/';

クラスター全体をバックアップする

BACKUP DATABASE * TO 'local:///mnt/backup/full/';

システムテーブル（ mysql.* 、 INFORMATION_SCHEMA.* 、 PERFORMANCE_SCHEMA.* 、…）はバックアップに含まれないことに注意してください。

外部ストレージ

BRは、S3またはGCSへのデータバックアップをサポートしています。

BACKUP DATABASE `test` TO 's3://example-bucket-2020/backup-05/?access-key={YOUR_ACCESS_KEY}&secret-access-key={YOUR_SECRET_KEY}';

URL 構文については外部ストレージサービスのURI形式で詳しく説明します。

認証情報を配布すべきでないクラウド環境で実行する場合は、 SEND_CREDENTIALS_TO_TIKVオプションをFALSEに設定してください。

BACKUP DATABASE `test` TO 's3://example-bucket-2020/backup-05/'
    SEND_CREDENTIALS_TO_TIKV = FALSE;

パフォーマンスの微調整

RATE_LIMITを使用して、TiKVノードあたりの平均アップロード速度を制限し、ネットワーク帯域幅を削減します。

バックアップが完了する前に、 BACKUPデフォルトでクラスタ上のデータに対してチェックサムを実行し、データの正当性を検証します。単一テーブルでのチェックサムタスクのデフォルトの同時実行数は 4 ですが、 CHECKSUM_CONCURRENCYパラメータを使用して調整できます。データの検証が不要であると確信している場合は、 CHECKSUMパラメータをFALSEに設定してチェックを無効にできます。

テーブルとインデックスのバックアップにおいて、 BRが同時に実行できるタスクの数を指定するには、 CONCURRENCYパラメーターを使用します。このパラメーターは、 BR内のスレッドプールサイズを制御し、バックアップ操作のパフォーマンスと効率を最適化します。

バックアップスキーマに応じて、1つのタスクは1つのテーブル範囲または1つのインデックス範囲を表します。1つのテーブルと1つのインデックスの場合、このテーブルをバックアップするために2つのタスクが使用されます。 CONCURRENCYのデフォルト値は4です。多数のテーブルまたはインデックスをバックアップする必要がある場合は、この値を増やしてください。

デフォルトでは統計はバックアップされません。統計情報をバックアップするには、 IGNORE_STATSパラメーターをFALSEに設定する必要があります。

デフォルトでは、バックアップによって生成される SST ファイルはzstd圧縮アルゴリズムを使用します。必要に応じて、 COMPRESSION_TYPEパラメータを使用して別の圧縮アルゴリズムを指定できます。サポートされているアルゴリズムには、 lz4 、 zstd 、およびsnappyあります。またCOMPRESSION_LEVELパラメータを使用して圧縮レベルを調整することもできます。レベル番号が大きいほど圧縮率は高くなりますが、CPU 消費量も高くなります。

BACKUP DATABASE `test` TO 's3://example-bucket-2020/backup-06/'
    RATE_LIMIT = 120 MB/SECOND
    CONCURRENCY = 8
    CHECKSUM = FALSE;

スナップショット

履歴データをバックアップするために、タイムスタンプ、TSO、または相対時間を指定します。

-- relative time
BACKUP DATABASE `test` TO 'local:///mnt/backup/hist01'
    SNAPSHOT = 36 HOUR AGO;

-- timestamp (in current time zone)
BACKUP DATABASE `test` TO 'local:///mnt/backup/hist02'
    SNAPSHOT = '2020-04-01 12:00:00';

-- timestamp oracle
BACKUP DATABASE `test` TO 'local:///mnt/backup/hist03'
    SNAPSHOT = 415685305958400;

相対時間でサポートされている単位は以下のとおりです。

  • マイクロ秒
  • 2番
  • 分
  • 時間
  • 日
  • 週

SQL標準に従い、単位は常に単数形であることに注意してください。

増分バックアップ

LAST_BACKUPオプションを指定すると、前回のバックアップから現在のスナップショットまでの変更点のみがバックアップされます。

-- timestamp (in current time zone)
BACKUP DATABASE `test` TO 'local:///mnt/backup/hist02'
    LAST_BACKUP = '2020-04-01 12:00:00';

-- timestamp oracle
BACKUP DATABASE `test` TO 'local:///mnt/backup/hist03'
    LAST_BACKUP = 415685305958400;

MySQLとの互換性

このステートメントは、MySQL構文に対するTiDBの拡張機能です。

関連項目

このページは役に立ちましたか？