ALTER/CHANGE/MODIFY EXTERNAL_STORAGE_DEST

説明

このステートメントは、現在のテナントのバックアップまたはアーカイブパスのI/O制限パラメータ（max_iops と max_bandwidth）および access_id と access_key などのキー情報を変更するために使用されます。

制限事項と注意事項

• V4.3.5バージョンでは、V4.3.5 BP2バージョンからaccess_idとaccess_keyなどの情報の変更をサポートしています。

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

• オブジェクトストレージのパスのみが、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 = '[max_iops=iops_num][&max_bandwidth=bandwidth_num]']
      [ACCESS_INFO = 'access_id=new_access_id&access_key=new_access_key'];

パラメータの説明

例

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

• OSS

  obclient> 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> 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> 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> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/archive?host=https://storage.googleapis.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
    

    obclient> ALTER SYSTEM CHANGE 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> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
  

  • S3

    obclient> ALTER SYSTEM CHANGE 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> 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> ALTER SYSTEM CHANGE EXTERNAL_STORAGE_DEST PATH='s3://oceanbase-test-bucket/backup/data?host=https://storage.googleapis.com' SET ACCESS_INFO = 'access_id=******&access_key=******';
    

    obclient> ALTER SYSTEM CHANGE 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パラメータを同時に設定することも、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/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';
  

関連ドキュメント

オブジェクトストレージのキー情報を更新する