クラスタ構成パラメータのリセット

構成パラメータの値が変更された後、ビジネスニーズに応じて ALTER SYSTEM RESET ステートメントを使用して、構成パラメータの値をデフォルト値にリセットできます。

注意事項

• システムテナント（sys テナント）はクラスタレベルの構成パラメータを確認およびリセットできます。ユーザーテナントはクラスタレベルの構成パラメータを確認することはできますが、リセットすることはできません。

• システムテナントとユーザーテナントはどちらもテナントレベルの構成パラメータを確認およびリセットできます。

• 指定されたサーバーおよびゾーン上の構成パラメータ値のリセットはサポートされていません。

操作手順

1. システムテナントまたはユーザーテナントでクラスタにログインします。

   接続例は以下のとおりです。データベースへの接続時は、実際の環境に基づいてください。

   obclient -h10.xx.xx.xx -P2883 -utest@mysql#obdemo -p***** -A
   

   データベース接続の詳細な操作ガイドについては、データベース接続の概要(MySQLモード)およびデータベース接続の概要(Oracleモード)を参照してください。

2. 以下のコマンドを実行して、構成パラメータの値を確認します。

   obclient [(none)]> SHOW PARAMETERS LIKE '%enable_sql_audit%';
   

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

   +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
   | zone  | svr_type | svr_ip         | svr_port | name             | data_type | value | info                                                                                                          | section  | scope   | source  | edit_level        | default_value | isdefault |
   +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
   | zone1 | observer | 172.xx.xxx.xxx |     2882 | enable_sql_audit | BOOL      | False | specifies whether SQL audit is turned on. The default value is TRUE. Value: TRUE: turned on FALSE: turned off | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | true          |         0 |
   +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
   1 row in set
   

3. 以下のコマンドを実行して、構成パラメータの値を変更します。

   ステートメントは次のとおりです：

   ALTER SYSTEM RESET
       parameter_name [SCOPE = {SPFILE | BOTH}]
            [TENANT [=] all | all_user | all_meta | tenant_name ];
   

   関連パラメータの説明は以下のとおりです：

   • SCOPEは構成パラメータの有効範囲を指定するために使用されます。デフォルト値はBOTHです。その中で：

     • SPFILE：構成テーブル内の構成パラメータ値のみをリセットし、OBServerノードの再起動後にのみ有効になります。

     • BOTH：構成テーブルとメモリ値の両方をリセットし、変更は即時に反映され、OBServerノードの再起動後も構成値は引き続き有効です。

   • TENANT：システムテナントがすべてのユーザーテナント、すべてのMetaテナント、または指定されたテナントのテナントレベルの構成パラメータをリセットするために使用されます。

     • allとall_user：すべてのユーザーテナント。

       説明

       OceanBaseデータベースはバージョンV4.2.1から、TENANT = all_userとTENANT = allは同じ意味になりました。すべてのユーザーテナントに適用する必要がある場合は、TENANT = all_userの使用を推奨します。TENANT = allは今後廃止され、使用されなくなります。

     • all_meta：すべてのMetaテナント。

     • tenant_name：指定されたテナントのテナント名。

   パラメータをリセットする際、クラスタレベルのパラメータはユーザーテナントで設定できず、システムテナント（つまりsysテナント）からユーザーテナントの設定として指定することもできません。

   たとえば、ALTER SYSTEM SET memory_limit='100G' TENANT='test_tenant'ステートメントを実行すると、エラーが発生します。これはmemory_limitがクラスタレベルのパラメータだからです。パラメータがクラスタレベルかテナントレベルかを確認するには、SHOW PARAMETERS LIKE 'parameter_name';ステートメントの実行結果にあるscope列の値に基づいて判断できます：

   • scope値がCLUSTERの場合、クラスタレベルのパラメータです。

   • scope値がTENANTの場合、テナントレベルのパラメータです。

   例：

   • システムテナントがクラスタレベルとテナントレベルの構成パラメータの値をリセットする

     obclient [oceanbase]> ALTER SYSTEM RESET enable_sql_audit;
     

     obclient [oceanbase]> ALTER SYSTEM RESET undo_retention TENANT = all_user;
     

   • ユーザーテナントがテナントレベルの構成パラメータの値をリセットする

     obclient [oceanbase]> ALTER SYSTEM RESET undo_retention;
     

4. リセットが成功した後、実際の状況（OBServerノードの再起動または再起動なし）に応じて、SHOW PARAMETERSステートメントを使用して構成パラメータの値が正常にリセットされたかどうかを検証します。

   obclient [(none)]> SHOW PARAMETERS LIKE '%enable_sql_audit%';
   

   結果は次のとおりです：

   +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
   | zone  | svr_type | svr_ip         | svr_port | name             | data_type | value | info                                                                                                          | section  | scope   | source  | edit_level        | default_value | isdefault |
   +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
   | zone1 | observer | 172.xx.xxx.xxx |     2882 | enable_sql_audit | BOOL      | True  | specifies whether SQL audit is turned on. The default value is TRUE. Value: TRUE: turned on FALSE: turned off | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | true          |         1 |
   +-------+----------+----------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
   1 row in set
   

関連ドキュメント

• クラスタ構成パラメータ

• クラスタ構成パラメータの確認

• クラスタ構成パラメータの変更