CREATE STANDBY TENANT

説明

CREATE STANDBY TENANT ステートメントは、物理スタンバイデータベースのシナリオで空のスタンバイテナントを作成するために使用します。この方法でスタンバイテナントが正常に作成されると、そのスタンバイテナントは自動的に継続的な同期状態に入ります。

一般的なユーザーテナントを作成する場合は、CREATE TENANT ステートメントを使用してください。

使用制限と注意事項

• プライマリテナントが新規作成されたテナントであるか、またはそのプライマリテナントがテナント作成後の完全なログを現在保持していることを確認できる場合にのみ、このステートメントを使用してスタンバイテナントを作成できます。プライマリテナント上に完全なログがあるかどうかの詳細な確認手順については、スタンバイテナント作成前の準備を参照してください。

• この方法でスタンバイテナントを作成する場合、プライマリテナント内の GV$OB_LOG_STAT、GV$OB_UNITS、GV$OB_PARAMETERS、DBA_OB_ACCESS_POINT、DBA_OB_TENANTS、DBA_OB_LS などのシステムビューにアクセスできる専用ユーザーが必要です。この専用ユーザーの詳細については、空のスタンバイテナントの作成を参照してください。

• 空のスタンバイテナントは、作成対象のスタンバイテナントが存在するクラスタの sys テナントを通じて作成する必要があります。

権限要件

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

構文

CREATE STANDBY TENANT [IF NOT EXISTS] tenant_name
     {LOG_RESTORE_SOURCE [=] string_value} [tenant_option_list];

tenant_option_list:
      tenant_option [, tenant_option...]

tenant_option:
      LOCALITY [=] 'locality_description'
    | PRIMARY_ZONE [=] primary_zone_name
    | RESOURCE_POOL_LIST [=] (pool_name [, pool_name...])
    | COMMENT [=] 'string'

パラメータ説明

例

プライマリテナント名を mysql と仮定し、プライマリテナントビューにアクセスするための専用ユーザー test を既に作成している場合、空のスタンバイテナント standby_tenant を作成する例を以下に示します。

1. root ユーザーで、作成対象のスタンバイテナントが存在するクラスタの sys テナントにログインします。

2. 1C5GのUnitを作成します。

   obclient [oceanbase]> CREATE RESOURCE UNIT 1C5G MAX_CPU 1, MEMORY_SIZE = '5G';
   

3. リソースプールpool_for_standbyを作成します。

   obclient [oceanbase]> CREATE RESOURCE POOL pool_for_standby UNIT = '1C5G', UNIT_NUM = 1, ZONE_LIST = ('zone1', 'zone2', 'zone3');
   

4. LOG_RESTORE_SOURCEの設定情報を取得し、空のスタンバイテナントを作成します。

   obclient [oceanbase]> CREATE STANDBY TENANT IF NOT EXISTS standby_tenant LOG_RESTORE_SOURCE = 'SERVICE=11.xxx.xxx.xxx:17855;11.xxx.xxx.xxx:17857;11.xxx.xxx.xxx:17859 USER=test@mysql PASSWORD=******' RESOURCE_POOL_LIST=('pool_for_standby');
   

5. ビューDBA_OB_TENANTSでテナントの状態を確認します。フィールドTENANT_ROLEがSTANDBY、STATUSがNORMALの場合、テナントの状態は正常で、作成に成功したことを意味します。

   obclient [oceanbase]> SELECT TENANT_NAME, TENANT_TYPE, CREATE_TIME, STATUS, TENANT_ROLE,SCN_TO_TIMESTAMP(SYNC_SCN) FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = 'standby_tenant';
   

   クエリ結果は次のとおりです：

   +----------------+-------------+----------------------------+--------+-------------+----------------------------+
   | TENANT_NAME    | TENANT_TYPE | CREATE_TIME                | STATUS | TENANT_ROLE | SCN_TO_TIMESTAMP(SYNC_SCN) |
   +----------------+-------------+----------------------------+--------+-------------+----------------------------+
   | standby_tenant | USER        | 2023-04-14 21:06:48.787550 | NORMAL | STANDBY     | 2023-04-14 21:12:59.183293 |
   +----------------+-------------+----------------------------+--------+-------------+----------------------------+
   1 row in set
   

関連ドキュメント

• スタンバイテナント作成前の準備

• 空のスタンバイテナントの作成

• ログ復元ソースの設定