パラメータの設定

MySQLモードで構成パラメータを変更するSQL構文は以下のとおりです：

ALTER SYSTEM [SET]
parameter_name = expression [SCOPE = {SPFILE | BOTH}] [COMMENT [=] 'text']
[ TENANT [=] ALL|all_user|all_meta|tenant_name ] {SERVER [=] 'ip:port' | ZONE [=] 'zone'};

パラメータの説明：

• parameter_name：変更する構成パラメータ名を指定します。

• expression：変更後の構成パラメータ値を指定します。

• COMMENT 'text'：この変更に関するコメントを追加します。このパラメータはオプションですが、省略しないことを推奨します。

• SCOPE：この構成パラメータ変更の適用範囲を指定します。デフォルトはBOTHです。

  • SPFILE：内部テーブル内の構成パラメータ値のみを変更し、OBServerノードの再起動後にのみ有効になることを示します。再起動後にのみ有効になる構成パラメータのみサポートされます。

  • BOTH：内部テーブル内の構成パラメータ値とメモリ内の構成パラメータ値の両方を変更し、変更は即時に有効になり、OBServerノードの再起動後も構成値は引き続き有効です。

• TENANT：システムテナント内で、すべてまたは指定されたテナントのテナントレベルの構成パラメータを変更するために使用されます。

  • ALL：V4.2.1バージョンから、tenant = allとtenant = all_userは同じ意味を持ち、どちらもすべてのユーザーテナントに対して有効であることを示します。all構文は廃止されつつあり、使用は推奨されません。

  • all_user：すべてのユーザーテナントに対して有効です。

  • all_meta：すべてのMETAテナントに対して有効です。

  • tenant_name：テナントを指定します。

• SERVER：指定されたServerインスタンスの特定の構成パラメータのみを変更します。

• ZONE：この構成パラメータの変更が指定されたクラスタの特定のServerタイプに対して行われることを示します。それ以外の場合は、すべてのクラスタの特定のServerタイプに対して行われます。

  説明

  • 複数の構成パラメータを同時に変更する場合は、カンマ（,）で区切ります。
  • クラスタレベルの構成パラメータは、通常のテナント設定では変更できず、システムテナント（sysテナント）から通常のテナント設定として指定することもできません。システムテナント内でのみ設定が可能です。例えば、ALTER SYSTEM SET memory_limit='100G' TENANT='test_tenant'ステートメントを実行するとエラーが発生します。これは、memory_limitがクラスタレベルの構成パラメータだからです。
  • テナントレベルの構成パラメータは、そのテナント内で直接変更することも、システムテナント内でTENANTキーワードを指定して変更することもできます。
  • ALTER SYSTEMステートメントでは、ZoneとOBServerを同時に指定することはできません。また、Zoneを指定する場合は1つのZoneのみ、OBServerを指定する場合は1つのOBServerのみを指定できます。変更時にZoneもOBServerも指定しない場合、クラスタレベルの構成パラメータはクラスタ内のすべてのOBServer上で有効になり、テナントレベルの構成パラメータは現在のテナントがクラスタ内に存在するOBServer上で有効になります。
  • 構成パラメータがクラスタレベルかテナントレベルかを確認するには、SHOW PARAMETERSステートメントの実行結果におけるscope列の対応する値に基づいて判断できます。
  • scope値がCLUSTERの場合、クラスタレベルの構成パラメータを示します。
  • scope値がTENANTの場合、テナントレベルの構成パラメータを示します。

log_disk_utilization_threshold構成パラメータを変更する例は次のとおりです：

obclient> ALTER SYSTEM SET log_disk_utilization_threshold = 20;

指定されたZoneのlog_disk_utilization_threshold構成パラメータを変更する例は次のとおりです：

obclient> ALTER SYSTEM SET log_disk_utilization_threshold = 20 ZONE='z1';

指定されたOBServerのlog_disk_utilization_threshold構成パラメータを変更する例は次のとおりです：

obclient> ALTER SYSTEM SET log_disk_utilization_threshold = 20 SERVER='XXX.XXX.XXX.XXX:XXXXX';

システムテナント内で、すべてまたは指定されたテナントのテナントレベルの構成パラメータを変更します。例：

obclient> ALTER SYSTEM SET log_disk_utilization_threshold = 20 TENANT='ALL';

obclient> ALTER SYSTEM SET log_disk_utilization_threshold = 20 TENANT='Oracle';

MySQLモードで構成パラメータをリセットするSQL構文は以下のとおりです：

ALTER SYSTEM [RESET]
parameter_name [SCOPE = {MEMORY | SPFILE | BOTH}] {TENANT [=] 'tenant_name'};

パラメータの説明：

• RESET は、現在のパラメータ値をクリアし、パラメータのデフォルト値または起動時値を使用します。

• SCOPE：今回の構成パラメータ変更の有効範囲を指定します。デフォルトは BOTH です。

  • MEMORY：メモリ内の構成パラメータ値のみをリセットし、変更は即時に反映されます。ただし、この変更はOBServerノードの再起動後に無効になります（現在、この方法をサポートする構成パラメータはありません）。

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

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

• TENANT：システムテナント内で、すべてまたは指定されたテナントのテナントレベルの構成パラメータをリセットします。

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

  説明

  • 複数の構成パラメータを同時にリセットする場合は、カンマ（,）で区切ります。
  • クラスタレベルの構成パラメータは、通常のテナントからリセットすることはできず、システムテナント（つまり sys テナント）から通常のテナントにリセットすることもできません。システムテナント内でのみリセットがサポートされています。例えば、ALTER SYSTEM RESET memory_limit TENANT='test_tenant' ステートメントを実行するとエラーが発生します。これは、memory_limit がクラスタレベルの構成パラメータだからです。
  • テナントレベルの構成パラメータは、そのテナント内で直接変更することも、システムテナント内で TENANT キーワードを指定して変更することもできます。
  • ALTER SYSTEM RESET ステートメントでは、ゾーンやOBServerを指定することはサポートされていません。
  • 構成パラメータがクラスタレベルかテナントレベルかを確認するには、SHOW PARAMETERS ステートメントの実行結果にある scope 列の対応する値に基づいて判断できます：
  • scope 値が CLUSTER の場合、クラスタレベルの構成パラメータです。
  • scope 値が TENANT の場合、テナントレベルの構成パラメータです。

log_disk_utilization_threshold パラメータをリセットする例は次のとおりです：

obclient> ALTER SYSTEM RESET log_disk_utilization_threshold;

システムテナント内で、すべてまたは指定されたテナントのテナントレベルの構成パラメータをリセットします。例：

obclient> ALTER SYSTEM RESET log_disk_utilization_threshold TENANT='ALL';
obclient> ALTER SYSTEM RESET log_disk_utilization_threshold TENANT='Oracle';