ALTER TENANT

説明

ALTER TENANT 文は、ユーザーテナントの属性を変更するために使用されます。これには、ローカリティ、プライマリゾーン、リソースプールのリスト、システム変数の値などの変更が含まれます。

ユーザーテナント名を変更する必要がある場合は、ALTER TENANT ... RENAME 文を使用できます。

ユーザーテナントをロックまたはアンロックする必要がある場合は、ALTER TENANT ... LOCK / UNLOCK 文を使用できます。ALTER TENANT ... LOCK 文でロック操作を実行すると、システムはロックされたテナント上で新しい接続の作成を許可しなくなりますが、既存の接続は影響を受けません。

権限要件

テナントを変更できるのは sys テナントの root ユーザー（root@sys）のみです。その他のテナントではテナントの変更はサポートされません。

構文

ALTER TENANT

ALTER TENANT tenant_name
    [SET] [tenant_option_list] [set_sys_var];

tenant_option_list:
    tenant_option [, tenant_option ...]

tenant_option:
      LOCALITY [=] 'locality_description'
    | PRIMARY_ZONE [=] zone
    | RESOURCE_POOL_LIST [=](pool_name [, pool_name...])
    | ENABLE_ARBITRATION_SERVICE [=] {True | False}
    | [DEFAULT] TABLEGROUP [=] {NULL | tablegroup_name}
    | ENABLE_EXTENDED_ROWID [=] {true | false}
    | COMMENT [=]'string'

set_sys_var:
    VARIABLES var_name {TO | =} var_value [,var_name {TO | =} var_value...]

ALTER TENANT ... RENAME

ALTER TENANT tenant_name RENAME GLOBAL_NAME TO new_tenant_name;

ALTER TENANT ... LOCK / UNLOCK

ALTER TENANT tenant_name LOCK | UNLOCK;

パラメータ説明

例

• テナント tenant1 のプライマリゾーンを zone2 に変更します。

  obclient [oceanbase]> ALTER TENANT tenant1 primary_zone='zone2';
  

• テナント tenant1 のプライマリゾーンを RANDOM に変更します。

  obclient [oceanbase]> ALTER TENANT tenant1 primary_zone = RANDOM;
  

  このテナントが zone1、zone2、zone3 の3つのゾーンを持っている場合、このステートメントは以下と同じです。

  obclient [oceanbase]> ALTER TENANT tenant1 primary_zone = 'zon1,zone2,zone3';
  

• リソースプールの変更は、通常、テナントのレプリカ数の昇格および降格のシナリオで使用されます。また、リソースプールを変更する際は、一度に1つのリソースプールしか追加または削除できません。以下のステートメントを実行して、テナントのリソースプール pool1 を直接 pool2 に置き換えることはできません。そうしないと、以下のエラーが発生します。

  obclient [oceanbase]> ALTER TENANT tenant1 resource_pool_list=('pool2');
  

  エラーメッセージは次のとおりです。

  ERROR 1210 (HY000): Incorrect arguments to resource pool list
  

  テナントの利用可能なリソースを調整したい場合、例えばテナントの拡張が必要な場合は、リソースユニットの仕様を引き上げることができます。

  obclient [oceanbase]> ALTER RESOURCE UNIT unit1 MAX_CPU 15, MEMORY_SIZE '20G', MAX_IOPS 1280, MIN_CPU=10, MIN_IOPS=1024;
  

• テナント tenant1 のローカリティを変更し、レプリカ数を増やします。ここで、F はフル機能レプリカタイプを表し、B_4 は新しく追加されたゾーン名です。

  現在のテナント tenant1 のローカリティが F@B_1,F@B_2,F@B_3、リソースプールが pool1 であり、その ZONE_LIST の範囲が 'B_1','B_2','B_3' であると仮定します。

  1. リソースユニット unit2 を作成します。

     obclient [oceanbase]> CREATE RESOURCE UNIT unit2, MAX_CPU=5, MIN_CPU=2.5, MEMORY_SIZE= '32G', MAX_IOPS=10000, MIN_IOPS=5000, LOG_DISK_SIZE=5301023539200;
     

  2. リソースプール pool2 を作成します。

     obclient [oceanbase]> CREATE RESOURCE POOL pool2 unit='unit2',unit_num=1,zone_list=('B_4');
     

  3. テナントにリソースプール pool2 を追加します。

     obclient [oceanbase]> ALTER TENANT tenant1 resource_pool_list=('pool1','pool2');
     

  4. テナントのローカリティを変更します。

     obclient [oceanbase]> ALTER TENANT tenant1 LOCALITY='F@B_1,F@B_2,F@B_3,F@B_4';
     

     追加するレプリカタイプがカラムストアレプリカの場合、テナントのローカリティを変更するステートメントは以下のとおりです：

     obclient [oceanbase]> ALTER TENANT tenant1 LOCALITY = 'F@B_1,F@B_2,F@B_3,C@B_4';
     

     注意

     • テナントのローカリティを変更する際、カラムストアレプリカについては、レプリカの追加と削除のみサポートされ、レプリカタイプの変換はサポートされません。つまり、カラムストアレプリカを追加する場合、元のゾーンにレプリカが存在してはなりません。カラムストアレプリカを削減する場合は、カラムストアレプリカが存在するゾーンをレプリカなしに変更する必要があります。
     • テナントにカラムストアレプリカを追加した後、それらにアクセスするには、ODPを追加でデプロイし、一連の設定を行って接続をカラムストアレプリカにルーティングする必要があります。カラムストアレプリカの詳細な使用方法については、カラムストアレプリカを参照してください。

• アービトレーションサービスがデプロイされているシナリオで、tenant1 のアービトレーションサービスを有効にします。

  obclient [oceanbase]> ALTER TENANT tenant1 ENABLE_ARBITRATION_SERVICE=true;
  

• 通常のテナント tenant1 の名前を tenant101 に変更します。

  obclient [oceanbase]> ALTER TENANT tenant1 RENAME GLOBAL_NAME TO tenant101;
  

• テナント tenant1 をロックします。

  obclient [oceanbase]> ALTER TENANT tenant1 LOCK;