このドキュメントでは、obshellの復元コマンドグループについて説明します。復元コマンドグループは、テナントの復元タスクをキャンセルしたり、復元タスクを確認したりするために使用されます。このコマンドグループを使用するには、OceanBaseクラスタが初期化済みである必要があります。コマンド内で-h / --helpオプションを設定することで、コマンドのヘルプ情報を表示できます。また、タスク実行時にエラーが発生した場合は-v / --verboseオプションを設定して、コマンドの詳細な実行プロセスを確認することもできます。
obshell tenant restore
このコマンドを使用すると、バックアップファイルを指定されたテナントに復元できます。
${home_path}/bin/obshell tenant restore <tenant_name> [flags]
# example
/home/admin/oceanbase/bin/obshell tenant restore mytenant --timestamp "2021-01-01T00:00:00.000+08:00" -z "zone1,zone2,zone3" -d '/path/to/backup/data' -a '/path/to/backup/clog' -u unit1
home_path はOceanBaseデータベースのインストールディレクトリであり、obshellはデフォルトでOceanBaseデータベースのインストールディレクトリ内の bin ディレクトリに配置されています。tenant_name は復元対象のテナント名です。
コマンドのオプションの説明は以下のとおりです：
| オプション名 | 必須 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|---|
| -d/--data_backup_uri | はい | string | なし | ソーステナントのデータバックアップパス。 |
| -z/--zone | いいえ | string | なし | テナントのゾーン分布。指定されていない場合、デフォルトではクラスタ内のすべてのゾーンになります。 |
| --unit_num | いいえ | int | 1 | ターゲットゾーン上のテナントユニット数。値はターゲットゾーンのノード数より小さい必要があります。 |
| -u/--unit | いいえ | string | なし | テナントリソースプールで使用するリソース仕様。
説明
|
| --replica_type | いいえ | string | FULL | ターゲットゾーン上のテナントレプリカタイプ。FULL (フル機能レプリカ)またはREADONLY (読み取り専用レプリカ)に設定できます。
説明
|
| -p/--primary_zone | いいえ | string | RANDOM | テナントのプライマリゾーン。テナントが読み書きサービスを提供するゾーンの優先順位を指定します。例えば、primary_zone ='zone1;zone2,zone3' は、そのテナントが読み書きサービスを優先的に zone1 から提供し、zone1 は zone2、zone3 よりも優先順位が高く、zone2 と zone3 は同じ優先順位であることを意味します。 |
| -T/--timestamp | いいえ | string | なし | 指定されたタイムスタンプに復元します。形式は "2006-01-02T15:04:05.000Z07:00" のようになります。 |
| -S/--scn | いいえ | int | なし | 指定されたSCNに復元します。 |
| -a/--archive_log_uri | いいえ | string | ${data_backup_uri} | ソーステナントのログアーカイブパス。設定されていない場合、-d/--data_backup_uri と同じ値になります。 |
| -s/--ha_high_thread_score | いいえ | int | なし | 高可用性・高優先順位スレッドの現在のワーカースレッド数を設定します。値の範囲は[0,100]です。 |
| -c/--concurrency | いいえ | int | なし | データ復旧の並列度を指定します。指定されていない場合、デフォルトではそのテナントに割り当てられたMAX_CPU数と等しくなります。 |
| -D/--decryption | いいえ | string | なし | バックアップの復旧パスワードを設定します。データバックアップ時にパスワードが追加された場合にのみ、バックアップの復旧パスワードを設定する必要があります。 |
| -k/--kms_encrypt_info | いいえ | string | なし | 暗号化情報を設定します。暗号化されていない場合、または復旧時に元のキー管理サービスにアクセスできる場合は、設定する必要はありません。 |
| -y/--yes | いいえ | なし | なし | このオプションに値を渡す必要はありません。コマンドでの設定は、二重確認をスキップすることを意味します。 |
obshell restore cancel
このコマンドを使用すると、特定のテナントの復元タスクをキャンセルできます。
${home_path}/bin/obshell restore cancel <tenant_name> [-y]
# example
/home/admin/oceanbase/bin/obshell restore cancel tenant1
home_path はOceanBaseデータベースのインストールディレクトリであり、obshellはデフォルトでOceanBaseデータベースのインストールディレクトリ内の bin ディレクトリに配置されています。tenant_name は、復元タスクのキャンセル対象となるテナント名です。
-y/--yes を使用して、確認ダイアログを表示するかどうかを制御できます。このオプションに値を指定する必要はありません。
obshell restore show
このコマンドを使用すると、指定されたテナントの復元タスクを表示できます。
${home_path}/bin/obshell restore show <tenant_name> [-d]
# example
/home/admin/oceanbase/bin/obshell restore show tenant1
home_path はOceanBaseデータベースのインストールディレクトリであり、obshellはデフォルトでOceanBaseデータベースのインストールディレクトリ内の bin ディレクトリに配置されています。tenant_name は、復元タスクを表示する対象となるテナント名です。
-d/--show_detail を使用して、復元タスクの詳細情報を表示するかどうかを制御できます。このオプションに値を指定する必要はありません。