diff --git a/br/backup-and-restore-overview.md b/br/backup-and-restore-overview.md index 1d1c223e7493f..043a26503d5ad 100644 --- a/br/backup-and-restore-overview.md +++ b/br/backup-and-restore-overview.md @@ -16,7 +16,7 @@ BRは以下の要件を満たしています。 ## 使用する前に {#before-you-use} -このセクションでは、TiDB のバックアップとリストアを使用するための前提条件について説明します。これには、制限事項、使用上のヒント、互換性の問題が含まれます。BR ツールと他の機能またはバージョンとの[互換性](#compatibility)性の詳細については、 を参照してください。 +このセクションでは、TiDB のバックアップとリストアを使用するための前提条件について説明します。これには、制限事項、使用上のヒント、互換性の問題が含まれます。BR ツールと他の機能またはバージョンとの互換性の詳細については、 [互換性](#compatibility)を参照してください。 ### 制限 {#restrictions} @@ -76,7 +76,7 @@ TiDB BRは以下の機能を提供します。 #### バックアップのパフォーマンスとTiDBクラスタへの影響 {#backup-performance-and-impact-on-tidb-clusters} - クラスタのCPUとI/Oリソースが十分な場合、スナップショットバックアップがTiDBクラスタに与える影響は限定的で、通常は20%未満に抑えられます。TiDBクラスタを適切に構成することで、この影響をさらに10%以下にまで最小限に抑えることができます。CPUとI/Oリソースが不足している場合は、TiKV設定項目[`backup.num-threads`](/tikv-configuration-file.md#num-threads-1)を調整して、バックアップタスクで使用されるワーカースレッド数を変更し、バックアップタスクがTiDBクラスタに与える影響を軽減できます。TiKVノードのバックアップ速度はスケーラブルで、50MB/秒から100MB/秒の範囲です。詳細については、 [バックアップのパフォーマンスと影響](/br/br-snapshot-guide.md#performance-and-impact-of-snapshot-backup)を参照してください。 -- ログバックアップタスクのみの場合、クラスタへの影響は約5%です。ログバックアップは、3～5分ごとに最後の更新後に生成されたすべての変更をバックアップストレージにフラッシュするため、**最短5分のリカバリポイント目標（RPO）を実現できます**。 +- ログバックアップタスクのみの場合、クラスタへの影響は約5%です。ログバックアップは、3～5分ごとに最後の更新後に生成されたすべての変更をバックアップストレージにフラッシュするため、**最短5分のRPO（目標復旧時点）を実現できます**。 ### バックアップデータを復元する {#restore-backup-data} @@ -88,12 +88,12 @@ TiDB BRは以下の機能を提供します。 - 任意の時点へのデータ復元（PITR） - - `br restore point`コマンドを実行すると、リカバリ時点より前の最新のスナップショットバックアップデータを復元し、指定した時点までのバックアップデータをログに記録できます。BRは復元範囲を自動的に判断し、バックアップデータにアクセスして、ターゲットクラスタにデータを復元します。 + - `br restore point`コマンドを実行すると、リカバリ時点より前の最新のスナップショットバックアップデータと、指定した時点までのログバックアップデータを復元できます。BRは復元範囲を自動的に判断し、バックアップデータにアクセスして、ターゲットクラスタにデータを復元します。 -#### TiDBクラスターのパフォーマンスと影響を回復する {#restore-performance-and-impact-on-tidb-clusters} +#### 復元のパフォーマンスとTiDBクラスターへの影響 {#restore-performance-and-impact-on-tidb-clusters} -- データの復元はスケーラブルな速度で実行されます。通常、速度は TiKV ノードあたり 1 GiB/秒です。詳細については、 [パフォーマンスとインパクトを回復](/br/br-snapshot-guide.md#performance-and-impact-of-snapshot-restore)をご覧ください。 -- 各 TiKV ノードでは、PITR は 30 GiB/h でログデータを復元できます。詳細については、 [PITRのパフォーマンスと影響](/br/br-pitr-guide.md#performance-capabilities-of-pitr)ご覧ください。 +- データの復元はスケーラブルな速度で実行されます。通常、速度は TiKV ノードあたり 1 GiB/秒です。詳細については、 [復元のパフォーマンスと影響](/br/br-snapshot-guide.md#performance-and-impact-of-snapshot-restore)をご覧ください。 +- 各 TiKV ノードでは、PITR は 30 GiB/時間でログデータを復元できます。詳細については、 [PITRのパフォーマンスと影響](/br/br-pitr-guide.md#performance-capabilities-of-pitr)をご覧ください。 ## バックアップストレージ {#backup-storage} @@ -116,7 +116,7 @@ TiDBの一部の機能が有効化または無効化されている場合、バ | グローバル一時テーブル | | データのバックアップと復元には、 BRのバージョン5.3.0以降を使用していることを確認してください。そうでない場合、バックアップ対象のグローバル一時テーブルの定義でエラーが発生します。 | | TiDB Lightning物理インポート | | アップストリームデータベースがTiDB Lightningの物理インポートモードを使用している場合、ログバックアップでデータをバックアップできません。データのインポート後に完全バックアップを実行することをお勧めします。詳細については、 [上流データベースがTiDB Lightningを使用して物理インポートモードでデータをインポートすると、ログバックアップ機能が利用できなくなります。なぜでしょうか？](/faq/backup-and-restore-faq.md#when-the-upstream-database-imports-data-using-tidb-lightning-in-the-physical-import-mode-the-log-backup-feature-becomes-unavailable-why)を参照してください。 | | TiCDC | | BR v8.2.0 以降: リストア対象のクラスターにチェンジフィードがあり、チェンジフィードの[CheckpointTS](/ticdc/ticdc-classic-architecture.md#checkpointts)が BackupTS より前の場合、 BR はリストアを実行しません。 BRバージョン v8.2.0 より前: リストア対象のクラスターにアクティブな TiCDC チェンジフィードがある場合、 BR はリストアを実行しません。 | -| ベクトル検索 | | データのバックアップと復元には、 BR v8.4.0 以降のバージョンを使用していることを確認してください。テーブルを で復元することは [ベクトルデータ型](/ai/reference/vector-search-data-types.md)v8.4.0 より前の TiDB クラスタではサポートされていません。 | +| ベクトル検索 | | データのバックアップと復元には、 BR v8.4.0 以降のバージョンを使用していることを確認してください。 [ベクトルデータ型](/ai/reference/vector-search-data-types.md)を持つテーブルを v8.4.0 より前の TiDB クラスタに復元することはサポートされていません。 | ### バージョン互換性 {#version-compatibility} diff --git a/br/backup-and-restore-storages.md b/br/backup-and-restore-storages.md index 5b346dd3de425..4199ae430941d 100644 --- a/br/backup-and-restore-storages.md +++ b/br/backup-and-restore-storages.md @@ -5,7 +5,7 @@ summary: TiDBは、Amazon S3、Google Cloud Storage、Azure Blob Storage、NFS # バックアップストレージ {#backup-storages} -TiDBは、Amazon S3、Google Cloud Storage（GCS）、Azure Blob Storage、NFSへのバックアップデータの保存をサポートしています。具体的には、 `br`コマンドの`--storage`または`-s`のパラメータでバックアップストレージのURIを指定できます。このドキュメントでは、 [URI形式](#uri-format)と[認証](#authentication)の外部ストレージサービスと、 [サーバー側の暗号化](#server-side-encryption)の外部ストレージサービスを紹介します。 +TiDBは、Amazon S3、Google Cloud Storage（GCS）、Azure Blob Storage、NFSへのバックアップデータの保存をサポートしています。具体的には、 `br`コマンドの`--storage`または`-s`のパラメータでバックアップストレージのURIを指定できます。このドキュメントでは、さまざまな外部ストレージサービスの[URI形式](#uri-format)、[認証](#authentication)、および[サーバー側の暗号化](#server-side-encryption)について紹介します。 ## TiKVに資格情報を送信する {#send-credentials-to-tikv} @@ -106,7 +106,7 @@ tiup br restore db --db test -u "${PD_IP}:2379" \ バックアップの前に、S3 上のバックアップディレクトリにアクセスするための次の権限を設定します。 -- バックアップ中に`s3:DeleteObject`およびバックアップ & リストア ( BR ) `s3:AbortMultipartUpload`バックアップディレクトリ`s3:GetObject`アクセスするための最小権限: `s3:ListBucket` 、および`s3:PutObject` +- バックアップ中に TiKV とバックアップ＆リストア（BR）がバックアップディレクトリにアクセスするための最小権限: `s3:ListBucket`、 `s3:GetObject`、 `s3:DeleteObject`、 `s3:PutObject`、および`s3:AbortMultipartUpload` - 復元中に TiKV とBRがバックアップディレクトリにアクセスするための最小権限: `s3:ListBucket`と`s3:GetObject` 。 バックアップディレクトリをまだ作成していない場合は、 [バケットを作成する](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)を参照して指定のリージョンに S3 バケットを作成してください。必要に応じて、 [フォルダを作成する](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-folders.html)を参照してバケット内にフォルダを作成することもできます。 @@ -185,7 +185,7 @@ TiKV で GCS WIF または ADC を使用する場合は、 `gcp_v2`外部スト > **Note:** > - > この方法を使用する場合は、手順 3 で TiKV を再起動する必要があります。クラスターを再起動できない場合は、 **方法 1: バックアップと復元のアクセスキーを指定する**を使用します。 + > この方法を使用する場合は、手順 3 で TiKV を再起動する必要があります。クラスターを再起動できない場合は、バックアップと復元に**方法 1: アクセスキーを指定する**を使用します。 1. このノードの TiKV ポートが`24000` 、つまり systemd サービスの名前が`tikv-24000`であるとします。 ```shell diff --git a/br/backup-and-restore-use-cases.md b/br/backup-and-restore-use-cases.md index 3d1c06d145407..80116d2e21c4d 100644 --- a/br/backup-and-restore-use-cases.md +++ b/br/backup-and-restore-use-cases.md @@ -5,18 +5,18 @@ summary: TiDBは、タイムリーなデータリカバリやビジネス監査 # TiDB バックアップと復元のユースケース {#tidb-backup-and-restore-use-cases} -[TiDB スナップショットのバックアップと復元ガイド](/br/br-snapshot-guide.md)と[TiDB ログバックアップと PITR ガイド](/br/br-pitr-guide.md) 、TiDBが提供するバックアップとリストアのソリューション、すなわちスナップショット（フル）バックアップとリストア、ログバックアップ、そしてポイントインタイムリカバリ（PITR）について紹介します。このドキュメントは、特定のユースケースにおいてTiDBのバックアップとリストアのソリューションを迅速に導入するのに役立ちます。 +[TiDB スナップショットのバックアップと復元ガイド](/br/br-snapshot-guide.md)と[TiDB ログバックアップと PITR ガイド](/br/br-pitr-guide.md)は、TiDBが提供するバックアップとリストアのソリューション、すなわちスナップショット（フル）バックアップとリストア、ログバックアップ、そしてポイントインタイムリカバリ（PITR）について紹介します。このドキュメントは、特定のユースケースにおいてTiDBのバックアップとリストアのソリューションを迅速に導入するのに役立ちます。 AWS に TiDB本番クラスターをデプロイし、ビジネスチームが次の要件をリクエストしているとします。 - データの変更はタイムリーにバックアップしてください。データベースに災害が発生した場合でも、最小限のデータ損失（許容できるのは数分間のデータ損失のみ）でアプリケーションを迅速に復旧できます。 -- 毎月、特定の時間に業務監査を実施します。監査依頼を受けた場合、リクエストに応じて過去1ヶ月間の特定の時点のデータにクエリを実行するためのデータベースを提供する必要があります。 +- 毎月、特定の時間を定めずに業務監査を実施します。監査依頼を受けた場合、リクエストに応じて過去1ヶ月間の特定の時点のデータにクエリを実行するためのデータベースを提供する必要があります。 PITR を使用すると、前述の要件を満たすことができます。 ## TiDBクラスタとBRをデプロイ {#deploy-the-tidb-cluster-and-br} -PITRを使用するには、TiDBクラスタ（v6.2.0以上）をデプロイし、 BRをTiDBクラスタと同じバージョンにアップデートする必要があります。このドキュメントでは、例としてv8.5.5を使用しています。 +PITRを使用するには、TiDBクラスタ（v6.2.0以上）をデプロイし、 BRをTiDBクラスタと同じバージョンにアップデートする必要があります。このドキュメントでは、例としてv{{{ .tidb-version }}}を使用しています。 次の表は、TiDB クラスターで PITR を使用するために推奨されるハードウェアリソースを示しています。 @@ -43,13 +43,13 @@ TiUPを使用してBRをインストールまたはアップグレードしま - インストール： ```shell - tiup install br:v8.5.5 + tiup install br:v{{{ .tidb-version }}} ``` - アップグレード: ```shell - tiup update br:v8.5.5 + tiup update br:v{{{ .tidb-version }}} ``` ## バックアップストレージ（Amazon S3）を構成する {#configure-backup-storage-amazon-s3} @@ -69,7 +69,7 @@ TiUPを使用してBRをインストールまたはアップグレードしま 2. BRとTiKVがS3ディレクトリにアクセスするための権限を設定します。S3バケットにアクセスする最も安全な方法であるIAMメソッドを使用して権限を付与することをお勧めします。詳細な手順については、 [AWS ドキュメント: ユーザーポリシーによるバケットへのアクセスの制御](https://docs.aws.amazon.com/AmazonS3/latest/userguide/walkthrough1.html)を参照してください。必要な権限は次のとおりです。 - - バックアップ クラスター内の TiKV とBRには`s3:GetObject` `s3://tidb-pitr-bucket/backup-data`ディレクトリ`s3:DeleteObject` `s3:ListBucket` 、および`s3:PutObject` `s3:AbortMultipartUpload`権限が必要です。 + - バックアップクラスター内のTiKVとBRには、 `s3://tidb-pitr-bucket/backup-data`ディレクトリの`s3:ListBucket`、 `s3:GetObject`、 `s3:DeleteObject`、 `s3:PutObject`、および`s3:AbortMultipartUpload`権限が必要です。 - 復元クラスター内の TiKV とBRには、 `s3://tidb-pitr-bucket/backup-data`ディレクトリの`s3:ListBucket`と`s3:GetObject`権限が必要です。 3. スナップショット (完全) バックアップやログバックアップなどのバックアップデータを保存するディレクトリ構造を計画します。 diff --git a/br/br-batch-create-table.md b/br/br-batch-create-table.md index 5d24ef8c2ddf8..f239a38a702a7 100644 --- a/br/br-batch-create-table.md +++ b/br/br-batch-create-table.md @@ -18,11 +18,11 @@ summary: TiDB v6.0.0では、データ復元時のテーブル作成プロセス 膨大な数のテーブル (たとえば 50,000 テーブル) を含むデータを復元する必要がある場合は、バッチ テーブル作成機能を使用して復元プロセスを高速化できます。 -詳しい効果については[バッチテーブル作成機能のテスト](#feature-test)ご覧ください。 +詳しい効果については[バッチテーブル作成機能のテスト](#feature-test)をご覧ください。 ## バッチテーブル作成を使用する {#use-batch-create-table} -BRはデフォルトでバッチテーブル作成機能を有効にします。v6.0.0以降では、復元プロセスを高速化するために、デフォルト設定は`--ddl-batch-size=128` 。そのため、このパラメータを設定する必要はありません。`--ddl-batch-size=128`は、バッチでテーブルを作成し、各バッチで128個のテーブルを作成することを意味します。 +BRはデフォルトでバッチテーブル作成機能を有効にします。v6.0.0以降では、復元プロセスを高速化するために、デフォルト設定は`--ddl-batch-size=128`です。そのため、このパラメータを設定する必要はありません。`--ddl-batch-size=128`は、バッチでテーブルを作成し、各バッチで128個のテーブルを作成することを意味します。 この機能を無効にするには、 `--ddl-batch-size`を`1`に設定します。以下のコマンド例をご覧ください。 @@ -62,4 +62,4 @@ tiup br restore full \ '[2022/03/12 22:37:49.060 +08:00] [INFO] [collector.go:67] ["Full restore success summary"] [total-ranges=751760] [ranges-succeed=751760] [ranges-failed=0] [split-region=1h33m18.078448449s] [restore-ranges=542693] [total-take=1h41m35.471476438s] [restore-data-size(after-compressed)=8.337TB] [Size=8336694965072] [BackupTS=431773933856882690] [total-kv=148015861383] [total-kv-size=16.16TB] [average-speed=2.661GB/s]' ``` -テスト結果から、1つの TiKV インスタンスを復元する平均速度は 181.65 MB/秒 ( `average-speed`に相当) であること`tikv_count`わかります。 +テスト結果から、1つの TiKV インスタンスを復元する平均速度は 181.65 MB/秒（ `average-speed`/`tikv_count`に相当）であることがわかります。 diff --git a/br/br-checkpoint-backup.md b/br/br-checkpoint-backup.md index 44528605ee306..a3210b9d9fba0 100644 --- a/br/br-checkpoint-backup.md +++ b/br/br-checkpoint-backup.md @@ -1,6 +1,6 @@ --- title: Checkpoint Backup -summary: TiDB v6.5.0では、中断されたバックアップを再開するためのチェックポイントバックアップ機能が導入され、最初からやり直す必要性が軽減されます。この機能はバックアップ済みのシャードを記録してバックアップを再開しますが、GCメカニズムに依存するため、一部のデータの再バックアップが必要になる場合があります。br`ツールは、データのガベージコレクションを回避するために定期的に`gc-safepoint`を更新し、必要に応じて保持期間を延長できます。 +summary: TiDB v6.5.0では、中断されたバックアップを再開するためのチェックポイントバックアップ機能が導入され、最初からやり直す必要性が軽減されます。この機能はバックアップ済みのシャードを記録してバックアップを再開しますが、GCメカニズムに依存するため、一部のデータの再バックアップが必要になる場合があります。`br`ツールは、データのガベージコレクションを回避するために定期的に`gc-safepoint`を更新し、必要に応じて保持期間を延長できます。 --- # チェックポイントバックアップ {#checkpoint-backup} @@ -15,11 +15,11 @@ TiDBクラスタが大規模で、障害発生後に再度バックアップを ## 実装の詳細 {#implementation-details} -スナップショットバックアップ中、 `br`テーブルを対応するキー空間にエンコードし、バックアップRPCリクエストを生成してTiKVノードに送信します。バックアップリクエストを受信すると、TiKVノードはリクエストされた範囲内のデータをバックアップします。TiKVノードは、リージョンのデータのバックアップを完了するたびに、この範囲のバックアップ情報を`br`に返します。 +スナップショットバックアップ中、 `br`はテーブルを対応するキー空間にエンコードし、バックアップRPCリクエストを生成してTiKVノードに送信します。バックアップリクエストを受信すると、TiKVノードはリクエストされた範囲内のデータをバックアップします。TiKVノードは、リージョンのデータのバックアップを完了するたびに、この範囲のバックアップ情報を`br`に返します。 -`br` TiKV ノードから返された情報を記録し、 `br`バックアップされたキー範囲を取得するのに役立ちます。チェックポイントバックアップ機能は、定期的に新しいバックアップ情報を外部ストレージにアップロードし、バックアップされたキー範囲を永続化します。 +`br`はTiKVノードから返された情報を記録し、 `br`がバックアップされたキー範囲を取得するのに役立ちます。チェックポイントバックアップ機能は、定期的に新しいバックアップ情報を外部ストレージにアップロードし、バックアップされたキー範囲を永続化します。 -`br`バックアップを再試行する際、外部ストレージからバックアップ済みのキー範囲を読み取り、バックアップタスクのキー範囲と比較します。この差分データは、 `br`チェックポイントバックアップでまだバックアップする必要があるキー範囲を特定するのに役立ちます。 +`br`がバックアップを再試行する際、外部ストレージからバックアップ済みのキー範囲を読み取り、バックアップタスクのキー範囲と比較します。この差分データは、 `br`がチェックポイントバックアップでまだバックアップする必要があるキー範囲を特定するのに役立ちます。 ## 使用制限 {#usage-limitations} @@ -31,7 +31,7 @@ TiDBクラスタが大規模で、障害発生後に再度バックアップを このような状況を回避するため、 `gcttl`が指定されていない場合、 `br`はデフォルトで`gc-safepoint`を約1時間保持します。必要に応じて、 `gcttl`パラメータを設定することで保持期間を延長できます。 -次の例では、 `gcttl` 15時間 (54000秒) に設定して、保持期間`gc-safepoint`を延長します。 +次の例では、 `gcttl`を15時間 (54000秒) に設定して、 `gc-safepoint`の保持期間を延長します。 ```shell tiup br backup full \ @@ -45,8 +45,8 @@ tiup br backup full \ ### 一部のデータは再度バックアップする必要があります {#some-data-needs-to-be-backed-up-again} -`br`バックアップを再試行する場合、バックアップ中のデータやチェックポイントで記録されていないデータなど、バックアップ済みのデータの一部を再度バックアップする必要がある場合があります。 +`br`がバックアップを再試行する場合、バックアップ中のデータやチェックポイントで記録されていないデータなど、バックアップ済みのデータの一部を再度バックアップする必要がある場合があります。 -- 中断の原因がエラーである場合、 `br`終了前にバックアップされたデータのメタ情報を保持します。この場合、次回の再試行では、バックアップ中のデータのみを再度バックアップする必要があります。 +- 中断の原因がエラーである場合、 `br`は終了前にバックアップされたデータのメタ情報を保持します。この場合、次回の再試行では、バックアップ中のデータのみを再度バックアップする必要があります。 - `br`プロセスがシステムによって中断された場合、 `br`は外部ストレージにバックアップされたデータのメタ情報を永続化できません。`br`は30秒ごとにメタ情報を永続化するため、中断前の30秒間にバックアップされたデータは永続化できず、次回の再試行時に再度バックアップする必要があります。 diff --git a/br/br-checkpoint-restore.md b/br/br-checkpoint-restore.md index 640088bf2a2e5..7a705fe180ec6 100644 --- a/br/br-checkpoint-restore.md +++ b/br/br-checkpoint-restore.md @@ -27,7 +27,7 @@ TiDBクラスタが大規模で、障害発生後に再度リストアを行う MVCC (Multi-Version Concurrency Control) メカニズムを使用しているため、指定されたタイムスタンプを持つデータを、順不同かつ繰り返し書き込むことができます。 -スナップショット復元を使用してデータベースまたはテーブルのDDLを復元する場合、パラメータ`ifExists`が追加されます。既に作成済みとみなされる既存のデータベースまたはテーブルの場合、パラメータ`br`を指定すると復元は自動的にスキップされます。 +スナップショット復元を使用してデータベースまたはテーブルのDDLを復元する場合、パラメータ`ifExists`が追加されます。既に作成済みとみなされる既存のデータベースまたはテーブルの場合、 `br`は自動的に復元をスキップします。 ### ログの復元 {#log-restore} diff --git a/br/br-incremental-guide.md b/br/br-incremental-guide.md index 31b81880118bb..40eb837f5691d 100644 --- a/br/br-incremental-guide.md +++ b/br/br-incremental-guide.md @@ -31,7 +31,7 @@ TiDBクラスターの増分データは、期間の開始スナップショッ 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 間の増分データをバックアップします。 +次のコマンドは、 `(LAST_BACKUP_TS, current PD timestamp]`の間の増分データと、この期間中に生成された DDL をバックアップします。 ```shell tiup br backup full --pd "${PD_IP}:2379" \ diff --git a/br/br-log-architecture.md b/br/br-log-architecture.md index 81a3f0c3cad7a..1c41a53819207 100644 --- a/br/br-log-architecture.md +++ b/br/br-log-architecture.md @@ -52,7 +52,7 @@ sequenceDiagram - **ローカルメタデータ**：ローカルチェックポイントts、グローバルチェックポイントts、バックアップファイル情報など、単一のTiKVノードによってバックアップされたメタデータを示します。 - **ローカルチェックポイント ts** (ローカルメタデータ内): この TiKV ノードでローカルチェックポイント ts より前に生成されたすべてのログがターゲットストレージにバックアップされたことを示します。 - **グローバルチェックポイント ts** ：すべての TiKV ノードでグローバルチェックポイント ts より前に生成されたすべてのログがターゲットストレージにバックアップされたことを示します。TiDB コーディネーターは、すべての TiKV ノードのローカルチェックポイント ts を収集してこのタイムスタンプを計算し、PD に報告します。 -- **TiDBコーディネーター**：TiDBノードがコーディネーターとして選出され、ログバックアップタスク全体（グローバルチェックポイントタスク）の進捗状況を収集および計算する役割を担います。このコンポーネントはステートレスな設計となっており、障害発生後は、稼働中のTiDBノードから新しいコーディネーターが選出されます。 +- **TiDBコーディネーター**：TiDBノードがコーディネーターとして選出され、ログバックアップタスク全体（グローバルチェックポイントts）の進捗状況を収集および計算する役割を担います。このコンポーネントはステートレスな設計となっており、障害発生後は、稼働中のTiDBノードから新しいコーディネーターが選出されます。 - **TiKVログバックアップオブザーバー**：TiDBクラスタ内の各TiKVノードで実行され、ログデータのバックアップを担当します。TiKVノードに障害が発生した場合、リージョンリーダーの再選出後、他のTiKVノードがそのノードのデータ範囲のバックアップを引き継ぎ、グローバルチェックポイントtsから始まる障害範囲のデータをバックアップします。 バックアップの全手順は以下のとおりです。 @@ -68,7 +68,7 @@ sequenceDiagram 3. ログバックアップオブザーバーは、KVの変更ログを継続的にバックアップします。 - - **Read kv Change data** : KV 変更データを読み取り、変更ログ[カスタム形式でバックアップファイル](#log-backup-files)に保存します。 + - **KV変更データの読み取り**：KV 変更データを読み取り、変更ログ[カスタム形式でバックアップファイル](#log-backup-files)に保存します。 - **グローバルチェックポイントtsの取得**：PDからグローバルチェックポイントtsを取得します。 - **ローカルメタデータの生成**：ローカルチェックポイントts、グローバルチェックポイントts、バックアップファイル情報など、バックアップタスクのローカルメタデータを生成します。 - **ログデータとメタデータのアップロード**：バックアップファイルとローカルメタデータを定期的にターゲットストレージにアップロードします。 diff --git a/br/br-monitoring-and-alert.md b/br/br-monitoring-and-alert.md index 4e85df32810fa..1140f860b980f 100644 --- a/br/br-monitoring-and-alert.md +++ b/br/br-monitoring-and-alert.md @@ -68,7 +68,7 @@ PITR でアラート項目を構成するには、次の手順に従います。 #### ログバックアップ実行RPO10分以上 {#logbackuprunningrpomorethan10m} -- 警告項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 60 > 10 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 0` +- アラート項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 60 > 10 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 0` - 警戒レベル：警告 - 説明: ログデータが10分以上ストレージに保存されていません。このアラートはリマインダーです。ほとんどの場合、ログバックアップには影響しません。 @@ -89,30 +89,30 @@ groups: #### ログバックアップ実行RPO30分以上 {#logbackuprunningrpomorethan30m} -- 警告項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 60 > 30 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 0` +- アラート項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 60 > 30 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 0` - 警戒レベル: 重大 - 説明: ログデータが30分以上ストレージに保存されていません。このアラートは多くの場合、異常を示しています。原因を特定するには、TiKVログを確認してください。 #### ログバックアップ一時停止中 (2時間以上) {#logbackuppausingmorethan2h} -- 警告項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 3600 > 2 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 1` +- アラート項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 3600 > 2 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 1` - 警戒レベル：警告 - 説明: ログバックアップタスクが2時間以上一時停止されています。このアラートはリマインダーであり、できるだけ早く`br log resume`を実行してください。 #### ログバックアップ一時停止中（12時間以上） {#logbackuppausingmorethan12h} -- 警告項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 3600 > 12 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 1` +- アラート項目: `max(time() - tidb_log_backup_last_checkpoint / 262144000) by (task) / 3600 > 12 and max(tidb_log_backup_last_checkpoint) by (task) > 0 and max(tikv_log_backup_task_status) by (task) == 1` - 警戒レベル: 重大 - 説明: ログバックアップタスクが12時間以上一時停止されています。タスクを再開するには、できるだけ早く`br log resume`を実行してください。ログタスクの一時停止時間が長すぎると、データが失われるリスクがあります。 #### ログバックアップ失敗 {#logbackupfailed} -- 警告項目: `max(tikv_log_backup_task_status) by (task) == 2 and max(tidb_log_backup_last_checkpoint) by (task) > 0` +- アラート項目: `max(tikv_log_backup_task_status) by (task) == 2 and max(tidb_log_backup_last_checkpoint) by (task) > 0` - 警戒レベル: 重大 - 説明: ログバックアップタスクが失敗しました。失敗の原因を確認するには、 `br log status`を実行する必要があります。必要に応じて、TiKV ログをさらに確認する必要があります。 #### ログバックアップGCセーフポイントがチェックポイントを超える {#logbackupgcsafepointexceedscheckpoint} -- 警告項目: `min(tidb_log_backup_last_checkpoint) by (instance) - max(tikv_gcworker_autogc_safe_point) by (instance) < 0` +- アラート項目: `min(tidb_log_backup_last_checkpoint) by (instance) - max(tikv_gcworker_autogc_safe_point) by (instance) < 0` - 警戒レベル: 重大 - 説明: バックアップ前に一部のデータがガベージコレクションされました。これは、一部のデータが失われており、サービスに影響を与える可能性が非常に高いことを意味します。 diff --git a/br/br-pitr-guide.md b/br/br-pitr-guide.md index 029e40e71a5e7..22a1556ed1ac9 100644 --- a/br/br-pitr-guide.md +++ b/br/br-pitr-guide.md @@ -50,7 +50,7 @@ checkpoint[global]: 2022-05-13 11:31:47.2 +0800; gap=4m53s フィールドの説明は次のとおりです。 - `name` : ログバックアップタスクの名前。 -- `status` : ログバックアップタスクのステータス`NORMAL` 、 `PAUSED` 、 `ERROR`を含む)。 +- `status` : ログバックアップタスクのステータス（ `NORMAL` 、 `PAUSED` 、 `ERROR`を含む）。 - `start` : ログバックアップタスクの開始タイムスタンプ。 - `end` : ログバックアップタスクの終了タイムスタンプ。現在、このフィールドは無効です。 - `storage` : ログバックアップの外部ストレージの URI。 @@ -90,7 +90,7 @@ tiup br restore point --pd "${PD_IP}:2379" \ --restored-ts '2022-05-15 18:00:00+0800' ``` -データ復元中は、ターミナルのプログレスバーで進行状況を確認できます。復元は、完全復元とログ復元（メタファイルの復元とKVファイルの復元）の2つのフェーズに分かれています。各フェーズが完了すると、復元時間やデータサイズなどの情報が`br`されます。 +データ復元中は、ターミナルのプログレスバーで進行状況を確認できます。復元は、完全復元とログ復元（メタファイルの復元とKVファイルの復元）の2つのフェーズに分かれています。各フェーズが完了すると、 `br`は復元時間やデータサイズなどの情報を出力します。 ```shell Split&Scatter Region <--------------------------------------------------------------------------------------------------------------------------------------------------------> 100.00% diff --git a/br/br-snapshot-architecture.md b/br/br-snapshot-architecture.md index 54030e16bdcce..ea6a27b1f90d8 100644 --- a/br/br-snapshot-architecture.md +++ b/br/br-snapshot-architecture.md @@ -48,7 +48,7 @@ sequenceDiagram 2. BRはバックアップデータのスケジュールを設定します。 - - **GCの一時停止**： BRは、TiDB [TiDB GCメカニズム](/garbage-collection-overview.md)によってバックアップデータがクリーンアップされないように、TiDB GCの時間を設定します。 + - **GCの一時停止**： BRは、 [TiDB GCメカニズム](/garbage-collection-overview.md)によってバックアップデータがクリーンアップされないように、TiDB GCの時間を設定します。 - **TiKV とリージョン情報の取得**: BR はPD にアクセスして、すべての TiKV ノードのアドレスとデータの[リージョン](/tidb-storage.md#region)分布を取得します。 - **TiKVにデータバックアップを依頼する**： BRはバックアップ依頼を作成し、すべてのTiKVノードに送信します。バックアップ依頼には、バックアップのタイミング、バックアップ対象のリージョン、およびストレージパスが含まれます。 diff --git a/br/br-snapshot-guide.md b/br/br-snapshot-guide.md index dc0f41c9580c1..cb483bb44c32d 100644 --- a/br/br-snapshot-guide.md +++ b/br/br-snapshot-guide.md @@ -5,7 +5,7 @@ summary: このドキュメントでは、brコマンドラインツールを使 # スナップショットのバックアップと復元ガイド {#snapshot-backup-and-restore-guide} -このドキュメントでは、br コマンドラインツール (以下`br`と呼びます) を使用して TiDB スナップショットをバックアップおよび復元する方法について説明します。データをバックアップおよび復元する前に、 [brコマンドラインツールをインストールします](/br/br-use-overview.md#deploy-and-use-br)必要があります。 +このドキュメントでは、br コマンドラインツール (以下`br`と呼びます) を使用して TiDB スナップショットをバックアップおよび復元する方法について説明します。データをバックアップおよび復元する前に、 [brコマンドラインツールをインストールする](/br/br-use-overview.md#deploy-and-use-br)必要があります。 スナップショットバックアップを使用すると、クラスタ全体をバックアップできます。これは[マルチバージョン同時実行制御 (MVCC)](/tidb-storage.md#mvcc)に基づいており、指定されたスナップショット内のすべてのデータをターゲットストレージにバックアップします。バックアップデータのサイズは、クラスタ内の圧縮された単一レプリカのサイズとほぼ同じです。バックアップが完了したら、バックアップデータを空のクラスタまたは競合データを含まないクラスタ（同じスキーマまたは同じテーブルを持つクラスタ）に復元したり、クラスタをスナップショットバックアップの時点に復元したり、クラスタレプリカ設定に従って複数のレプリカを復元したりできます。 @@ -18,7 +18,7 @@ summary: このドキュメントでは、brコマンドラインツールを使 > **Note:** > -> - 以下の例では、Amazon S3 アクセスキーとシークレット キーを使用して権限を認証することを前提としていますIAMロールを使用して権限を認証する場合は、 `--send-credentials-to-tikv` `false`に設定する必要があります。 +> - 以下の例では、Amazon S3 アクセスキーとシークレット キーを使用して権限を認証することを前提としています。IAMロールを使用して権限を認証する場合は、 `--send-credentials-to-tikv`を`false`に設定する必要があります。 > - 他のストレージシステムまたは認証方法を使用して権限を認証する場合は、[バックアップストレージ](/br/backup-and-restore-storages.md)に従ってパラメータ設定を調整します。 `tiup br backup full`コマンドを実行すると、TiDB クラスタのスナップショットをバックアップできます。ヘルプ情報を表示するには、 `tiup br backup full --help`を実行してください。 @@ -31,7 +31,7 @@ tiup br backup full --pd "${PD_IP}:2379" \ 前述のコマンドでは： -- `--backupts` : スナップショットのタイムポイント。形式は[TSO](/tso.md)またはタイムスタンプで、 `400036290571534337`や`2018-05-11 01:42:23 +08:00`などです。このスナップショットのデータがガベージコレクションされると、 `tiup br backup`コマンドはエラーを返し、 `br`は終了します。タイムスタンプを使用してバックアップする場合は、タイムゾーンも指定することをお勧めします。そうしないと、 `br`はデフォルトでローカルタイムゾーンを使用してタイムスタンプを構築するため、バックアップのタイムポイントが正しくない可能性があります。このパラメーターを指定しない場合、 `br`バックアップ開始時刻に対応するスナップショットを選択します。 +- `--backupts` : スナップショットのタイムポイント。形式は[TSO](/tso.md)またはタイムスタンプで、 `400036290571534337`や`2018-05-11 01:42:23 +08:00`などです。このスナップショットのデータがガベージコレクションされると、 `tiup br backup`コマンドはエラーを返し、 `br`は終了します。タイムスタンプを使用してバックアップする場合は、タイムゾーンも指定することをお勧めします。そうしないと、 `br`はデフォルトでローカルタイムゾーンを使用してタイムスタンプを構築するため、バックアップのタイムポイントが正しくない可能性があります。このパラメーターを指定しない場合、 `br`はバックアップ開始時刻に対応するスナップショットを選択します。 - `--storage` : バックアップデータのストレージアドレス。スナップショットバックアップは、Amazon S3、Google Cloud Storage、および Azure Blob Storage をバックアップストレージとしてサポートします。前述のコマンドでは、例として Amazon S3 を使用しています。詳細については、[外部ストレージサービスのURI形式](/external-storage-uri.md)を参照してください。 バックアップ中は、下図のように端末に進行状況バーが表示されます。進行状況バーが100%に達すると、バックアップタスクが完了し、合計バックアップ時間、平均バックアップ速度、バックアップデータサイズなどの統計情報が表示されます。 @@ -147,9 +147,9 @@ tiup br restore full \ ### `mysql`スキーマ内のテーブルを復元する {#restore-tables-in-the-mysql-schema} -- BR v5.1.0以降では、スナップショットをバックアップすると、 BRは`mysql`スキーマ内の**システムテーブルを**自動的にバックアップしますが、デフォルトではこれらのシステムテーブルを復元しません。 -- バージョン6.2.0以降、 BRでは`--with-sys-table`を指定して、**一部のシステムテーブルのデータを**復元できます。 -- バージョン7.6.0以降、 BRは`--with-sys-table`デフォルトで有効にしており、これはBRがデフォルトで**一部のシステムテーブルのデータを**復元することを意味します。 +- BR v5.1.0以降では、スナップショットをバックアップすると、 BRは`mysql`スキーマ内の**システムテーブル**を自動的にバックアップしますが、デフォルトではこれらのシステムテーブルを復元しません。 +- バージョン6.2.0以降、 BRでは`--with-sys-table`を指定して、**一部のシステムテーブルのデータ**を復元できます。 +- バージョン7.6.0以降、 BRは`--with-sys-table`デフォルトで有効にしており、これはBRがデフォルトで**一部のシステムテーブルのデータ**を復元することを意味します。 - バージョン 8.5.5 以降、 BRシステムテーブルの物理的な復元をサポートする`--fast-load-sys-tables`パラメーターが導入されました。このパラメーターはデフォルトで有効になっています。この方式では`RENAME TABLE` DDL文を使用して、 `__TiDB_BR_Temporary_mysql`データベースのシステムテーブルと`mysql`データベースのシステムテーブルをアトミックに交換します。 `REPLACE INTO` SQL文を使用したシステムテーブルの論理的な復元とは異なり、物理的な復元ではシステムテーブル内の既存のデータが完全に上書きされます。 **BRは、以下のシステムテーブルのデータを復元できます。** @@ -201,7 +201,7 @@ tiup br restore full \ - ターゲットクラスタは、バックアップデータと同じシステムテーブルを持っています。 - 対象クラスタのシステム権限テーブルの**列数は**、バックアップデータの列数と同じです。列の順序は重要ではありません。 -- 対象クラスタのシステム権限テーブルの列は、バックアップデータの列と互換性があります。列のデータ型が長さを持つ型（整数や文字列など）の場合、対象クラスタの長さはバックアップデータの長さ以上でなければなりません。列のデータ型が`ENUM`型の場合、対象クラスタの`ENUM`値の数のスーパーセットでなければなりません。 +- 対象クラスタのシステム権限テーブルの列は、バックアップデータの列と互換性があります。列のデータ型が長さを持つ型（整数や文字列など）の場合、対象クラスタの長さはバックアップデータの長さ以上でなければなりません。列のデータ型が`ENUM`型の場合、対象クラスタの`ENUM`値の数は、バックアップデータの`ENUM`値の数のスーパーセットでなければなりません。 ## パフォーマンスと影響 {#performance-and-impact} diff --git a/br/br-snapshot-manual.md b/br/br-snapshot-manual.md index 20b818db5a3f2..f32ae287e5d40 100644 --- a/br/br-snapshot-manual.md +++ b/br/br-snapshot-manual.md @@ -41,7 +41,7 @@ tiup br backup full \ 上記のコマンドでは、次のようになります。 -- `--backupts` : スナップショットの時点。形式は[TSO](/tso.md)またはタイムスタンプ（例： `400036290571534337` 、 `2024-06-28 13:30:00 +08:00`です。このスナップショットのデータがガベージコレクションされた場合、 `tiup br backup`コマンドはエラーを返し、 'br' は終了します。このパラメータを指定しない場合、 `br`バックアップ開始時刻に対応するスナップショットを選択します。 +- `--backupts` : スナップショットの時点。形式は[TSO](/tso.md)またはタイムスタンプ（例： `400036290571534337` 、 `2024-06-28 13:30:00 +08:00` ）です。このスナップショットのデータがガベージコレクションされた場合、 `tiup br backup`コマンドはエラーを返し、 'br' は終了します。このパラメータを指定しない場合、 `br`はバックアップ開始時刻に対応するスナップショットを選択します。 - `--log-file` : `br`ログが書き込まれる対象ファイル。 > **Note:** @@ -73,7 +73,7 @@ tiup br backup db \ --log-file backuptable.log ``` -上記のコマンドでは、 `--db`データベース名を指定し、その他のパラメータは[TiDB クラスターのスナップショットをバックアップする](#back-up-cluster-snapshots)と同じです。 +上記のコマンドでは、 `--db`はデータベース名を指定し、その他のパラメータは[TiDB クラスターのスナップショットをバックアップする](#back-up-cluster-snapshots)と同じです。 ### テーブルをバックアップする {#back-up-a-table} @@ -90,7 +90,7 @@ tiup br backup table \ --log-file backuptable.log ``` -上記のコマンドでは、 `--db`と`--table`それぞれデータベース名とテーブル名を指定し、その他のパラメータは[TiDB クラスターのスナップショットをバックアップする](#back-up-cluster-snapshots)と同じです。 +上記のコマンドでは、 `--db`と`--table`はそれぞれデータベース名とテーブル名を指定し、その他のパラメータは[TiDB クラスターのスナップショットをバックアップする](#back-up-cluster-snapshots)と同じです。 ### テーブルフィルターを使用して複数のテーブルをバックアップする {#back-up-multiple-tables-with-table-filter} @@ -133,7 +133,7 @@ tiup br restore full \ バックアップと復元機能は、データをバックアップする際に、統計情報をJSON形式で`backupmeta`ファイルに保存します。データを復元する際には、JSON形式の統計情報をクラスターに読み込みます。詳細については、 [LOAD STATS](/sql-statements/sql-statement-load-stats.md)を参照してください。 -v8.5.5以降、 BRは`--fast-load-sys-tables`パラメータを導入し、デフォルトで有効になっています。`br`ラインツールを使用して新しいクラスターにデータを復元する場合、上流クラスターと下流クラスター間のテーブルとパーティションのIDを再利用できます（そうでない場合、 BRは自動的に統計を論理的にロードします） `--fast-load-sys-tables`を有効にすると、 BRはまず統計関連のシステムテーブルを一時システムデータベース`__TiDB_BR_Temporary_mysql`に復元し、次に`RENAME TABLE`文を使用してこれらのテーブルを`mysql`データベース内の対応するテーブルとアトミックにスワップします。 +v8.5.5以降、 BRは`--fast-load-sys-tables`パラメータを導入し、デフォルトで有効になっています。`br`コマンドラインツールを使用して新しいクラスターにデータを復元する場合、上流クラスターと下流クラスター間のテーブルとパーティションのIDを再利用できます（そうでない場合、 BRは自動的に統計を論理的にロードします）。 `--fast-load-sys-tables`を有効にすると、 BRはまず統計関連のシステムテーブルを一時システムデータベース`__TiDB_BR_Temporary_mysql`に復元し、次に`RENAME TABLE`文を使用してこれらのテーブルを`mysql`データベース内の対応するテーブルとアトミックにスワップします。 次に例を示します。 @@ -144,7 +144,7 @@ tiup br restore full \ ## バックアップデータを暗号化する {#encrypt-the-backup-data} -BRはバックアップ側でのバックアップデータの暗号化と[Amazon S3にバックアップする際のストレージ側](/br/backup-and-restore-storages.md#amazon-s3-server-side-encryption)サポートしています。必要に応じていずれかの暗号化方式を選択できます。 +BRはバックアップ側でのバックアップデータの暗号化と[Amazon S3にバックアップする際のストレージ側](/br/backup-and-restore-storages.md#amazon-s3-server-side-encryption)での暗号化をサポートしています。必要に応じていずれかの暗号化方式を選択できます。 TiDB v5.3.0 以降では、次のパラメータを設定することでバックアップデータを暗号化できます。 diff --git a/br/br-use-overview.md b/br/br-use-overview.md index 33266dd1ba3ad..05b5be31a7073 100644 --- a/br/br-use-overview.md +++ b/br/br-use-overview.md @@ -16,7 +16,7 @@ TiDB のバックアップおよび復元機能を使用する前に、推奨さ **TiDBには2種類のバックアップがあります。どちらを使用すればよいでしょうか？**フルバックアップには、特定の時点におけるクラスターの全データが含まれます。ログバックアップには、TiDBに書き込まれたデータの変更が含まれます。両方のバックアップを同時に使用することをお勧めします。 - **ログバックアップの開始**： `tiup br log start`のコマンドを実行してログバックアップタスクを開始します。その後、タスクはすべてのTiKVノードで実行され続け、TiDBデータの変更を小さなバッチで指定されたストレージに定期的にバックアップします。 -- **スナップショット（フル）バックアップを定期的に実行する**： `tiup br backup full`のコマンドを実行して、クラスターのスナップショットを指定されたストレージにバックアップします。例えば、毎日午前0時にクラスターのスナップショットをバックアップします。 +- **スナップショット（フル）バックアップを定期的に実行する**： `tiup br backup full`のコマンドを実行して、クラスターのスナップショットを指定されたストレージにバックアップします。例えば、毎日午前0時にクラスターのスナップショットをバックアップします。 ### バックアップデータを管理するにはどうすればいいですか? {#how-to-manage-backup-data} @@ -35,7 +35,7 @@ BRは基本的なバックアップと復元機能のみを提供し、バック TiDB クラスターを独自に構築したデータセンターに導入する場合は、次のプラクティスが推奨されます。 -- バックアップストレージシステムとして[MinIO](https://docs.min.io/docs/minio-quickstart-guide.html)構築し、S3 プロトコルを使用してデータを MinIO にバックアップします。 +- バックアップストレージシステムとして[MinIO](https://docs.min.io/docs/minio-quickstart-guide.html)を構築し、S3 プロトコルを使用してデータを MinIO にバックアップします。 - ネットワークファイルシステム (NFS、NAS など) ディスクを br コマンドラインツールとすべての TiKV インスタンスにマウントし、POSIX ファイルシステム インターフェイスを使用して、バックアップデータを対応する NFS ディレクトリに書き込みます。 > **Note:** @@ -60,7 +60,7 @@ TiDB クラスターを独自に構築したデータセンターに導入する - 完全バックアップデータのみを復元するには、 `tiup br restore`を使用して、指定したバックアップの完全復元を実行できます。 - ログバックアップを開始し、定期的に完全バックアップを実行している場合は、 `tiup br restore point`コマンドを実行して、バックアップ保持期間内の任意の時点にデータを復元できます。 -## BRをデプロイて使用する {#deploy-and-use-br} +## BRをデプロイして使用する {#deploy-and-use-br} BRをデプロイするには、次の要件が満たされていることを確認してください。 @@ -75,7 +75,7 @@ BRをデプロイするには、次の要件が満たされていることを確 TiDB は、br コマンドラインツールを使用したバックアップと復元をサポートしています。 -- `tiup install br`コマンドを[TiUPオンラインを使用してbrコマンドラインツールをインストールする](/migration-tools.md#install-tools-using-tiup)まで実行できます。 +- `tiup install br`コマンドを実行して、 [TiUPオンラインを使用してbrコマンドラインツールをインストールする](/migration-tools.md#install-tools-using-tiup)ことができます。 - `br`コマンドを使用してデータをバックアップおよび復元する方法の詳細については、次のドキュメントを参照してください。 - [TiDB スナップショットのバックアップと復元ガイド](/br/br-snapshot-guide.md) @@ -92,7 +92,7 @@ TiDB は、SQL文を使用した完全バックアップと復元をサポート ### Kubernetes でTiDB Operatorを使用する {#use-tidb-operator-on-kubernetes} -Kubernetesでは、 TiDB Operatorを使用してTiDBクラスターのデータをAmazon S3、GCS、またはAzure Blob Storageにバックアップし、これらのシステムにあるバックアップデータからデータを復元できます。詳細は[TiDB Operatorを使用したデータのバックアップと復元](https://docs.pingcap.com/tidb-in-kubernetes/stable/backup-restore-overview)ご覧ください。 +Kubernetesでは、 TiDB Operatorを使用してTiDBクラスターのデータをAmazon S3、GCS、またはAzure Blob Storageにバックアップし、これらのシステムにあるバックアップデータからデータを復元できます。詳細は[TiDB Operatorを使用したデータのバックアップと復元](https://docs.pingcap.com/tidb-in-kubernetes/stable/backup-restore-overview)をご覧ください。 ## 参照 {#see-also} diff --git a/br/use-br-command-line-tool.md b/br/use-br-command-line-tool.md index 8b7761b9c2bee..c74d2663c0822 100644 --- a/br/use-br-command-line-tool.md +++ b/br/use-br-command-line-tool.md @@ -1,6 +1,6 @@ --- title: br Command-line Manual -summary: br` コマンドラインツールは、TiDB クラスターのスナップショットバックアップ、ログバックアップ、およびポイントインタイムリカバリ (PITR) に使用されます。サブコマンド、オプション、およびパラメータで構成されており、PD サービスアドレスの `--pd` やストレージパスの `-s` などの共通オプションがあります。サブコマンドには、それぞれ特定の機能を持つ `tiup br backup`、`tiup br log`、`tiup br restore` などがあります。バックアップコマンドには `full`、`db`、`table` オプションがあり、ログバックアップおよびリストアコマンドには、バックアップ操作を管理するためのさまざまなタスクがあります。 +summary: "`br` コマンドラインツールは、TiDB クラスターのスナップショットバックアップ、ログバックアップ、およびポイントインタイムリカバリ (PITR) に使用されます。サブコマンド、オプション、およびパラメータで構成されており、PDサービスアドレスの `--pd` やストレージパスの `-s` などの共通オプションがあります。サブコマンドには、それぞれ特定の機能を持つ `tiup br backup`、`tiup br log`、`tiup br restore` などがあります。バックアップコマンドには `full`、`db`、`table` オプションがあり、ログバックアップおよびリストアコマンドには、バックアップ操作を管理するためのさまざまなタスクがあります。" --- # br コマンドラインマニュアル {#br-command-line-manual} @@ -9,7 +9,7 @@ summary: br` コマンドラインツールは、TiDB クラスターのスナ ## `br`コマンドラインの説明 {#br-command-line-description} -`br`コマンドは、サブコマンド、オプション、パラメータで構成されます。サブコマンドとは、 `-`または`--`含まない文字です。オプションとは、 `-`または`--`で始まる文字です。パラメータとは、サブコマンドまたはオプションの直後に続く文字で、サブコマンドまたはオプションに渡されます。 +`br`コマンドは、サブコマンド、オプション、パラメータで構成されます。サブコマンドとは、 `-`または`--`を含まない文字です。オプションとは、 `-`または`--`で始まる文字です。パラメータとは、サブコマンドまたはオプションの直後に続く文字で、サブコマンドまたはオプションに渡されます。 以下は完全な`br`コマンドです。 @@ -22,8 +22,8 @@ tiup br backup full --pd "${PD_IP}:2379" \ - `backup` : `tiup br`のサブコマンド。 - `full` : `tiup br backup`のサブコマンド。 -- `-s` (または`--storage` ): バックアップファイルが保存されるパスを指定するオプション。`"s3://backup-data/snapshot-202209081330/"`は`-s`のパラメーターです。 -- `--pd` : PD サービス アドレスを指定するオプション`"${PD_IP}:2379"`は`--pd`のパラメーターです。 +- `-s` (または`--storage` ): バックアップファイルが保存されるパスを指定するオプション。`"s3://backup-data/snapshot-202209081330/"`は`-s`のパラメータです。 +- `--pd` : PDサービスアドレスを指定するオプション。 `"${PD_IP}:2379"`は`--pd`のパラメータです。 ### コマンドとサブコマンド {#commands-and-sub-commands} @@ -34,17 +34,17 @@ tiup br backup full --pd "${PD_IP}:2379" \ - `tiup br restore` : TiDB クラスターのバックアップデータを復元するために使用されます。 - `tiup br debug` : バックアップメタデータの解析、バックアップデータのチェックなどに使用されます。 -`tiup br backup`および`tiup br restore`は次のサブコマンドが含まれます。 +`tiup br backup`および`tiup br restore`には次のサブコマンドが含まれます。 -- `full` : すべてのクラスター データをバックアップまたは復元するために使用されます。 +- `full` : すべてのクラスターデータをバックアップまたは復元するために使用されます。 - `db` : クラスターの指定されたデータベースをバックアップまたは復元するために使用されます。 - `table` : クラスターの指定されたデータベース内の単一のテーブルをバックアップまたは復元するために使用されます。 `tiup br debug`には次のサブコマンドが含まれます。 -- `checksum` : (隠しパラメーター) バックアップデータの整合性をオフラインでチェックし、すべてのバックアップファイルが[`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md)で計算された CRC64 チェックサム結果と一致することを確認するために使用されます。 +- `checksum` : (隠しパラメータ) バックアップデータの整合性をオフラインでチェックし、すべてのバックアップファイルが[`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md)で計算された CRC64 チェックサム結果と一致することを確認するために使用されます。 - `backupmeta` : バックアップデータファイル間に交差が存在するかどうかを確認するために使用されます。通常、バックアップデータファイルは交差しません。 -- `decode` : 完全バックアップのメタデータファイル`backupmeta` JSON形式に解析するために使用されます。さらに、 `--field`パラメータを使用して特定のフィールドを解析することもできます。 +- `decode` : 完全バックアップのメタデータファイル`backupmeta`をJSON形式に解析するために使用されます。さらに、 `--field`パラメータを使用して特定のフィールドを解析することもできます。 - `encode` : 完全バックアップの`backupmeta.json`メタデータファイルを、データの復元中に使用される protobuf 形式にエンコードするために使用されます。 - `reset-pd-config-as-default` : (非推奨) データ回復プロセス中に変更された PD 構成をデフォルト構成に復元するために使用されます。 - `search-log-backup` : ログバックアップデータ内の特定のキー情報を検索するために使用されます。 @@ -56,7 +56,7 @@ tiup br backup full --pd "${PD_IP}:2379" \ - `--ca` : PEM 形式の信頼された CA 証明書へのパスを指定します。 - `--cert` : PEM 形式の SSL 証明書へのパスを指定します。 - `--key` : PEM 形式の SSL 証明書キーへのパスを指定します。 -- `--status-addr` : `br` Prometheus に統計を提供するリスニング アドレスを指定します。 +- `--status-addr` : `br`がPrometheusに統計を提供するリスニングアドレスを指定します。 - `--concurrency` : バックアップタスクを複数のリクエストに分割し、同じ TiKV ノードに同時に送信する方法を制御します。このパラメータは主にBRから TiKV へのリクエスト分割の粒度に影響し、全体的なバックアップスループットを直接決定するものではありません。ほとんどの場合、この値を変更する必要はありません。バックアップパフォーマンスを向上させるには、代わりに[`tikv.backup.num-threads`](/tikv-configuration-file.md#num-threads-1)を調整することを推奨します。 - `--pitr-concurrency` : ログ復元中の同時タスクの数。 - `--tikv-max-restore-concurrency` : スナップショット復元中の TiKV ノードあたりの同時タスクの最大数。