Skip to content

Latest commit

 

History

History
366 lines (289 loc) · 41.7 KB

mysql-errors.ja.md

File metadata and controls

366 lines (289 loc) · 41.7 KB

MySQL: 検査器が予測する文のエラー

English

MySQLのアナライザーが文の形から予測するものを、サーバのエラー番号で並べる。列が格納できない値、サーバが計算できない定数式、サーバが拒む関数引数、CREATE時にサーバが拒むトリガやルーチンの本体、解決できない名前、書き込めないビュー。診断にMySQLのエラー番号が載っていたら、索引で番号を引く。Go型、制約名、ランタイム、サーバ設定はmysql.ja.mdにある。

各項目は2種類のどちらかである。エラーは確実に起きるもので、実行のたびに同じように失敗するため、vetが報告し、文を直す必要がある。失敗モードは実行時に一部の行や値で起こりうるもので、文のexpect行に書き、mysql.Violates(err, "<番号>")が一致する。どちらにもなりうる項目は、どの位置ならどちらになるかを書いてある。

このページに書いた挙動は、すべてmysqld 8.4に対して実測したものである(検査器が埋め込んでいるもの)。他のバージョンのサーバでもプログラムは動くが、そのサーバの挙動が違う箇所では、判定がサーバの実際の動きと一致することは保証しない。

エラー番号の索引

制約違反(1062、1451、1452、3819、1048、1369、1423)はmysql.ja.mdに、トリガやルーチン自身のSIGNALの番号はmysql.ja.mdにある。

エラー 載っている節
1048 結果集合を返さない文
1052 名前解決
1054 トリガとストアドルーチンとイベント, 名前解決, ビュー
1062 ビュー, 結果集合を返さない文
1066 名前解決, 結果集合を返さない文
1093 名前解決, ビュー
1136 ビュー, 結果集合を返さない文
1146 トリガとストアドルーチンとイベント, ビュー, 結果集合を返さない文
1193 関数呼び出しの引数とシステム変数の読み取り, トリガとストアドルーチンとイベント
1210 定数引数の関数, 空間型
1222 トリガとストアドルーチンとイベント, 結果集合を返さない文
1231 トリガとストアドルーチンとイベント
1238 関数呼び出しの引数とシステム変数の読み取り
1247 名前解決
1248 名前解決
1263 結果集合を返さない文
1264 列に格納する値
1265 列に格納する値
1288 ビュー, 結果集合を返さない文
1292 列に格納する値, 定数の変換, 定数引数の関数
1304 トリガとストアドルーチンとイベント
1305 トリガとストアドルーチンとイベント
1308 トリガとストアドルーチンとイベント
1313 トリガとストアドルーチンとイベント
1314 トリガとストアドルーチンとイベント
1318 トリガとストアドルーチンとイベント
1320 トリガとストアドルーチンとイベント
1324 トリガとストアドルーチンとイベント
1327 トリガとストアドルーチンとイベント
1328 トリガとストアドルーチンとイベント
1331 トリガとストアドルーチンとイベント
1332 トリガとストアドルーチンとイベント
1333 トリガとストアドルーチンとイベント
1336 トリガとストアドルーチンとイベント
1339 トリガとストアドルーチンとイベント
1347 ビュー
1348 ビュー
1353 名前解決
1359 トリガとストアドルーチンとイベント
1360 トリガとストアドルーチンとイベント
1362 トリガとストアドルーチンとイベント
1363 トリガとストアドルーチンとイベント
1364 ビュー, 結果集合を返さない文
1366 列に格納する値
1368 ビュー
1382 定数引数の関数
1393 ビュー
1394 ビュー
1395 ビュー
1406 列に格納する値
1407 トリガとストアドルーチンとイベント
1411 定数引数の関数
1413 トリガとストアドルーチンとイベント
1414 トリガとストアドルーチンとイベント
1415 トリガとストアドルーチンとイベント
1416 列に格納する値, 空間型
1422 トリガとストアドルーチンとイベント
1423 ビュー
1424 トリガとストアドルーチンとイベント
1442 トリガとストアドルーチンとイベント
1443 名前解決, ビュー
1452 結果集合を返さない文
1456 トリガとストアドルーチンとイベント
1471 ビュー
1525 定数の変換
1582 関数呼び出しの引数とシステム変数の読み取り
1583 関数呼び出しの引数とシステム変数の読み取り
1584 関数呼び出しの引数とシステム変数の読み取り
1645 トリガとストアドルーチンとイベント
1690 定数の算術, 定数の変換, 空間型
3011 トリガとストアドルーチンとイベント
3037 空間型
3516 空間型
3548 空間型
3566 関数呼び出しの引数とシステム変数の読み取り
3594 名前解決
3643 空間型
3819 結果集合を返さない文
6037 名前解決

