br コマンドラインマニュアル
このドキュメントでは、 brコマンドの定義、コンポーネント、共通オプション、およびbrコマンドを使用してスナップショット バックアップと復元、およびログ バックアップとポイント イン タイム リカバリ (PITR) を実行する方法について説明します。
brコマンドラインの説明
brコマンドは、サブコマンド、オプション、およびパラメーターで構成されます。サブコマンドは-または--を除いた文字です。オプションは-または--で始まる文字です。パラメータは、直後に続く文字で、サブコマンドまたはオプションに渡されます。
以下は完全なbrコマンドです。
br backup full --pd "${PD_IP}:2379" \
--storage "s3://backup-data/snapshot-202209081330/"
上記のコマンドの説明は次のとおりです。
backup:brのサブコマンド。full:br backupのサブコマンド。-s(または--storage): バックアップ ファイルが格納されるパスを指定するオプション。"s3://backup-data/snapshot-202209081330/"-sのパラメータです。--pd: PD サービス アドレスを指定するオプション。"${PD_IP}:2379"--pdのパラメータです。
コマンドとサブコマンド
brコマンドは、サブコマンドの複数のレイヤーで構成されます。現在、br コマンドライン ツールには次のサブコマンドがあります。
br backup: TiDB クラスターのデータをバックアップするために使用されます。br log: ログ バックアップ タスクの開始と管理に使用されます。br restore: TiDB クラスターのバックアップ データを復元するために使用されます。
br backupとbr restoreには、次のサブコマンドが含まれます。
full: すべてのクラスター データのバックアップまたは復元に使用されます。db: クラスターの指定されたデータベースのバックアップまたは復元に使用されます。table: クラスターの指定されたデータベース内の単一のテーブルをバックアップまたは復元するために使用されます。
共通オプション
--pd: PD サービス アドレスを指定します。たとえば、"${PD_IP}:2379"です。-s(または--storage): バックアップ ファイルが格納されるパスを指定します。バックアップ データの保存には、Amazon S3、Google Cloud Storage (GCS)、Azure Blob Storage、および NFS がサポートされています。詳細については、 バックアップ ストレージの URL 形式を参照してください。--ca: 信頼できる CA 証明書へのパスを PEM 形式で指定します。--cert: SSL 証明書へのパスを PEM 形式で指定します。--key: SSL 証明書キーへのパスを PEM 形式で指定します。--status-addr:brPrometheus に統計を提供するためのリスニング アドレスを指定します。
フルバックアップのコマンド
クラスター データをバックアップするには、 br backupコマンドを実行します。 fullまたはtableサブコマンドを追加して、バックアップ操作の範囲 (クラスター全体 ( full ) または単一のテーブル ( table )) を指定できます。
ログバックアップのコマンド
ログ バックアップを開始し、ログ バックアップ タスクを管理するには、 br logコマンドを実行します。
- ログ バックアップ タスクを開始する
- バックアップ ステータスのクエリ
- ログ バックアップ タスクの一時停止と再開
- ログ バックアップ タスクを停止して再開する
- バックアップ データのクリーンアップ
- バックアップ メタデータをビュー
バックアップデータを復元するコマンド
クラスター データを復元するには、 br restoreコマンドを実行します。 full 、 db 、またはtableサブコマンドを追加して、復元の範囲 (クラスター全体 ( full )、単一データベース ( db )、または単一テーブル ( table )) を指定できます。