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. 1コア5GBの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
   

関連ドキュメント

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

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

• ログ復元ソースの設定