パラメータの設定

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';