SQLモード
TiDB サーバーは異なる SQL モードで動作し、クライアントごとに異なるモードを適用します。SQL モードは、TiDB がサポートする SQL 構文と、実行するデータ検証チェックの種類を定義します。以下に説明します。
TiDB を起動した後、 SET [ SESSION | GLOBAL ] sql_mode='modes'
ステートメントを使用して SQL モードを設定できます。
SQL モードを
GLOBAL
レベルに設定するときは、権限がSUPER
あることを確認してください。このレベルでの設定は、その後に確立される接続にのみ影響します。SESSION
レベルでの SQL モードの変更は、現在のクライアントにのみ影響します。
この文では、 modes
カンマ (',') で区切られたモードのセットです。3 SELECT @@sql_mode
を使用すると、現在の SQL モードを確認できます。SQL モードのデフォルト値はONLY_FULL_GROUP_BY, STRICT_TRANS_TABLES, NO_ZERO_IN_DATE, NO_ZERO_DATE, ERROR_FOR_DIVISION_BY_ZERO, NO_AUTO_CREATE_USER, NO_ENGINE_SUBSTITUTION
。
重要なsql_mode
値
ANSI
: このモードは標準SQLに準拠しています。このモードでは、データがチェックされます。データが定義された型または長さに準拠していない場合、データ型は調整またはトリミングされ、warning
返されます。STRICT_TRANS_TABLES
: 厳密モード。データは厳密にチェックされます。データに誤りがある場合は、テーブルに挿入できず、エラーが返されます。TRADITIONAL
: このモードでは、TiDBは「従来の」SQLデータベースシステムのように動作します。列に不正な値が挿入されると、警告ではなくエラーが返されます。その後、INSERT
またはUPDATE
ステートメントは直ちに停止されます。
SQL mode table
Name | 説明 |
---|---|
PIPES_AS_CONCAT | " |
ANSI_QUOTES | " 識別子として扱います。3 が有効になっている場合、一ANSI_QUOTES 引用符のみが文字列リテラルとして扱われ、二重引用符は識別子として扱われます。したがって、二重引用符は文字列を引用符で囲むために使用することはできません。(完全サポート) |
IGNORE_SPACE | このモードを有効にすると、システムはスペースを無視します。例えば、「user」と「user 」は同じものとして扱われます。(完全サポート) |
ONLY_FULL_GROUP_BY | SELECT 、 HAVING 、またはORDER BY 列を参照するSQL文は、集計もGROUP BY 節にも含まれず、無効です。これは、そのような列をクエリ結果に表示することが異常であるためです。この設定は、 tidb_enable_new_only_full_group_by_check システム変数の影響を受けます。(完全サポート) |
NO_UNSIGNED_SUBTRACTION | 減算時にオペランドに記号がない場合、結果をUNSIGNED としてマークしません。(完全サポート) |
NO_DIR_IN_CREATE | Ignores all INDEX DIRECTORY and DATA DIRECTORY directives when a table is created. This option is only useful for secondary replication servers (syntax support only) |
NO_KEY_OPTIONS | SHOW CREATE TABLE 文を使用すると、 ENGINE ような MySQL 固有の構文はエクスポートされません。mysqldump を使用して異なる種類のデータベースに移行する場合は、このオプションを検討してください。(構文サポートのみ) |
NO_FIELD_OPTIONS | SHOW CREATE TABLE 文を使用すると、 ENGINE ような MySQL 固有の構文はエクスポートされません。mysqldump を使用して異なる種類のデータベースに移行する場合は、このオプションを検討してください。(構文サポートのみ) |
NO_TABLE_OPTIONS | SHOW CREATE TABLE 文を使用すると、 ENGINE ような MySQL 固有の構文はエクスポートされません。mysqldump を使用して異なる種類のデータベースに移行する場合は、このオプションを検討してください。(構文サポートのみ) |
NO_AUTO_VALUE_ON_ZERO | このモードを有効にすると、 AUTO_INCREMENT 列目に渡された値が0 または特定の値の場合、システムはその値を直接この列に書き込みますNULL が渡された場合、システムは自動的に次のシリアル番号を生成します。(フルサポート) |
NO_BACKSLASH_ESCAPES | このモードを有効にすると、 \ バックスラッシュ記号はそれ自体のみを表します。(完全サポート) |
STRICT_TRANS_TABLES | トランザクションstorageエンジンの厳密モードを有効にし、不正な値が挿入された後にステートメント全体をロールバックします。(完全サポート) |
STRICT_ALL_TABLES | トランザクション テーブルの場合、不正な値が挿入された後にトランザクション ステートメント全体をロールバックします。(完全サポート) |
NO_ZERO_IN_DATE | 厳密モードでは、月または日の部分が0 である日付は受け入れられません。オプションIGNORE 使用すると、TiDBは類似の日付として「0000-00-00」を挿入します。非厳密モードでは、この日付は受け入れられますが、警告が返されます。(完全サポート) |
NO_ZERO_DATE | 厳密モードでは、「0000-00-00」を有効な日付として使用しません。ただし、 IGNORE オプションを使用して日付0を入力することは可能です。非厳密モードでは、この日付は受け入れられますが、警告が返されます。(完全サポート) |
ALLOW_INVALID_DATES | このモードでは、システムはすべての日付の有効性をチェックしません。1から1 12 の月の値と1 から31 までの日の値のみをチェックします。このモードはDATE とDATATIME 列目にのみ適用されます。13 TIMESTAMP すべてについて完全な有効性チェックが必要です。(フルサポート) |
ERROR_FOR_DIVISION_BY_ZERO | このモードを有効にすると、データ変更操作 ( INSERT またはUPDATE ) で0 による除算を処理するときにエラーが返されます。このモードが有効になっていない場合、システムは警告を返し、代わりに NULL 使用されます。(完全サポート) |
NO_AUTO_CREATE_USER | 指定されたパスワードを除いて、 GRANT 新しいユーザーを自動的に作成するのを防ぎます (完全サポート) |
HIGH_NOT_PRECEDENCE | NOT演算子の優先順位は、 NOT a BETWEEN b AND c のような式はNOT (a BETWEEN b AND c) として解析されるというものです。MySQLの古いバージョンでは、この式は(NOT a) BETWEEN b AND c として解析されます。(完全サポート) |
NO_ENGINE_SUBSTITUTION | 必要なstorageエンジンが無効になっているかコンパイルされていない場合は、storageエンジンの自動置き換えを防止します。(構文サポートのみ) |
PAD_CHAR_TO_FULL_LENGTH | このモードを有効にすると、システムはCHAR 種類の末尾のスペースをトリミングしません。(構文サポートのみ。このモードはMySQL 8.0で非推奨なっています。) |
REAL_AS_FLOAT | REAL FLOAT の同義語として扱い、 DOUBLE の同義語としては扱いません (完全サポート) |
POSTGRESQL | PIPES_AS_CONCAT ANSI_QUOTES NO_KEY_OPTIONS NO_TABLE_OPTIONS IGNORE_SPACE NO_FIELD_OPTIONS のみ) |
MSSQL | PIPES_AS_CONCAT ANSI_QUOTES NO_KEY_OPTIONS NO_TABLE_OPTIONS IGNORE_SPACE NO_FIELD_OPTIONS のみ) |
DB2 | Equivalent to PIPES_AS_CONCAT , ANSI_QUOTES , IGNORE_SPACE , NO_KEY_OPTIONS , NO_TABLE_OPTIONS , NO_FIELD_OPTIONS (syntax support only) |
MAXDB | PIPES_AS_CONCAT ANSI_QUOTES IGNORE_SPACE NO_AUTO_CREATE_USER NO_TABLE_OPTIONS NO_FIELD_OPTIONS NO_KEY_OPTIONS |
MySQL323 | Equivalent to NO_FIELD_OPTIONS , HIGH_NOT_PRECEDENCE (syntax support only) |
MYSQL40 | NO_FIELD_OPTIONS とHIGH_NOT_PRECEDENCE (構文サポートのみ) |
ANSI | REAL_AS_FLOAT PIPES_AS_CONCAT ANSI_QUOTES (構文IGNORE_SPACE のみ) |
TRADITIONAL | STRICT_TRANS_TABLES STRICT_ALL_TABLES NO_ZERO_DATE ERROR_FOR_DIVISION_BY_ZERO NO_AUTO_CREATE_USER NO_ZERO_IN_DATE のみ) |
ORACLE | PIPES_AS_CONCAT ANSI_QUOTES NO_KEY_OPTIONS NO_FIELD_OPTIONS IGNORE_SPACE NO_TABLE_OPTIONS NO_AUTO_CREATE_USER ) |