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

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を参照してください。

関連ドキュメント

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

• バックアップ前の準備