列に格納する値

列が決して格納できないリテラルは、失敗モードではなく文自身のエラーとして報告する。厳密モード(既定)では毎回必ず失敗するからである。検査器は、INSERT ... VALUES、UPDATE ... SET、ON DUPLICATE KEY UPDATE、REPLACEで列に直接書かれたリテラルに、サーバが列に値を格納するときの規則をそのまま適用する。

格納先 拒まれるもの エラー
整数列 範囲外の値(実数・小数は丸めた後で判定) 1264
数を含まない文字列('abc'、'') 1366
数の後ろに他の文字が続く文字列('12a') 1265
YEAR 0、1〜99、1901〜2155以外 1264
DECIMAL(M,D) D桁に丸めた後で整数部がM-D桁を超えるもの。UNSIGNEDへの負数 1264
FLOAT 単精度の範囲を超える値 1264
DATE / DATETIME / TIMESTAMP サーバが日付時刻として読めない、範囲外、sql_modeが禁じる月・日・日付のゼロ(NO_ZERO_IN_DATE、NO_ZERO_DATE)、その月に無い日(ALLOW_INVALID_DATESでなければ)の文字列。サーバが日付時刻として受け付けない数。1970-01-01 00:00:01〜2038-01-19 03:14:07 UTCの外のTIMESTAMP(セッションのタイムゾーンで結論が変わらない範囲だけ判定) 1292
TIME サーバが時刻として読めない文字列、60以上の分・秒、838時間超 1292
CHAR(n) / VARCHAR(n) / BINARY(n) / VARBINARY(n) 末尾の空白を除いてn文字(バイナリならnバイト)を超える文字列 1406
ENUM どのメンバーの名前でもなく(照合順序どおりに比較)メンバーの番号でもない文字列。1〜メンバー数の外の数 1265
SET 集合に無いメンバーを含むリスト 1265
空間型 数と文字列。どちらも正しい形のジオメトリを持てない 1416

読まないもの:

  • INSERT IGNORE / UPDATE IGNOREと、sql_modeが厳密でないスキーマ(値は警告付きで調整して格納される。STRICT_TRANS_TABLESだけの下では非トランザクショナルな表は最初の行だけ厳密)
  • ルーチンやトリガの本体の中の値
  • 16進・ビットのリテラル、JSONとBITの列
  • サーバが畳み込む式(100 + 28)

定数の算術

サーバが計算できない定数式は文自身の1690で、行を読む前に判定される(サーバの計算どおり):

式 エラー
厳密な結果がBIGINT(オペランドのどちらかが符号なしならBIGINT UNSIGNED)に収まらない整数の+ - * DIV(9223372036854775807 * 2、CAST(1 AS UNSIGNED) - 2、-9223372036854775808 DIV -1。文字列オペランドは演算子をDOUBLEに、小数オペランドはDECIMALにする。どちらも判定しない)。ABS(-9223372036854775808)。整数の範囲を超えるROUND(n, -k) 1690 BIGINT [UNSIGNED] value is out of range
無限大になるDOUBLEの結果: 1e308 + 1e308、1e300 / 1e-300、EXP(710)、POW(2, 1024)、COT(0)、DEGREES(1e307)。FLT_MAXを超えるCAST(x AS FLOAT) 1690 DOUBLE value is out of range
関数や演算子が計算したDOUBLEをBIGINTの範囲外でCAST(f AS SIGNED / UNSIGNED)する(CAST(POW(2, 63) AS SIGNED)。リテラルは丸め込まれるだけ) 1690。内側の式の名で
定数nが1〜1024の外のRANDOM_BYTES(n) 1690 length value is out of range

定数がどこに置かれているかで、文が失敗するのか行が失敗するのかが決まる。

  • 文のエラーになる位置——オプティマイザが行を読む前に畳み込む場所: WHERE・HAVING・ONの条件の項(キーのある列と比較するid = 9223372036854775807 + 1、IN (...)、LIKE)、FROMの無い問い合わせの選択項目、派生表・CTEの選択項目、INSERT ... VALUESの値
  • 行ごとに実行される位置: FROMのある問い合わせの選択項目、UPDATEのSET、ON DUPLICATE KEY UPDATEの代入、索引の無い列との比較、HAVINGでの集約との比較。この場合、文は失敗モード1690を持ち(mysql.Violates(err, "1690")が一致する)、行の無い問い合わせは失敗しない
  • サーバが評価しない場所は検査器も放っておく: AND / ORを決めた定数の後ろ(1 = 0 AND x)、定数条件のIF / CASE / COALESCE / IFNULLが取らない枝、定数のINが一致した後ろのリスト、NULLになりえないxのx IS NULL、GROUP BY / ORDER BYの項目、EXISTSのサブクエリの選択リスト、LIMIT 0
  • 読まないもの: トリガやルーチンの本体、16進 / ビットリテラルのオペランド、ユーザー変数、ウィンドウのORDER BY、DECIMALの桁溢れ(65桁)

