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のユニットを作成します。

   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
   

関連ドキュメント

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

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

• ログ復旧ソースの設定