バックアップパスのソース側設定を変更する

データバックアップ中に、ユーザーは業務の実際の状況に応じて、バックアップパスのソース側設定、すなわちzone、idc、またはregionの設定を変更できます。変更後、新しい設定情報が元の設定情報を上書きします。

使用上の制限

ユーザーテナントは自身のテナントにおけるバックアップパスのソース側設定のみを変更できます。システムテナントが指定したユーザーテナントのバックアップパスのソース側設定を変更することはサポートされていません。

注意事項

• バックアップパスの zone、idc、または region 設定を変更する際、リージョンレベルまたはIDCレベルを設定する必要がある場合は、まず ALTER SYSTEM MODIFY ZONE zone_name SET REGION=region_name; または ALTER SYSTEM MODIFY ZONE zone_name SET IDC=idc_name; ステートメントを使用してリージョン情報またはIDC情報を設定する必要があります。IDCレベルのソース側設定を推奨します。これにより、ネットワーク帯域幅リソースが豊富なIDCでバックアップタスクを実行できるだけでなく、バックアップタスクの選択可能なノード範囲も広がります。また、ユーザーはクラスタ内のIDC内のZoneの変更状況を気にする必要がありません。

• バックアップパスの zone、idc、または region 設定を変更する際、Root ServiceのLeaderノードが指定された zone、idc、または region 内に存在している必要があります。そうでない場合、バックアップタスクはターゲットバックアップパスにバックアップメタデータを書き込むことができず、結果としてバックアップタスクの実行が失敗します。バックアップパスのソース側設定には、Primary Zoneの範囲を含めることを推奨します。

• バックアップパスの zone、idc、または region 設定を変更する際、バックアップタスクが実行中の場合、実行中のタスクは設定の変更を検知するまで最大で数分かかるため、設定変更中も設定範囲外のノードがバックアップパスにアクセスし、異なるデータセンターや地域間でトラフィックが発生する可能性があります。

手順

1. テナント管理者がクラスタのユーザーテナントにログインします。

2. 以下のステートメントを実行して、バックアップパスのソース側設定を変更します。

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

   ALTER SYSTEM {ALTER|CHANGE|MODIFY} EXTERNAL_STORAGE_DEST PATH [=] 'path' SET ATTRIBUTE = '{zone=zone_name | idc=idc_name | region=region_name}';
   

   関連パラメータの説明は以下のとおりです：

   • path：変更対象のバックアップパスを指定します。アーカイブ媒体がオブジェクトストレージタイプの場合は、オブジェクトストレージのホストアドレス情報も含める必要があります。例えば、アーカイブ媒体がOSSの場合、このパスの形式は次のとおりです：oss://oceanbase-test-bucket/backup/databackup?host=xxxx

   • zone=zone_name | idc=idc_name | region=region_name：現在のバックアップパスのソースを指定します。zone、idc、region の3つの異なる階層の設定を選択できます。一度に1つの階層のみを選択するか、設定しないこともできます。

     複数のZone、複数のIDC、または複数のRegionを設定する必要がある場合は、複数のZone/IDC/Region間を半角カンマ（,）と半角セミコロン（;）で区切ります。ここで：

     • 半角カンマ（,）は、バックアップタスクの実行ノードを選択する際、左右のZone/IDC/Region内のノードが同じ優先順位を持つことを示します。
     • 半角セミコロン（;）は、左側のZone/IDC/Region内のノードの優先順位が右側より高いことを示し、バックアップタスクは左側のZone/IDC/Region内のノードを優先的に選択して実行します。

     例えば、zone=z1,z2;z3 と設定すると、z1、z2、z3 をバックアップのソースとして指定します。z1、z2 は同じ優先順位であり、z1、z2 の優先順位は z3 より高いことを意味します。

   • 設定時に、設定した zone、idc、または region が存在しない場合、ソース情報が存在しないというエラー（エラーコード -9133）が表示されます。

   例：

   • バックアップパス oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com のソース設定を zone=z1,z2;z3 から idc=idc1;idc2 に変更します。

     obclient(root@mysql001)[(none)]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'idc=idc1;idc2';
     

   • バックアップパス file:///data/nfs/backup/data のソース設定を zone=z1,z2;z3 から region=region1 に変更します。

     obclient(root@mysql001)[(none)]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='file:///data/nfs/backup/data' SET ATTRIBUTE = 'region=region1';
     

   詳細な例については、ALTER/CHANGE/MODIFY EXTERNAL_STORAGE_DESTを参照してください。

3. 変更が成功した後、ビュー DBA_OB_BACKUP_STORAGE_INFO を確認することができます。

   バックアップパスのソース設定を確認する詳細な操作については、データバックアップ関連パラメータの確認を参照してください。

関連ドキュメント

• データバックアップ前の準備

• バックアップパスとアーカイブパスのソース側設定例