SET 構文

SET PASSWORD はアカウント パスワードを割り当てます。詳しくは 項6. 「SET PASSWORD 構文」 を参照してください。

SET TRANSACTION ISOLATION LEVEL はトランザクション プロセスに分離レベルを設定します。詳しくは 項 「SET TRANSACTION 構文」 を参照してください。

SET は、ローカル ルーチン変数に値を割り当てる為のストアド ルーチン内で利用されます。詳しくは 項2. 「変数 SET ステートメント」 を参照してください。

変数がグローバルである事を明示的に指示する為には、その名前に GLOBAL か @@global. を先行させてください。SUPER 権限はグローバル変数を設定する為に要求されます。

変数がセッションである事を明示的に指示する為には、その名前に SESSION か @@global. を先行させてください。セッション変数を設定するのに特別な権限は必要とされませんが、クライアントは自分自身のセッション変数以外は変更できませんので、別のクライアントの物は変更できません。

LOCAL と @@local. は SESSION と @@session. の同義語です。

もし修飾子が何もなければ、SET はセッション変数を変更します。

AUTOCOMMIT = {0 | 1}

オート コミット モードを設定してください。もし1に設定すると、テーブルの全ての変更がすぐに効果を発揮します。もし0に設定すると、トランザクションを受け入れる為には COMMIT、キャンセルするには ROLLBACK を利用しなければいけません。デフォルトで、AUTOCOMMIT で始まるクライアント接続は1を設定します。もし AUTOCOMMIT モードを0から1に変更すると、MySQL は開いているトランザクションの自動 COMMIT を実行します。トランザクションを始める別の方法は、START TRANSACTION か BEGIN ステートメントを利用する方法です。詳しくは 項 「START TRANSACTION、COMMIT、そして ROLLBACK 構文」 を参照してください。

BIG_TABLES = {0 | 1}

もし1に設定すると、全てのテンポラリ テーブルは、メモリの中ではなくディスク上に格納されます。これはスピードが少し遅いですが、エラー The table tbl_name is full は、大きいテンポラリ テーブルを必要とする SELECT オペレーションにこれは起こりません。新しい接続のデフォルト値は0です。(メモリ内のテンポラリ テーブルを利用してください。)通常、メモリ内のテーブルは要求に従って自動的にディスク ベース テーブルに変換されるので、この変数を設定する必要は全くありません。(注意:この変数は以前は SQL_BIG_TABLES という名前でした。)

CHARACTER SET {charset_name | DEFAULT}

これは与えられたマッピングを利用して全ての文字列をクライアントとの間でマップします。MySQL ソース分布の中で sql/convert.cc を編集する事で新しいマッピングを追加する事ができます。SET CHARACTER SET は3つのセッション システム変数を設定します。character_set_client と character_set_results は与えたれた文字セットに設定され、 character_set_connection は character_set_database の値に設定されます。詳しくは 項9.4. 「接続のキャラクタセットおよび照合順序」 を参照してください。

デフォルトのマッピングは、値 DEFAULT を利用する事で復旧できます。デフォルトはサーバの設定によって決まります。

SET CHARACTER SET の構文は、別のほとんどのオプションを設定している物とは異なる事を覚えておいて下さい。

FOREIGN_KEY_CHECKS = {0 | 1}

もし1に設定すると(デフォルト)、InnoDB テーブルの外部キー制約が確認されます。もし0に設定すると、それらは無視されます。外部キー確認を無効にする事は、それらの親/子供関係に要求される順番とは異なる順番で InnoDB を再ロードするのに役立ちます。詳しくは 項4. 「FOREIGN KEY 制約」 を参照してください。

FOREIGN_KEY_CHECKS を0に設定する事もまた、データ定義ステートメントに影響を与えます。DROP SCHEMA は、スキーマ外のテーブルに参照される外部キーを持つテーブルを含んでいてもスキーマをドロップし、そして、DROP TABLE は別のテーブルに参照される外部キーを持つテーブルをドロップします。

IDENTITY = value

この変数は LAST_INSERT_ID 変数の同義語です。これは別のデータベース システムとの互換性の為に存在します。この値は SELECT @@IDENTITY を利用して読む事ができ、SET IDENTITY を利用して設定する事ができます。

INSERT_ID = value