定数の変換

厳密モードのINSERT / REPLACE / UPDATE / DELETE(IGNOREの外)は、定数の変換が出す警告をエラー1292 ER_TRUNCATED_WRONG_VALUEに格上げする。SELECT・SET・DO・非厳密の書き込みでは、同じ式が警告つきで実行される(行があっても):

式 失敗する条件
定数のCAST / CONVERTをDATE / DATETIMEへ 値がセッションのゼロ日付フラグの下でdatetimeでない(CAST('2004-10-0' AS DATE)、CAST(65 AS DATETIME))
... TIMEへ サーバが時刻として読めない、または838時間を超える
... YEARへ 文字列の先頭の整数の後ろに何かが続く('2020extra'、'2020.5')か、値が0〜99・1901〜2155の外。数字が全く無い文字列は警告なしの0
... CHAR(n)へ 値の文字列形がnより長い(CAST(1000 AS CHAR(3)))
... SIGNED / UNSIGNEDへ 文字列が整数そのものでない('abc'、'1.5'、'1e2')か、絶対値がBIGINT UNSIGNEDを超える。範囲外の小数
... DOUBLE / FLOAT / DECIMALへ 文字列が数を持たない、後ろに余りがある、doubleの読みが溢れる('1e999')
定数のTIMESTAMP(x) xがdatetimeでない(時刻だけの文字列、モードが禁じるTIMESTAMP('0000-00-00 10:00:00'))
+ - * /の文字列オペランド 数そのものでない(10E+0 + 'a'。''は静かに0)
ビット演算子の文字列オペランド 整数そのものでない(1 >> '')
数値列と定数文字列の比較 文字列が数を持たない(WHERE i = '1invalid'。''・' 1'・'1e1'・'1.5'は通る)。BETWEENは行ごと

失敗の落ちる場所は上の1690と同じ規則に従う:

  • INSERT ... VALUESの値や条件の項そのものは文のエラー
  • UPDATEのSETやFROMつきの選択項目は失敗モード1292(mysql.Violates(err, "1292")が一致する)
  • ただし比較のオペランドにある定数だけは常に行ごとに実行されるので、WHERE d = CAST('2004-10-0' AS DATE)はエラーではなく違反になる

文の種類にもモードにもよらず失敗する変換が2つある:

  • DATE / DATETIME / TIMESTAMPの値と、datetimeとして読めない定数文字列との比較。比較がどこにあっても——選択項目、JOINのON、HAVING、ORDER BY / GROUP BYの項目、死んだ枝でも——文の1525 Incorrect DATETIME valueになる。厳密モードの書き込みの中では格納形の1292になる(BETWEENとINは先に変換しない。TIMEとYEARの列はこの規則の対象外)
  • ゼロの月か日の上に時差を書いたdatetime文字列・リテラル。時差の変換で失敗する: 1292 Truncated incorrect temporal value

TIMESTAMP列に格納するDATE'...' / TIMESTAMP'...'リテラルは、1970-01-01 00:00:01〜2038-01-19 03:14:07.999999 UTCに収まらなければならない。

  • 時差が書いてあれば厳密に判定する(範囲はUTCで定義されているので、セッションのタイムゾーンが結論を動かすことはない)。時差が無ければ、セッションのタイムゾーンで結論が変わらない場合だけ判定する
  • 小数秒は先に列の精度へ丸められ、繰り上がりも数える(TIMESTAMP'1970-01-01 00:00:00.999999+00:00'はTIMESTAMP(0)では00:00:01になり、格納される)
  • TIMESTAMP列はALLOW_INVALID_DATESを無視し、実在する月日の上の年0も範囲外として検査する。DATETIMEはどちらも受け付ける

読まないもの:

  • 関数の結果の格納(STR_TO_DATE(...))
  • 時間型キャストの値を列の格納検査へ運ぶこと
  • UPDATEのORDER BYの定数
  • 時間型の列とスカラサブクエリ定数の比較
  • 今のモードでは格納できない列のDEFAULT
  • TIME列自身の行ごとの文字列変換

