このテーブルには、オプションごとに 1 行ずつ、sys スキーマ構成オプションが含まれています。 このテーブルを更新して行われた構成変更は、クライアントセッションおよびサーバーの再起動後も保持されます。

sys_config テーブルには、次のカラムがあります:

sys_config テーブルからの直接読取りの数を最小限に抑える効率的な方法として、このテーブルの値を使用する sys スキーマ関数は、対応する名前を持つユーザー定義変数 (同じ名前と@sys. 接頭辞を持つユーザー定義変数) をチェックします。 (たとえば、diagnostics.include_raw オプションに対応する変数は@sys.diagnostics.include_raw です。) ユーザー定義変数が現在のセッションに存在し、NULL 以外の場合、関数は sys_config テーブルの値よりも優先してその値を使用します。 それ以外の場合、関数はテーブルの値を読み取って使用します。 後者の場合、コール側関数は従来どおり、対応するユーザー定義変数をテーブルの値に設定するため、同じセッション内の構成オプションへのさらなる参照で変数が使用され、テーブルを再度読み取る必要はありません。

たとえば、statement_truncate_len オプションは、format_statement() 関数によって戻されるステートメントの最大長を制御します。 デフォルトは 64 です。 現在のセッションの値を一時的に 32 に変更するには、対応する@sys.statement_truncate_len ユーザー定義変数を設定します:

mysql> SET @stmt = 'SELECT variable, value, set_time, set_by FROM sys_config';
mysql> SELECT sys.format_statement(@stmt);
+----------------------------------------------------------+
| sys.format_statement(@stmt)                              |
+----------------------------------------------------------+
| SELECT variable, value, set_time, set_by FROM sys_config |
+----------------------------------------------------------+
mysql> SET @sys.statement_truncate_len = 32;
mysql> SELECT sys.format_statement(@stmt);
+-----------------------------------+
| sys.format_statement(@stmt)       |
+-----------------------------------+
| SELECT variabl ... ROM sys_config |
+-----------------------------------+

セッション内でのその後の format_statement() の起動では、テーブル (64) に格納されている値ではなく、ユーザー定義の変数値 (32) が引き続き使用されます。

ユーザー定義変数の使用を停止し、テーブルの値の使用に戻すには、セッション内で変数を NULL に設定します:

mysql> SET @sys.statement_truncate_len = NULL;
mysql> SELECT sys.format_statement(@stmt);
+----------------------------------------------------------+
| sys.format_statement(@stmt)                              |
+----------------------------------------------------------+
| SELECT variable, value, set_time, set_by FROM sys_config |
+----------------------------------------------------------+

または、現在のセッションを終了して (ユーザー定義変数が存在しなくなります)、新しいセッションを開始します。

sys_config テーブルのオプションとユーザー定義変数の間に記述されている従来の関係を利用して、セッションの終了時に終了する一時的な構成変更を行うことができます。 ただし、ユーザー定義変数を設定してから、同じセッション内で対応するテーブルの値を変更した場合、NULL 以外の値を持つユーザー定義変数が存在するかぎり、変更されたテーブルの値はそのセッションでは使用されません。 (変更されたテーブルの値は、ユーザー定義変数が割り当てられていない他のセッションで使用されます。)

次のリストでは、sys_config テーブルのオプションおよび対応するユーザー定義変数について説明します:

その他のオプションは、sys_config テーブルに追加できます。 たとえば、diagnostics() および execute_prepared_stmt() プロシージャでは、debug オプションが存在する場合にそれを使用しますが、デバッグ出力は通常、対応する@sys.debug ユーザー定義変数を設定することによって一時的にのみ有効になるため、このオプションはデフォルトで sys_config テーブルの一部ではありません。 個々のセッションで変数を設定せずにデバッグ出力を有効にするには、テーブルにオプションを追加します:

mysql> INSERT INTO sys.sys_config (variable, value) VALUES('debug', 'ON');

テーブルのデバッグ設定を変更するには、次の 2 つの操作を行います。 まず、テーブル自体の値を変更します:

mysql> UPDATE sys.sys_config
       SET value = 'OFF'
       WHERE variable = 'debug';

次に、現在のセッション内でプロシージャを起動する際に、テーブルの変更された値が使用されるようにするには、対応するユーザー定義変数を NULL に設定します:

mysql> SET @sys.debug = NULL;