ユーザー定義変数はセッション内でローカルに作成され、そのセッションのコンテキスト内にのみ存在します。セクション9.4「ユーザー定義変数」 を参照してください。

ユーザー定義変数は@var_name として書き込まれ、次のように式の値が割り当てられます:

SET @var_name = expr;

例:

SET @name = 43;
SET @total_tax = (SELECT SUM(tax) FROM taxable_transactions);

これらのステートメントで示されているように、expr では単純 (リテラル値) から複雑 (スカラーサブクエリーによって返される値) までの範囲を指定できます。

パフォーマンススキーマ user_variables_by_thread テーブルには、ユーザー定義変数に関する情報が含まれています。 セクション27.12.10「パフォーマンススキーマのユーザー定義変数テーブル」を参照してください。

SET は、定義されているストアドオブジェクトのコンテキストで、パラメータおよびローカル変数に適用されます。 次の手順では、increment プロシージャパラメータおよび counter ローカル変数を使用します:

CREATE PROCEDURE p(increment INT)
BEGIN
  DECLARE counter INT DEFAULT 0;
  WHILE counter < 10 DO
    -- ... do work ...
    SET counter = counter + increment;
  END WHILE;
END;

MySQL サーバーは、その操作を構成するシステム変数を保持します。 システム変数には、サーバー操作全体に影響するグローバル値、現在のセッションに影響するセッション値、またはその両方を指定できます。 多くのシステム変数は動的であり、SET ステートメントを使用して実行時に変更し、現在のサーバーインスタンスの操作に影響を与えることができます。 SET を使用して、特定のシステム変数をデータディレクトリ内の mysqld-auto.cnf ファイルに永続化し、後続の起動のためのサーバー操作に影響を与えることもできます。

セッションシステム変数を変更しても、変数を別の値に変更するか、セッションが終了するまで、その値はセッション内で有効なままです。 この変更は、他のセッションには影響しません。

グローバルシステム変数を変更した場合、値は記憶され、変数を別の値に変更するかサーバーが終了するまで、新しいセッションのセッション値の初期化に使用されます。 変更は、グローバル値にアクセスするすべてのクライアントに表示されます。 ただし、変更は、変更後に接続するクライアントの対応するセッション値にのみ影響します。 グローバル変数の変更は、現在のクライアントセッションのセッション値には影響しません (グローバル値の変更が発生したセッションにも影響しません)。

グローバルシステム変数設定をサーバーの再起動後も適用されるように永続化するには、データディレクトリ内の mysqld-auto.cnf ファイルに永続化します。 my.cnf オプションファイルを手動で変更して永続的な構成変更を行うこともできますが、これは面倒であり、手動で入力した設定のエラーは後で検出されない可能性があります。 構文エラーのある設定は成功せず、サーバー構成を変更しないため、システム変数を永続化する SET ステートメントはより便利であり、不正な設定が発生する可能性を回避します。 システム変数および mysqld-auto.cnf ファイルの永続化の詳細は、セクション5.1.9.3「永続化されるシステム変数」 を参照してください。

次の説明では、システム変数を設定および永続化するための構文オプションについて説明します:

グローバルシステム変数値をコンパイル済の MySQL デフォルト値に設定するか、セッションシステム変数を現在対応するグローバル値に設定するには、変数を値 DEFAULT に設定します。 たとえば、次の 2 つのステートメントは、max_join_size のセッション値を現在のグローバル値に設定する場合と同じです:

SET @@SESSION.max_join_size = DEFAULT;
SET @@SESSION.max_join_size = @@GLOBAL.max_join_size;

SET を使用してグローバルシステム変数を DEFAULT の値またはリテラルのデフォルト値に永続化すると、変数のデフォルト値が割り当てられ、変数の設定が mysqld-auto.cnf に追加されます。 ファイルから変数を削除するには、RESET PERSIST を使用します。

一部のシステム変数は永続化できないか、永続的に制限されています。 セクション5.1.9.4「永続的で永続的に制限されないシステム変数」を参照してください。

プラグインによって実装されたシステム変数は、SET ステートメントの実行時にプラグインがインストールされた場合に永続化できます。 永続化されたプラグイン変数の割り当ては、プラグインがまだインストールされている場合、それ以降のサーバーの再起動で有効になります。 プラグインがインストールされなくなった場合、サーバーが mysqld-auto.cnf ファイルを読み取るときにプラグイン変数は存在しなくなります。 この場合、サーバーはエラーログに警告を書き込み、続行します:

currently unknown variable 'var_name'
was read from the persisted config file

システム変数の名前と値を表示するには:

SET ステートメントの変数割当てが失敗した場合、ステートメント全体が失敗し、変数は変更されず、mysqld-auto.cnf ファイルも変更されません。

SET では、ここで説明する状況下でエラーが発生します。 ほとんどの例は、キーワード構文 (GLOBAL や SESSION など) を使用する SET ステートメントを示していますが、対応する修飾子 (@@GLOBAL. や@@SESSION. など) を使用するステートメントにも原則が当てはまります。

SET ステートメントは、カンマで区切られた複数の変数割り当てを含むことができます。 次のステートメントは、ユーザー定義変数とシステム変数に値を代入します:

SET @x = 1, SESSION sql_mode = '';

単一のステートメントで複数のシステム変数を設定した場合、ステートメントの最新の GLOBAL, PERSIST, PERSIST_ONLY または SESSION キーワードが、キーワードが指定されていない次の割当てに使用されます。

複数変数割当ての例:

SET GLOBAL sort_buffer_size = 1000000, SESSION sort_buffer_size = 1000000;
SET @@GLOBAL.sort_buffer_size = 1000000, @@LOCAL.sort_buffer_size = 1000000;
SET GLOBAL max_connections = 1000, sort_buffer_size = 1000000;

@@GLOBAL., @@PERSIST., @@PERSIST_ONLY., @@SESSION. および@@修飾子は、直後のシステム変数にのみ適用され、残りのシステム変数には適用されません。 次のステートメントは、sort_buffer_size グローバル値を 50000 に、セッション値を 1000000 に設定します:

SET @@GLOBAL.sort_buffer_size = 50000, sort_buffer_size = 1000000;

式でシステム変数の値を参照するには、いずれかの@@-modifiers を使用します (式では許可されていない@@PERSIST. および@@PERSIST_ONLY. を除く)。 たとえば、次のような SELECT ステートメントでシステム変数値を取得できます:

SELECT @@GLOBAL.sql_mode, @@SESSION.sql_mode, @@sql_mode;