CREATE LS

説明

このステートメントは、ユーザーログストリームを作成するために使用されます。

使用制限と注意事項

• 現在、通常のユーザーログストリームのみの作成がサポートされており、ブロードキャストログストリームの作成はサポートされていません。

• 現在のバージョンでは、テナントの同種ゾーンモードと異種ゾーンモードをサポートしています：

  • 同種ゾーンモードでは、Unit Groupを指定してログストリームを作成する必要があります。

  • 異種ゾーンモードでは、UNIT_LISTを指定してログストリームを作成する必要があります。

  同種ゾーンモードと異種ゾーンモードの詳細な違いについては、データ分散を参照してください。

• ログストリームの作成操作は、プライマリテナントでのみ実行できます。また、ログストリームを作成するテナントのSTATUSとSWITCHOVER_STATUSはNORMALである必要があります。

• ログストリームを作成する際：

  • 同種ゾーンモードでは、対象UNIT_GROUPの状態がACTIVEである必要があり、ビューDBA_OB_UNITS内の対象UNIT_GROUP_IDの値が0であってはなりません。

  • 異種ゾーンモードでは、対象UNIT_LISTの状態がACTIVEである必要があり、指定した対象UNIT_LISTは空にすることはできません。

• 作成予定のログストリームにPRIMARY_ZONEを指定する場合、指定したZoneがテナントのZONE_LISTに含まれていることを確認する必要があります。ログストリームのPRIMARY_ZONEの設定は、テナントのPRIMARY_ZONEの設定とは若干異なります。ログストリームでは、z1やz2など単一のZoneのみを指定でき、テナントのようにz1,z2、z1; z2、RANDOMといった複数のZoneを指定することはできません。

• ロードバランシング関連のパラメータは、値をFalseに設定し、無効の状態に保つことを推奨します。その理由は以下の通りです：

  • テナントレベルのパラメータenable_rebalanceが有効、すなわち値がTrueの場合、システムは作成されたログストリームをターゲットUNIT_GROUPから他のUNIT_GROUPへ移行します。

  • テナントレベルのパラメータenable_transferが有効、すなわち値がTrueの場合、作成されたログストリームは削除される可能性があります。

権限要件

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

構文

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

パラメータ説明

例

関連ドキュメント

ログストリームの作成手順の詳細については、ログストリームの作成を参照してください。