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

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はクラスタレベルの構成パラメータのバックアップファイルのターゲットパスであり、ユーザーが指定する必要があります。そのパス要件は、データバックアップのバックアップ先パス要件と一致する必要があります。データバックアップのバックアップ先要件については、バックアップ前の準備を参照してください。

   関連例は次のとおりです：

   アリババクラウド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を参照してください。

関連ドキュメント

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

• バックアップ前の準備