MODIFY LS

説明

このステートメントは、ログストリームを変更するために使用されます。ログストリームの UNIT_GROUP（同種ゾーンモード）または UNIT_LIST（異種ゾーンモード）、およびログストリームの PRIMARY_ZONE を変更できます。

使用制限と注意事項

• OceanBaseデータベースの現在のバージョンは、テナントの同種ゾーンモードと異種ゾーンモードをサポートしています。詳細は以下の通りです。

  • 同種ゾーンモードでは、ログストリームの UNIT_GROUP とログストリームの PRIMARY_ZONE を変更できます。

  • 異種ゾーンモードでは、ログストリームの UNIT_LIST とログストリームの PRIMARY_ZONE を変更できます。

• ログストリームを変更する際、変更対象のログストリームが存在し、その状態が NORMAL である必要があります。

• ログストリームを変更する際、変更対象のログストリームを含むテナントの状態が NORMAL である必要があります。

• プライマリテナント上でログストリームの UNIT_GROUP（同種ゾーンモード）/UNIT_LIST（異種ゾーンモード）を変更する場合、テナントのすべてのログストリームに現在ロードバランシングタスクがないことが必要です。

• スタンバイテナント上でログストリームの UNIT_GROUP（同種ゾーンモード）/UNIT_LIST（異種ゾーンモード）のプロパティを変更することは推奨されません。スタンバイテナントはログストリームの UNIT_GROUP/UNIT_LIST プロパティを自動的に調整するため、手動でスタンバイテナントのログストリームの UNIT_GROUP/UNIT_LIST プロパティを変更しても反映されない可能性があります。

• ログストリームの UNIT_GROUP（同種ゾーンモード）/UNIT_LIST（異種ゾーンモード）を変更する際、対象の UNIT_GROUP/UNIT_LIST の状態が ACTIVE である必要があります。

• ログストリームの PRIMARY_ZONE を変更する際、変更後のゾーンがテナントの ZONE_LIST に含まれていることを確認する必要があります。ログストリームにおける PRIMARY_ZONE の設定は、テナントの PRIMARY_ZONE とは若干異なります。ログストリームでは z1 または z2 のように1つのゾーンのみを設定でき、テナントのように z1,z2、z1; z2、RANDOM といった複数のゾーンや区切りを指定することはできません。

• ログストリームを変更する際、テナントレベルの構成パラメータ enable_rebalance が無効であること、つまり値が False であることが必要です。enable_rebalance が有効な場合、テナントのロードバランシングモジュールがログストリームの PRIMARY_ZONE および UNIT_GROUP/UNIT_LIST プロパティを自動的に調整する可能性があります。

• 同種ゾーンモードでは、ブロードキャスト電子ストリームとシステムログストリーム（1番ログストリーム）のみが UNIT_GROUP を0に指定することをサポートしています。

• 異種ゾーンモードでは、ユーザーログストリームの UNIT_LIST は空にすることができません。

権限要件

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

構文

ALTER SYSTEM MODIFY LS
    LS [=] ls_id
    [UNIT_GROUP [=] unit_group_id] | [UNIT_LIST [=] (unit_id_list)]
    [,PRIMARY_ZONE [=] 'zone_name'] 
    [TENANT [=] 'tenant_name'];

パラメータ説明

例

関連ドキュメント

変更ログストリームの詳細な操作については、変更ログストリームを参照してください。