定数引数の関数

引数の値によって実行時に失敗するかどうかが決まる関数は、引数が定数のときに判定する。失敗の置き場所は上の定数算術と同じ規則に従う: 畳み込まれる位置なら文のエラー、行ごとに走る位置なら自分のエラー番号をキーにした違反、0行の問い合わせは失敗しない。

関数 失敗する条件 エラー
INET_ATON 値が「最大255の数字グループをドット3個以下で区切った形」でない('122.256'、末尾ドット。'1.2.3'は通る) 1411、IGNORE以外の厳密モードの書き込みのみ
INET6_ATON 完全なドット4区切りIPv4でも正しいIPv6テキスト(::ギャップは1つ、グループは16進4桁まで)でもない 1411、同じ条件
UNHEX 16進以外の文字を含む 1411、同じ条件
STR_TO_DATE フォーマットで値が読めない(サーバのフォーマット指定子、en_USの月名・曜日名、%V/%v週と対応する%X/%x年)、または日付がセッションのゼロ日付フラグに反する(NO_ZERO_DATE下では日付結果の年・月・日いずれかの0も) 1411。読めた値の後ろに空白以外が残ると1292(メッセージの型語はフォーマットが決める結果型)
UUID_TO_BIN 値が「16進32桁」「8-4-4-4-12のダッシュ形」「ダッシュ形を波括弧で囲んだ形」のどれでもない 1411、文の種類・モードを問わない
BIN_TO_UUID 値がちょうど16バイトでない 1411、文の種類・モードを問わない
PERIOD_ADD / PERIOD_DIFF period引数が「月1〜12の正の[YY]YYMM」でない 1210、文の種類・モードを問わない

行ごとの違反はmysql.Violates(err, "1411") / "1210"が照合する。

これとは別に、解決の時点で拒まれる系統がある。式がどこにあっても、行が有っても無くても拒まれる:

  • NAME_CONST: 両引数がリテラルであること(単項マイナス1段とCOLLATEは可。畳み込みが要る1+1やTRUEは不可)。名前がNULLなら1382
  • LIKEのESCAPE: 1文字以下の定数であること
  • NTILE: 正の個数。NTH_VALUE: 正の整数位置
  • MATCH ... AGAINST: MATCHの列は1つのリレーションに収まること(selectの別名や2表跨ぎは1210 to MATCH)、AGAINSTは定数であること(列を含むと1210 to AGAINST)

関数呼び出しの引数とシステム変数の読み取り

関数呼び出しの引数に別名が付いている形(f(x AS a)、ローダブル関数の構文)は、引数を解決するより前に、サーバと同じ順序で拒む:

  • ネイティブ関数は、まず引数の個数(1582、名前は書かれたまま)、次に別名が1583(名前は小文字化される。SELECT ABS(3 AS three)は... native function 'abs')
  • それ以外の名前——ストアド関数も、存在しない名前も同じ——は、関数を探すより前に1584
  • データディクショナリの内部関数(INTERNAL_TABLE_ROWSなどサーバが内部と印を付けるもの)は、どちらの検査よりも前に、文が名前を書いた時点で3566

スコープを明示したシステム変数の読み取りは、変数自身のスコープと一致しなければならない:

  • GLOBAL専用変数の@@session.x(@@local.xも同じ)と、SESSION専用変数の@@global.xは文の1238。読み取りがどこにあっても——死んだ分岐でも、サブクエリでも、0行のSELECTでも——変わらない
  • スコープ表はサーバのソースから生成していて、標準の変数を全部持つ
  • プラグインやコンポーネントの変数(@@x.yを含む)と修飾なしの@@xは判定せず、未知の名前はサーバ自身の1193に任せる

空間型

ジオメトリの値は7つの型(POINT〜GEOMETRYCOLLECTION)のどれかを取り、列はそのどれか、またはGEOMETRY(何でも受ける)で宣言される。検査器は、コンストラクタ(POINT(1, 1))、型付きのリーダ(ST_PointFromText)、定数のテキストやWKBから値の型が決まるときにそれを把握し、判定に使う。

