開発業者が納品したWebアプリケーションがエラーを吐いていた。
致命的な問題で無かったことから発覚が遅れ、瑕疵担保責任を追及できる期間はとうに過ぎていたので、自分で直したという話。

調査ついでにエラーログの見方を簡単に説明しよう。

出力されたエラーメッセージ

_mysql_exceptions.DataError: (1264, "Out of range value for column 'カラム名' at row 1")

MySQLdbというPythonのモジュールが投げた例外のようだ。
最初の 1264 は4桁なので、MySQL独自のエラーコードだろう。

２つのエラー番号

MySQLのエラー番号には、

MySQL独自のエラーコード（4桁）
ODBCやANSI SQLで定められたSQLSTATE（5桁）

がある。

SQLSTATEは汎化されているので、MySQLに特化した独自コードの方が詳細に特定できる。
公式サイトですべてのエラーメッセージを確認できるが、特に良く見かけるものを以下に抜粋する。

Row 行番号 doesn't contain data for all columns

エラーコード：1261
SQLSTATE：01000
意味：すべてのカラムへのデータを含んでいない

Row 行番号 was truncated; it contained more data than there were input columns

エラーコード：1262
SQLSTATE：01000
意味：カラムよりも多いデータを含んでいたので、切り捨てたデータがある

Column set to default value; NULL supplied to NOT NULL column 'カラム名' at row 行番号

エラーコード：1263
SQLSTATE：22004
意味：NOT NULL のカラムにデフォルト値の NULL を登録した

Out of range value for column 'カラム名' at row 行番号

エラーコード：1264
SQLSTATE：22003
意味：範囲外の値だったので、取り敢えず限界の値で登録した

▶ 今回出力されたエラーメッセージである。

Data truncated for column 'カラム名' at row 行番号

エラーコード：1265
SQLSTATE：01000
意味：先頭からみて入れられるところまで登録し、残りは切り捨てた

つまり…

エラーコード 1264 は、データ型の範囲を超えた値をINSERTしたときに発生するWarningである。直前に実行したSQLのWarningは SHOW WARNINGS で確認できる。
データ型の範囲を超えると、そのデータ型の最大値または最小値に調整されて登録されるはずだが、PythonがDataError例外を投げたのでrollbackされたと推測。実際にも登録されていなかった。

スタックトレース例

insert into zzzzz_table values(5,1611728121,0,162,58.2,63.9,1,27.5)

Traceback (most recent call last):
  File "/foo/bar/example.py", line 547, in <module>
    fooList()
  File "/foo/bar/example.py", line 164, in barList
    cursor.execute(qstr)
  File "/usr/lib/python2.7/dist-packages/MySQLdb/cursors.py", line 226, in execute
    self.errorhandler(self, exc, value)
  File "/usr/lib/python2.7/dist-packages/MySQLdb/connections.py", line 36, in defaulterrorhandler
    raise errorvalue
_mysql_exceptions.DataError: (1264, "Out of range value for column 'xxxxx' at row 1")

データ型

対象カラムのデータ型をDESCで確認するとTINYINTであった。
TINYINTの取りうる範囲は次の通り。

バイト数： 1バイト
デフォルト桁数： tinyint(4)
符号付き（SIGNED）の範囲：-128 ～ 127

データ型の後にUNSIGNEDを付けると符号なしとなり、0～255の範囲になる。
ちなみに tinyint(1) はBoolean型と同じだ。

直前のSQLで127を超える値をINSERTしていたが、運用上ありえない値なのでソースコードを修正した。