ALTER/CHANGE/MODIFY EXTERNAL_STORAGE_DEST

説明

このステートメントは、テナントのバックアップまたはアーカイブパスのソース側設定（zone、idc、またはregion設定）、I/Oスロットリングパラメータ（max_iopsおよびmax_bandwidth）、およびaccess_idやaccess_keyなどの鍵情報を変更するために使用されます。変更後、新しい設定情報が元の設定情報を上書きします。

使用上の制限と注意事項

• このステートメントはユーザーテナントのみが実行でき、システムテナント（sysテナント）では実行できません。

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

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

• I/Oスロットリングパラメータ（max_iops および max_bandwidth）および access_id と access_key 情報の変更は、オブジェクトストレージパスでのみサポートされています。バックアップメディアがNFSのパスにI/Oスロットリングパラメータ（max_iops および max_bandwidth）または access_id、access_key 情報を設定しようとすると、システムはサポートされないエラーを返し、エラーコードは 1235 です。

• オブジェクトストレージパスに ACCESS_INFO プロパティ（access_id および access_key 情報）を設定する際、パラメータの形式が正しくない場合（例：余分な = がある、access_id または access_key が欠けているなど）、システムは OB_OBJECT_STORAGE_PERMISSION_DENIED エラー（エラーコード -9116）を返します。

• バックアップパスまたはアーカイブパスがAssume Role方式でオブジェクトパスにアクセスする場合：

  • ACCESS_INFO = 'access_id=new_access_id&access_key=new_access_key' を設定した場合、システムはエラーを返します。

  • ATTRIBUTE のI/Oスロットリングパラメータのみを設定し（ACCESS_INFO プロパティを設定しない場合）、システムはサポートされないと表示されるか、設定が反映されない可能性があります。

• 同一パスに対して、複数回同じ ATTRIBUTE + ACCESS_INFO プロパティを設定することは許可されています。

権限要件

このステートメントを実行するユーザーは ALTER SYSTEM 権限を持っている必要があります。OceanBaseデータベースの権限に関する詳細は、Oracleモードの権限分類を参照してください。

構文

ALTER SYSTEM {ALTER|CHANGE|MODIFY} EXTERNAL_STORAGE_DEST
  PATH [=] 'path'
  SET [ATTRIBUTE = '[{zone=zone_name | idc=idc_name | region=region_name}][&max_iops=iops_num][&max_bandwidth=bandwidth_num]']
  [ACCESS_INFO = 'access_id=new_access_id&access_key=new_access_key'];

パラメータ説明

例

アーカイブパスのソース側設定を変更する

アーカイブパスの元のソース側設定が zone=z1,z2,z3 である場合、ソース側設定を region=region1 に変更する必要があります。変更後は、region1 内のノードのみがこのパスにアクセスできます。

• OSS

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'region=region1';
  

• NFS

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='file:///data/nfs/backup/archive' SET ATTRIBUTE = 'region=region1';
  

• S3

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com' SET ATTRIBUTE = 'region=region1';
  

• S3プロトコル互換のオブジェクトストレージ（OBS/GCS/COS）

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=obs.****.myhuaweicloud.com' SET ATTRIBUTE = 'region=region1';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=https://storage.googleapis.com' SET ATTRIBUTE = 'region=region1';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=cos.ap-xxxx.myqcloud.com' SET ATTRIBUTE = 'region=region1';
  

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

假定デバイスのバックアップパスの元のソース側設定は zone=z1,z2;z3 ですが、現在ソース側設定を idc=idc1;idc2 に変更する必要があります。変更後、idc1、idc2 内のノードはこのパスにアクセスでき、かつ idc1 の優先順位が idc2 より高くなります。

• OSS

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

• NFS

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='file:///data/nfs/backup/data' SET ATTRIBUTE = 'idc=idc1;idc2';
  

• S3

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com' SET ATTRIBUTE = 'idc=idc1;idc2';
  

• S3プロトコル互換のオブジェクトストレージ(OBS/GCS/COS)

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=obs.****.myhuaweicloud.com' SET ATTRIBUTE = 'idc=idc1;idc2';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=https://storage.googleapis.com' SET ATTRIBUTE = 'idc=idc1;idc2';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test/backup/data?host=cos.ap-xxxx.myqcloud.com' SET ATTRIBUTE = 'idc=idc1;idc2';
  

変更アーカイブのパスを変更する access_id と access_key 情報

• OSS

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

• S3

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

• S3プロトコル互換のオブジェクトストレージ(OBS/GCS/COS)

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=obs.****.myhuaweicloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=https://storage.googleapis.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=cos.ap-xxxx.myqcloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

バックアップパスを変更する access_id と access_key 情報

• OSS

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

• S3

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

• S3プロトコル互換のオブジェクトストレージ(OBS/GCS/COS)

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=obs.****.myhuaweicloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=https://storage.googleapis.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test/backup/data?host=cos.ap-xxxx.myqcloud.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

アーカイブパスのI/Oレート制限パラメータの設定(max_iops と max_bandwidth)

max_iopsとmax_bandwidthの両方のパラメータを同時に設定することも、どちらか一方のみを設定することもできます。この設定はオブジェクトストレージパスでのみサポートされており、NFSパスではI/Oレート制限パラメータの設定はできません。

• OSS

  max_iopsとmax_bandwidthの両方のパラメータを同時に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

  max_iopsのみを設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000';
  

  max_bandwidthのみを設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_bandwidth=1000mb';
  

• S3

  max_iopsとmax_bandwidthの両方のパラメータを同時に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=s3.<region>.amazonaws.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

• S3プロトコル互換のオブジェクトストレージ(OBS/GCS/COS)

  max_iopsとmax_bandwidthの両方のパラメータを同時に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=obs.****.myhuaweicloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=https://storage.googleapis.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=cos.ap-xxxx.myqcloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

バックアップパスのI/Oレート制限パラメータの設定(max_iops と max_bandwidth)

max_iops と max_bandwidth の両方のパラメータを同時に設定することも、どちらか一方のみを設定することもできます。I/Oレート制限パラメータの設定は、オブジェクトストレージパスのみサポートしており、NFSパスではサポートされていません。

• OSS

  max_iops と max_bandwidth の両方のパラメータを同時に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

  max_iops のみを個別に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_iops=1000';
  

  max_bandwidth のみを個別に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ATTRIBUTE = 'max_bandwidth=1000mb';
  

• S3

  max_iops と max_bandwidth の両方のパラメータを同時に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=s3.<region>.amazonaws.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

• S3プロトコル互換のオブジェクトストレージ(OBS/GCS/COS)

  max_iops と max_bandwidth の両方のパラメータを同時に設定する例を以下に示します。

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=obs.****.myhuaweicloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM ALTER EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=https://storage.googleapis.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

  obclient(SYS@oracle001)[SYS]> ALTER SYSTEM MODIFY EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test/backup/data?host=cos.ap-xxxx.myqcloud.com' SET ATTRIBUTE = 'max_iops=1000&max_bandwidth=1000mb';
  

関連ドキュメント

• バックアップパスのソース側設定の変更

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

• オブジェクトストレージのキー情報の更新