バックアップ構成パラメータ

OceanBaseデータベースは、テナントレベルの構成パラメータとクラスタレベルの構成パラメータのバックアップをサポートしています。構成パラメータをバックアップすることで、後のクラスタやテナントの状態を迅速に復元する際の設定の参照に役立ちます。

注意事項

本記事で説明しているクラスタレベル構成パラメータおよびテナントレベル構成パラメータは、ユーザーの設定参考として提供されているものです。物理復元時には、これらの設定はクラスタやテナントには反映されません。

クラスタレベル構成パラメータのバックアップ

データバックアップではクラスタレベル構成パラメータはバックアップされません。クラスタレベル構成パラメータをバックアップする場合は、コマンドを手動で実行して、元のクラスタレベル構成パラメータを指定のパスにバックアップする必要があります（デフォルト設定以外のクラスタ範囲の構成パラメータのみをバックアップします）。

使用上の制限と注意事項

• クラスタレベル構成パラメータをバックアップできるのは sys テナントのみです。ユーザーテナントではサポートされていません。

• クラスタレベル構成パラメータをバックアップする際、all_server_list、rootservice_list、debug_sync_timeout などのパラメータは、値がデフォルト値であるかどうかに関係なく、バックアップされません。

手順

1. rootユーザーでクラスタのsysテナントにログインします。

2. 以下のSQLステートメントを実行して、クラスタレベル構成パラメータをバックアップします。

   SQLステートメントは以下のとおりです：

   ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 'parameters_backup_path';
   

   ここで、parameters_backup_pathはクラスタレベル構成パラメータバックアップファイルのターゲットパスであり、ユーザーが自ら指定する必要があります。そのパス要件はデータバックアップのバックアップ宛先パス要件と同じでなければなりません。データバックアップのバックアップ宛先要件については、データバックアップ前の準備を参照してください。

   関連する例は以下のとおりです：

   Alibaba Cloud OSS

   NFS

   AWS S3

   S3プロトコルに対応したオブジェクトストレージ

   クラスタレベルのパラメータをoss://oceanbase-test-bucket/backup/cluster_parameters?host=***.aliyun-inc.com&access_id=***&access_key=***ディレクトリにバックアップします。

   obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 'oss://oceanbase-test-bucket/backup/cluster_parameters?host=***.aliyun-inc.com&access_id=***&access_key=***';
   

   クラスタレベルのパラメータをfile:///data/nfs/backup/cluster_parametersディレクトリにバックアップします。

   obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 'file:///data/nfs/backup/cluster_parameters';
   

   クラスタレベルのパラメータをs3://oceanbase-test-bucket/backup/data/cluster_parameters?host=s3.***.amazonaws.com&access_id=****&access_key=****&s3_region=****ディレクトリにバックアップします。

   obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 's3://oceanbase-test-bucket/backup/data/cluster_parameters?host=s3.***.amazonaws.com&access_id=****&access_key=****&s3_region=****';
   

   • クラスタレベル構成パラメータをHuawei OBSのs3://oceanbase-test-bucket/backup/data/cluster_parameters?host=obs.****.myhuaweicloud.com&access_id=****&access_key=****ディレクトリにバックアップします。

     obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 's3://oceanbase-test-bucket/backup/data/cluster_parameters?host=obs.****.myhuaweicloud.com&access_id=****&access_key=****';
     

   • クラスタレベル構成パラメータをGCSのs3://oceanbase-test-bucket/backup/data/cluster_parameters?host=https://storage.googleapis.com&access_id=****&access_key=****。

     obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 's3://oceanbase-test-bucket/backup/data/cluster_parameters?host=https://storage.googleapis.com&access_id=****&access_key=****';
     

   • クラスタレベル構成パラメータをCOSのs3://oceanbase-test-bucket/backup/data/cluster_parameters?host=cos.ap-xxxx.myqcloud.com&access_id=***&access_key=***ディレクトリにバックアップします。

     obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 's3://oceanbase-test-bucket/backup/data/cluster_parameters?host=cos.ap-xxxx.myqcloud.com&access_id=***&access_key=***';
     

テナントレベル構成パラメータのバックアップ

テナントレベル構成パラメータについては、フルデータバックアップまたは増分データバックアップを実行する際、システムはテナントレベル構成パラメータ（デフォルト設定以外のテナント範囲のパラメータ）およびテナントのリソース構成などの情報をテナントデータバックアップの一部として、バックアップ先に一緒に保存します。追加のバックアップ操作は不要です。

次のステップ

バックアップが正常に完了すると、ユーザーは事前に指定したバックアップパスで、テナントレベルおよびクラスタレベルの構成パラメータバックアップファイルを取得できます。テナントレベル構成パラメータとクラスタレベル構成パラメータのバックアップ後の詳細なディレクトリ構造については、物理バックアップとリストアの概要を参照してください。

構成パラメータのバックアップファイルを取得した後、ob_adminツールのdump_backupコマンドを使用して解析し、構成情報を取得することもできます。詳細な解析の説明と例については、dump_backupを参照してください。

関連ドキュメント

• 物理バックアップとリストアの概要

• バックアップ前の準備