文 エラー
サーバのWKTリーダが拒む定数を渡したST_GeomFromText(型付きの変種も): 壊れたテキスト、1点のLINESTRING、4点未満か閉じていないポリゴンのリング、(x y)とx yを混ぜたか空のMULTIPOINT。拒まれる定数WKB(壊れている、末尾に余りのバイト)を渡したST_GeomFromWKB。ST_GeomFromWKBにジオメトリ値を渡す 3037
別の型の定数を渡した型付きリーダ(ST_PointFromText('LINESTRING(...)')。GEOMCOLL系はMULTI*も受ける) 3516
0〜4294967295の外の定数SRID 1690
引数1つのLINESTRING(...)。POINT定数で作ったリングが4点未満か閉じていないPOLYGON(...) 3037
別のジオメトリ型と分かる引数を渡したLINESTRING / POLYGON / MULTI*。ジオメトリを渡した算術・ビット演算子、数値関数、BETWEEN(比較は許される) 1210
空間列に格納する値が列の型の内部形式でない: 数値や文字列、4バイトのSRID+リトルエンディアンの正しいWKBでない16進 / UNHEX定数、別のジオメトリ型の定数 1416。sql_modeにかかわらず、IGNOREでも

型付きの空間列に、別のジオメトリ型を持つnullableな式を格納する形(LINESTRING列の値をPOINT列へ)は、NULLでない値のたびに失敗する。これは失敗モード1416で、mysql.Violates(err, "1416")が一致する。

読まないもの: 列が宣言するSRIDとの不一致(3643)、定数SRIDが実在の空間参照系を指すかどうか(3548)、関数自身の実行時の検査(縮退したリングへのST_Centroid)、GeoJSON。

トリガとストアドルーチンとイベント

ローダーはCREATE TRIGGER / CREATE PROCEDURE / CREATE FUNCTION(DEFINER、IF NOT EXISTS、特性句込み)とDROP / ALTER(特性のみ)を、表と同じように読む。DELIMITER文は不要である。本体の中の;は1つの複合文の内側として読まれ、mysqlクライアント互換のDELIMITER x行が混ざっていてもそのまま読める。CREATE時にサーバ自身が拒むものは、未知の表と同じくスキーマのProblemになる:

  • 対象の表が無い(1146)
  • 同名のトリガ・ルーチンが既にある(1359 / 1304)。DROPしようとしたトリガ・ルーチンが無い(1360 / 1305)
  • FOLLOWS / PRECEDESが指す先のトリガが無い(3011)

DROP TABLEはその表のトリガを道連れにし、RENAME TABLEはトリガを付け替える。

CREATE EVENTも同じように読む(2つのスケジュール形、STARTS / ENDS、ON COMPLETION、ENABLE / DISABLE、COMMENT)。ALTER EVENTは書いた句だけを置き換え(スケジュールを書けばスケジュール全体、RENAME TOなら名前)、DROP EVENTも適用する。プログラムから実行する文がイベントに触れることはないので、本体を読むのはスキーマ自身の検査のためである。サーバはCREATE時に本体を何も検査しない——存在しない表へのDELETEも受け付け、実行のたびに失敗する。検査器はそれをスキーマのProblemとして報告し、本体の各文はルーチンと同じように義務の判定にかける。イベント本体のRETURNは1313。マイグレーションのコマンドはイベントも管理する(migrations.ja.md)。

本体はスキーマごとに1回読む。PostgreSQLのPL/pgSQL関数本体の読み方と同じ位置づけである(checks.ja.md)。IF / CASE / LOOP / WHILE / REPEAT、ラベル付きブロックとLEAVE / ITERATE、RETURN、SET、SELECT ... INTO、カーソル(DECLARE / OPEN / FETCH / CLOSE)、CALL、SIGNAL / RESIGNAL、DECLARE ... HANDLER FORを歩く。名前はサーバと同じ規則で解決する:

  • NEW.col / OLD.colはトリガ表の列として型付けする。無い列は1054
  • INSERTトリガでのOLD、DELETEトリガでのNEWは1363
  • OLDへの代入(イベントの種類より先に検査される。INSERTトリガでも同じ)と、BEFORE以外でのNEWへの代入は1362。トリガの外のSET NEW.col / SET OLD.colは1193(そこでのNEW.colの読み取りは、サーバが実行時にしか解決しない列参照として残る)
  • NOT NULL列のNEW.colも、BEFOREトリガの中ではNULLになりうる。AFTERトリガでは宣言どおりで、サーバ自身のNOT NULL検査は両者の間で走る
  • DECLAREした変数やルーチンの引数は、同名の列より優先して解決する

本体の作成時にサーバ自身が拒むものは、ここでもエラーになる。

