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データベースの権限の詳細については、MySQLモードの権限分類を参照してください。

構文

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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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パラメータを同時に設定することも、max_iopsまたはmax_bandwidthのいずれかのパラメータを単独で設定することもできます。I/O制限パラメータの設定は、オブジェクトストレージパスのみでサポートされており、NFSパスではサポートされていません。

• OSS

  max_iopsとmax_bandwidthパラメータを同時に設定する例は以下のとおりです。

  obclient(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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(root@mysql001)[(none)]> 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';
  

関連ドキュメント

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