AUTO_INCREMENT 値を挿入する時、次の INSERT か ALTER TABLE ステートメントで使用される値を設定してください。これは主にバイナリ ログと共に利用されます。

LAST_INSERT_ID = value

LAST_INSERT_ID() から返される値を設定してください。これは、テーブルを更新するステートメント内で LAST_INSERT_ID() を利用する時にバイナリ ログ内に格納されます。この変数を設定する事で、mysql_insert_id() C API 関数に返される値は更新されません。

NAMES {'charset_name' [COLLATE 'collation_name'} | DEFAULT}

SET NAMES は3つのセッション システム変数 character_set_client、character_set_connection、そして character_set_results を与えられた文字セットに設定します。character_set_connection を charset_name に設定すると、collation_connection も charset_name のデフォルト照合に設定します。任意の COLLATE 条項は照合を明示的に指定するのに利用されるでしょう。詳しくは 項9.4. 「接続のキャラクタセットおよび照合順序」 を参照してください。

デフォルトのマッピングは、値 DEFAULT を利用する事で復旧できます。デフォルトはサーバの設定によって決まります。

SET NAMES の構文は、別のほとんどのオプションを設定している物とは異なる事を覚えておいて下さい。

ONE_SHOT

このオプションは変数ではなく修飾子です。これは、文字セット、照合、そしてタイム ゾーンを設定する変数の効果に影響を与える為に利用する事ができます。ONE_SHOT は主に複製を目的として利用されます。文字セット、照合、そしてタイム ゾーン変数の値をロールフォーワードで元の形を反映させる為に、mysqlbinlog はそれらをテンポラリに修正できるよう SET ONE_SHOT を利用します。ONE_SHOT は内部的な利用の為だけの物で、MySQL 5.0 以降のバージョンでは廃止予定です。

ONE_SHOT を許容された変数のセット以外の物と利用する事はできません。もし利用を試みると、次のようなエラーが発生します。

mysql> SET ONE_SHOT max_allowed_packet = 1;
ERROR 1382 (HY000): The 'SET ONE_SHOT' syntax is reserved for purposes
internal to the MySQL server

もし ONE_SHOT が許容された変数と共に利用されたら、それは要求されたとおりに変数を変更しますが、それは次の非 SET ステートメントに対してのみ行われます。その後、サーバは全ての文字セット、照合、そしてタイム ゾーンに関連したシステム変数を、以前の値に再設定します。例:

mysql> SET ONE_SHOT character_set_connection = latin5;

mysql> SET ONE_SHOT collation_connection = latin5_turkish_ci;

mysql> SHOW VARIABLES LIKE '%_connection';
+--------------------------+-------------------+
| Variable_name            | Value             |
+--------------------------+-------------------+
| character_set_connection | latin5            |
| collation_connection     | latin5_turkish_ci |
+--------------------------+-------------------+

mysql> SHOW VARIABLES LIKE '%_connection';
+--------------------------+-------------------+
| Variable_name            | Value             |
+--------------------------+-------------------+
| character_set_connection | latin1            |
| collation_connection     | latin1_swedish_ci |
+--------------------------+-------------------+

SQL_AUTO_IS_NULL = {0 | 1}

もし1に設定すると(デフォルト)、次の構造を利用する事で AUTO_INCREMENT カラムを含む最後にテーブルに挿入された行を見つける事ができます。

WHERE auto_increment_column IS NULL

この動作は、Access のようないくつかの ODBC プログラムによって利用されます。

SQL_BIG_SELECTS = {0 | 1}

もし0に設定すると、MySQL は、実行するのにとても時間がかかる SELECT ステートメントを異常終了します。(これはオプチマイザが、分析された行の数が max_join_size の値を超えると判断したステートメントの事です。)これは、得策では無い WHERE ステートメントが発行された時に便利な物です。新しい接続のデフォルト値は、全ての SELECT ステートメントを許容する1です。

もし max_join_size システム変数を DEFAULT 以外の値に設定すると、SQL_BIG_SELECTS は0に設定されます。

SQL_BUFFER_RESULT = {0 | 1}

もし1に設定すると、SQL_BUFFER_RESULT は結果が SELECT ステートメントからテンポラリ テーブルに置かれるように強制します。これは、MySQL がテーブル ロックを早く解除するのを助け、クライアントに結果を送るのに時間がかかる場合に有益な物になります。 デフォルト値は0です。