構文 エラー
対応ラベルの無いLEAVE / ITERATE 1308
FUNCTION以外でのRETURN 1313
RETURNの無いFUNCTION 1320
未宣言のカーソルや変数、FETCHの列数不一致 1324 / 1327 / 1328
SELECT ... INTOの列数不一致 1222
結果集合を返すトリガ・関数(自身のINTO無しトップレベルSELECT、またはCALLした先のPROCEDURE自身のもの) 1415
本体内のCOMMIT / START TRANSACTION / DDL文 1422
トリガが自分の表に書く 1442。タイミング×イベント×書き込みの18通り全部で。常に失敗するので、発火する文にではなくトリガの定義に報告する
同じブロック内で同名の変数を2回DECLAREする 1331
同じブロック内で同名のDECLARE ... CONDITIONかDECLARE ... CURSORを2回(変数とカーソルの同名は名前空間が別で許される) 1332 / 1333
同じブロック内の2つのHANDLERが同じ条件値を名指す(SQLEXCEPTIONとSQLSTATE '45000'のように重なるだけなら許される) 1413
トリガまたはFUNCTION内の動的SQL(PREPARE / EXECUTE / DEALLOCATE PREPARE)とFLUSH(PROCEDUREは対象外) 1336
本体内のLOCK TABLES / UNLOCK TABLES・LOAD DATA・ALTER VIEW(PROCEDUREも対象。SELECT ... INTO OUTFILEは結果集合を返さないのでトリガや関数の中でも許される) 1314
5文字でないSQLSTATEリテラル(SIGNAL SQLSTATE '4500'、それを名指すCONDITIONやHANDLER) CREATE時に1407。5文字ならどんな文字でも受理する
MYSQL_ERRNO = 0を設定するSIGNAL / RESIGNAL 1231。常に失敗する
どのHANDLERの外でも、届く値の無いRESIGNAL 1645。常に失敗する
自分自身をCALLするPROCEDURE max_sp_recursion_depthが0(既定)のあいだ、再帰呼び出しのたびに1456(0より大きく宣言すれば何も予測しない)。直接の自己再帰だけで、別ルーチン経由で自身に戻るものは対象外
自分自身を呼ぶFUNCTION 呼び出しのたびに1424(CREATEは通る。max_sp_recursion_depthは関数には効かない)
上流で使用中の表に書き戻すトリガの連鎖(INSERT INTO xがxのトリガを発火してyに書き、yのトリガがxに書く)、またはロック付きで読み戻す連鎖(SELECT ... FOR UPDATE / FOR SHARE / LOCK IN SHARE MODE。ロック無しの読みは衝突しない) 1442。どちらのトリガも自分の表には書いていなくても。CALLしたルーチンが続ける連鎖も同じに数え、連鎖のどこかで見つかった確実な失敗(1442、1456)は発火した文に報告する

本体の失敗モードのうち、実行時に起こりうるもの(SIGNALと同じくexpect行に書く。mysql.ja.md):

構文 失敗モード
ELSEの無いCASE(simple・searchedいずれも) 1339「Case not found for CASE statement」。どのWHENにも一致しないとき
自身のSET MYSQL_ERRNOを持つ、値の無いRESIGNAL 捕まえたSIGNALの番号ではなく、自身が設定した番号で再送する

カタログに無い名前のFUNCTION呼び出しは、スキーマのルーチンに解決する:

  • 組み込み関数と同名の未修飾の呼び出しは組み込みが勝つ(サーバと同じ)。db.fと修飾すればルーチンを名指す
  • 引数の数が違えば1318、そのルーチンが無ければ1305
  • 結果はRETURNSの型で、常にNULL可である。宣言した型が何であれRETURNはNULLを返しうるので、そうでないことの静的な証明は無い。CREATE FUNCTIONの上に-- sqlshape: not nullを書けば、その関数が決してNULLを返さないと宣言でき、呼び出しはNOT NULLとして型付けされる(PostgreSQLの同じ指示子はchecks.ja.md)。PROCEDUREとTRIGGERは値を返さないので、この指示子を拒む
  • 本体自身の失敗モード(SIGNAL、書き込みの違反、その書き込みが発火させるもの)は、呼び出した文に持ち込まれる
  • 本体内のCALLはトップレベルと同じに解決し(1305 / 1318 / 1414)、呼び先の失敗モードと書き込みは本体のものになる

