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'];

パラメータ説明

例

関連ドキュメント

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