SQL_LOG_BIN = {0 | 1}

もし0に設定すると、クライアントの為のバイナリ ログはログされません。クライアントはこのオプションを設定する為に SUPER 権限を持つ必要があります。デフォルト値は1です。

SQL_LOG_OFF = {0 | 1}

もし1に設定すると、このクライアントの為の通常のクエリ ログはログされません。クライアントはこのオプションを設定する為に SUPER 権限を持つ必要があります。デフォルト値は0です。

SQL_LOG_UPDATE = {0 | 1}

この変数は廃止予定であり、SQL_LOG_BIN にマップされています。

SQL_NOTES = {0 | 1}

もし1に設定すると(デフォルト)、Note レベルの警告が記録されます。もし0に設定すると Note 警告は抑制されます。mysqldump はダンプ ファイルの再ロードが、その操作のインテグリティに影響しないイベントに対して警告を発行しないよう、この変数を0に設定する為にアウトプットを含みます。

SQL_QUOTE_SHOW_CREATE = {0 | 1}

もし1に設定すると(デフォルト)、サーバは SHOW CREATE TABLE と SHOW CREATE DATABASE ステートメントに識別子を引用します。もし0に設定すると、引用は無効になります。このオプションは、引用を必要とする識別子に対して複製が機能するように、デフォルトで使用可能となっています。項9. 「SHOW CREATE TABLE 構文」 と 項6. 「SHOW CREATE DATABASE 構文」 を参照して下さい。

SQL_SAFE_UPDATES = {0 | 1}

もし1に設定すると、MySQL は WHERE 条項か LIMIT 条項内でキーを利用しない UPDATE か DELETE ステートメントを異常終了します。これは、キーが正しく利用されずその為に多数の行を変更、または削除する UPDATE か DELETE ステートメントをキャッチする事を可能にします。デフォルト値は0です。

SQL_SELECT_LIMIT = {value | DEFAULT}

SELECT ステートメントから返される最大行数。新しい接続のデフォルト値は 「無制限」 です。もしその制限を変更すると、デフォルト値は DEFAULT の SQL_SELECT_LIMIT 値を利用して復旧できます。

もし SELECT が LIMIT 条項を持っていたら、LIMIT は SQL_SELECT_LIMIT の値を上回ります。

SQL_SELECT_LIMIT は、ストアド ルーチン内で実行された SELECT ステートメントに適応しません。それは、クライアントに戻される結果セットを作成しない SELECT ステートメントには適応しません。これらはサブクエリの中に SELECT ステートメント、CREATE TABLE ... SELECT、そして INSERT INTO ... SELECT を含んでいます。

SQL_WARNINGS = {0 | 1}

この変数は、もし警告が発生したら、単列 INSERT ステートメントが情報を作成するかどうかをコントロールします。デフォルトは0です。情報文字列を作成するには、値を0に設定して下さい。

TIMESTAMP = {timestamp_value | DEFAULT}

このクライアントに時刻を設定してください。これは、もし行の格納にバイナリ ログを利用するなら、元のタイムスタンプを得る為に利用されます。 timestamp_value は MySQL タイムスタンプではなく、ユニックス エポック タイムスタンプでなければいけません。

SET TIMESTAMP は NOW() に返された値に影響しますが、SYSDATE() に返された物には影響しません。これは、バイナリ ログ内のタイムスタンプ設定は SYSDATE() の起動に影響を持たないという意味です。サーバは、SYSDATE() が NOW() のエイリアスになるよう働きかける為に --sysdate-is-now オプションでスタートでき、その場合、SET TIMESTAMP は両方の関数に影響を与えます。

UNIQUE_CHECKS = {0 | 1}

もし1に設定すると(デフォルト)、InnoDB テーブル内の第二インデックスの一意性チェックが行われます。もし0に設定すると、ストレージ エンジンはインプット データ内に複製キーが存在しないと仮定する事を許可されます。もし、ご自分のデータに一意性違反が無い事が確かであれば、これを0に設定して InnoDB に大きいテーブルをインポートする際のスピードを早くする事ができます。

この変数を0に設定する事は、ストレージ エンジンが複製キーを無視する事を 要求 する訳ではないと覚えておいて下さい。エンジンは複製キーの確認をし、もしそれらを発見したらエラーを発行する事が許可されています。