呼び出した文が読むか書く表に、関数自身が書く場合は、実行のたびに1442になる:

  • 文の側は表を読んでいるだけでも衝突する。列を読まずFROMに名前を挙げるだけでも同じ
  • 書き込みは入れ子の呼び出しを通して数える。tに書くプロシージャをCALLする関数も、そうする別の関数をRETURNで呼ぶ関数も、同じように衝突する
  • 本体の中では文ごとに衝突を見る。tに書くfをUPDATE t SET v = f(v)で呼ぶルーチンはCALLすると1442になるが、SELECT COUNT(*) INTO n FROM t; SET @x = f(1)と2文に分かれていれば衝突しない
  • トリガ自身の表は本体の全文と衝突する(otherのトリガがSET @y = g(1)でotherに書くgを呼べば1442)。発火させた文が読んでいるだけの表はトリガの表ではないので衝突しない

CALL p(...)はIN / INOUT引数をその引数宣言の型で型付けし、OUT / INOUT引数は変数でなければならない(1414)。変数として数えるもの:

引数 変数か
宣言した変数、引数、? 数える
BEFOREトリガ自身の本体内のNEW.col 数える(サーバ自身の1414メッセージがこの例外を名指ししている)
OLD.col、AFTERトリガのNEW.col 数えない

結果列は本体自身のINTO無しSELECTから決まる: 1つも無ければ列無し、1つならその列、複数あって形が揃っていれば1つの列リストとして扱う。形が割れていれば検査器自身のエラーになる——これはmysqld自身が拒むものではなく、実行時にどの経路を通ったかで違う結果集合が返るだけだからである。失敗モードは本体自身のもの。

名前解決

ORDER BY、GROUP BY、HAVINGは、サーバと同じにSELECTリストの別名を参照できる。裸の名前だけでなく式の中でも(ORDER BY c + 1、GROUP BY CONCAT(f1))。

  • GROUP BYでは同名の表の列が別名に勝つ。別名付きで書いた項目は、別名の無い同名の列に勝つ。同名の別々の項目が2つあれば1052
  • 外側のブロックの選択リスト・GROUP BY・HAVING・ORDER BYに置かれた入れ子の問い合わせは、そのブロックの別名も参照できる。WHEREやONに置かれたものは参照できない(SELECT name c, (SELECT 1 FROM orders WHERE note = c) FROM usersは通り、同じサブクエリをWHEREに置くと1054)
  • サブクエリより後で宣言された別名の参照は1247(forward reference in item list)。集約を含む別名の参照は、入れ子の問い合わせ自身のHAVINGから以外は1247(reference to group function)で、GROUP BYからは常に1247。ウィンドウ関数を含む別名は3594
  • HAVINGはブロック自身の表に対しては名前を解決しない。選択リストにもGROUP BYにも無い列は、最上位では1054、サブクエリの中では外側のブロックの列になる(WHERE EXISTS (SELECT 1 FROM orders HAVING id)は外側のidを読む)

そのほかの解決規則:

  • _rowidは、基底表の最初のキー(サーバの並び順: PRIMARY、NOT NULL列だけの一意キー、残り)がNOT NULLの整数型(INT系、YEAR、BIT)1列の一意キーであるとき、その列を指す。修飾した参照か、表が1つだけのレベルで使える。ビューと派生表には無い
  • INSERT ... SELECT ... ON DUPLICATE KEY UPDATEの代入は、対象表とSELECTの表の両方に対して解決する(両方にある修飾の無い名前は1052)。ただしSELECTがグループ化・集約されていれば対象表だけを見る。VALUES(c)は常に対象表の列で、選択リストの別名はそこからは見えない
  • 行エイリアス(INSERT ... VALUES (...) AS new [(名前リスト)]、8.0.19)は、挿入される列——表の全列ではなく、そのINSERT自身のフィールド——を、名前リストがあれば位置対応で改名して、ON DUPLICATE KEY UPDATEに対象表と並べて見せる。両方が持つ修飾の無い名前は1052、名前リストの個数違いは1353、対象表と衝突するエイリアスは1066で、VALUES(c)はエイリアスと併用できる
  • 派生表には別名が要る(1248)。QUALIFYは、8.4がハイパーグラフオプティマイザ無しで拒むとおりに拒む(6037)
  • USINGとNATURALの結合は共通列を1つにまとめる(修飾の無い名前は左側に解決し、SELECT *には1回だけ並ぶ)
  • 表名とビュー名はlower_case_table_namesの言うとおりに照合する。列名とキー名は常に大文字小文字を区別しない
  • 書く表をサブクエリが読むUPDATE / DELETEは、サーバが拒むとおりに拒む。読んでいるのが表そのものなら1093(WHERE・EXISTS・INのどれでも)、その表の上のビューなら1443。派生表で包めば実体化されて通り、同じ表からのINSERT ... SELECTも通る

ビュー

