RESTORE

説明

ALTER SYSTEM RESTORE ステートメントは、テナントのバックアップデータをリストアするために使用します。

使用上の制限と注意事項

• OceanBaseデータベースの物理リストアは、同一クラスタ内でのリストアだけでなく、異なるクラスタ間でのリストアもサポートしています。

• ALTER SYSTEM RESTORE ステートメントを使用して物理リストアを実行する前に、リストア対象のバックアップデータのバージョンを必ず確認してください。リストア可能なバージョンの制限については、リストア前の準備を参照してください。

• ALTER SYSTEM RESTORE ステートメントを使用して物理リストアを実行する前に、リストア対象のテナントに必要なリソースが作成されていることを確認してください。リストア対象のテナントに必要なリソースを作成する具体的な操作については、リストア前の準備を参照してください。

• ALTER SYSTEM RESTORE ステートメントでリストアされたテナントは、デフォルトでスタンバイテナントとなります。サービス提供のためにプライマリテナントに切り替える必要がある場合は、ALTER SYSTEM ACTIVATE STANDBY ステートメントを追加で実行する必要があります。ALTER SYSTEM ACTIVATE STANDBY ステートメントの詳細については、ACTIVATE STANDBYを参照してください。

権限要件

ALTER SYSTEM RESTORE ステートメントは、sys テナントの root ユーザー(root@sys)のみが実行できます。

構文

ALTER SYSTEM
   RESTORE dest_tenant_name
   FROM uri
   [ UNTIL {TIME='timestamp' | SCN=scn} ]
   WITH 'restore_option'
   [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password']
   [DESCRIPTION [=] 'description'];

restore_option:
  pool_list=pool_name[&locality=locality][&primary_zone=zone_name][&concurrency=int_num][&kms_encrypt={true | false}][&method={full | quick}]

パラメータの説明

例

• NFSデータバックアップパスとNFSログアーカイブパスから、テナント mysql を指定されたタイムスタンプ 2022-06-01 00:00:00 までリストアします。リソースプールを restore_pool、レプリカ Locality を F@z1,F@z2,F@z3 に指定し、primary_zone を z1 に指定して、フルリストアモードでリストアします。

  obclient [oceanbase]> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' UNTIL TIME='2022-06-01 00:00:00' WITH 'pool_list=restore_pool&locality=F@z1,F@z2,F@z3&primary_zone=z1';
  

• NFSデータバックアップパスとNFSログアーカイブパスから、テナント mysql を現在の最新のアーカイブポイントまでリストアします。リソースプールを restore_pool に指定し、データリストアの並列度 concurrency を 50 に指定して、フルリストアモードでリストアします。

  obclient [oceanbase]> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' WITH 'pool_list=restore_pool&concurrency=50';
  

• NFSデータバックアップパスとNFSログアーカイブパスから、テナント mysql を指定されたSCNまでリストアします。リソースプールを restore_pool に指定して、クイックリストアモードでリストアします。

  obclient [oceanbase]> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' UNTIL SCN=1658285759724047000 WITH 'pool_list=restore_pool&method=quick';
  

• NFSデータバックアップパス、NFSログアーカイブパス、およびNFSアーカイブバックアップ宛先パスから、テナント mysql を指定されたタイムスタンプ 2022-06-01 00:00:00 までリストアします。リソースプールを restore_pool に指定して、フルリストアモードでリストアします。

  obclient [oceanbase]> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive,file:///data/nfs/backup/backup_archive' UNTIL TIME='2022-06-01 00:00:00' WITH 'pool_list=restore_pool';
  

• OSSバックアップパスとOSSログアーカイブパスから、テナント mysql を指定されたタイムスタンプ 2022-06-01 00:00:00 までリストアします。リソースプールを restore_pool に指定して、フルリストアモードでリストアします。

  obclient [oceanbase]> ALTER SYSTEM RESTORE mysql FROM 'oss://oceanbase-test-bucket/backup/data/?host=***.aliyun-inc.com&access_id=***&access_key=***,oss://oceanbase-test-bucket/backup/archive/?host=***.aliyun-inc.com&access_id=***&access_key=***' UNTIL TIME='2022-06-01 00:00:00' WITH 'pool_list=restore_pool';
  

• S3バックアップパスとS3ログアーカイブパスから、テナントmysqlを指定タイムスタンプ2024-01-15 00:00:00までリストアし、リソースプールをrestore_poolに指定します。

  obclient [oceanbase]> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com&access_id=***&access_key=***&s3_region=***, s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com&access_id=***&access_key=***&s3_region=***' UNTIL TIME='2024-01-15 00:00:00' WITH 'pool_list=restore_pool';
  

  • s3_regionは、S3のバケットが配置されているリージョンを表します。

• OBSバックアップパスとログアーカイブパスから、テナントmysqlを指定タイムスタンプ2023-06-01 00:00:00までリストアし、リソースプールをrestore_poolに指定して、フルリストアモードでリストアします。

   obclient> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test-bucket/backup/data/?host=obs.***.myhuaweicloud.com&access_id=***&access_key=***,s3://oceanbase-test-bucket/backup/archive/?host=obs.***.myhuaweicloud.com&access_id=***&access_key=***' UNTIL TIME='2023-06-01 00:00:00' WITH 'pool_list=restore_pool';
  

• GCSバックアップパスとログアーカイブパスから、テナントmysqlを指定タイムスタンプ2023-06-01 00:00:00までリストアし、リソースプールをrestore_poolに指定して、フルリストアモードでリストアします。

  obclient> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test-bucket/backup/data/?host=https://storage.googleapis.com&access_id=***&access_key=***,s3://oceanbase-test-bucket/backup/archive/?host=https://storage.googleapis.com&access_id=***&access_key=***' UNTIL TIME='2023-06-01 00:00:00' WITH 'pool_list=restore_pool';
  

• COSバックアップパスとログアーカイブパスから、テナントmysqlを指定タイムスタンプ2023-06-01 00:00:00までリストアし、リソースプールをrestore_poolに指定して、フルリストアモードでリストアします。

  obclient> ALTER SYSTEM RESTORE mysql FROM 's3://oceanbase-test/backup/data?host=cos.ap-***x.myqcloud.com&access_id=***&access_key=***,s3://oceanbase-test/backup/archive?host=cos.ap-***x.myqcloud.com&access_id=***&access_key=***' UNTIL TIME='2023-06-01 00:00:00' WITH 'pool_list=restore_pool';
  

関連ドキュメント

• CANCEL RESTORE

• RECOVER TABLE

• 物理リストアの実行

• バックアップリストア機能を使用してスタンバイテナントを作成する