ビューは、ALGORITHM=TEMPTABLEと書かれているか、問い合わせがマージできない形(GROUP BY・HAVING・DISTINCT・LIMIT・集合演算・ウィンドウ関数・選択リスト内のサブクエリ)でない限り、読む側の問い合わせにマージされる(サーバ自身の判定どおり)。マージされるビュー経由の書き込みは基底表に届き、それ以外のビューへの書き込みは1288になる(INSERTでは同じ拒否が1471と綴られる)。

マージされるビューは、サーバ自身の2つの書き込みフラグを持つ。自分の問い合わせのFROMの葉について:

  • どれかの葉が更新可能(基底表か、更新可能なビュー)なら、更新可能
  • 全部の葉が挿入可能なら、挿入可能
  • どれかの葉が外部結合のNULL側に居れば、どちらでもない

したがって、派生表やTEMPTABLEビューとの結合は「更新可能だが挿入不能」、TEMPTABLEビューの上のビューはどちらでもない。書き込みごとの規則:

  • INSERTは挿入可能フラグが要る(無ければ1471)。
    • フィールド——列リスト、無ければビューの全列——はビューに対して解決する(1054、1136)
    • フィールドの中の派生列はその列の1348。フィールドの外の派生列と、同じ基底列が2つのビュー列の裏に立つ形は1471。COLLATEの包みは、サーバと同じく透過する
    • 結合ビューではさらに列リストが必須で(1394)、名指す列はON DUPLICATE KEY UPDATEの代入も含めて基底表1つに収まらなければならない(1393)。REPLACEは結合ビューに届かない(1395。削除の半分を含むため)
    • 失敗モードは基底表自身のもの(1062ほか)。代入されないまま残る、既定値の無い基底列は、表の1364ではなくビューの1423になる
  • UPDATEは更新可能フラグが要り(無ければ1288)、素の列になら代入できる。ビュー自身の選択リストの式への代入はその列の1348、ビューの中の実体化された葉の列は(更新可能なビュー越しでも)ビューの1288、結合ビュー越しの代入は基底表1つに収めること(1393)
  • DELETEは、更新可能で葉が1つのビューならよい(派生列だけのビューでも構わない)。葉が2つ以上なら1395、それ以外(共通テーブル式を対象にした形も)は1288
  • 書く対象のビュー自身をサブクエリが読めば、対象そのものの扱いで1093になる(同じ基底表の上の別のビューなら1443)

サーバがマージしないビューに付けたWITH CHECK OPTIONは、サーバがCREATEを拒む(1368)のと同じく、スキーマの読み込み時に拒む。CREATE OR REPLACE VIEWは前の定義を置き換える。ALTER VIEWも同じく置き換える(ビューが存在しなければ1146、その名前が表なら1347)。

結果集合を返さない文

SELECT / INSERT / UPDATE / DELETE / CALLのほかに、検査器は次の文を読む(Execで実行するもの)。

  • LOAD DATA [LOCAL] INFILE ... INTO TABLE tは、ファイルの行を挿入するINSERTとして読む。
    • 対象は基底表でなければならない(ビューは1288)。列リストはその表で解決する(@varはフィールドを受け取るだけで、列には代入しない)。SETの代入は式を列に対して型付けし、その中のプレースホルダは列の型を取る
    • 失敗モードはINSERTのもの——埋める列にかかるキー・外部キー・CHECK(1062 / 1452 / 3819)、IGNOREが警告に変えること、REPLACEが衝突する行を先に消すこと
    • ただしサーバが変える点が2つある: NOT NULL列のフィールドがNULLになりうることは1048ではなく1263(SET col = NULLは1048のまま)。列リストから外したNOT NULL列は1364にならず、型の暗黙の既定値を取る
  • LOCK TABLESが名指す表は存在しなければならず(1146。ビューもロックできる)、別名は重複してはならない(1066)。UNLOCK TABLESは何も解決しない。どちらにもパラメータは無い
  • SELECT ... INTO OUTFILE / INTO DUMPFILEは、INTOの位置がどちらでも、包んでいるSELECTと同じに型付けするが、列は返さない(行はサーバ上のファイルに書かれる)。SELECT ... INTO @var / INTO varも同じで、行は変数に入る(数は一致しなければならない。1222)。末尾のFOR UPDATE / FOR SHARE / LOCK IN SHARE MODEはSELECTの列をそのまま残す
  • INSERT INTO t VALUES ()(全行が空。列リストの有無は問わない)は既定値の行を挿入する。どの列にも代入しないので1136にはならず、既定値の無いNOT NULL列があれば通常どおり1364である