CakePHP3で「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」などのエラーが出たときの確認するポイント

2019/06/25

「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」の対処方法

CakePHP3特有の原因の解説と対処方法の紹介

　
CakePHP3でシステム開発を行っているときに発生したエラー。
　
　SQLSTATE[23000]: Integrity constraint violation
　SQLSTATE[42S22]: Column not found
　
このエラーの、CakePHP3の特有の原因の解説と対処方法を紹介します。
　
　

テーブルを指定しないと「Integrity constraint violation」のエラー

　
CakePHP3でシステム開発をする際によく記述する内容として、データベースから値を取得する処理があります。
　
contain句も書いていない、要素だけを取り出した内容になりますが、下記の様に find句と where句で条件を指定して値を取得します。
　
「view_flag」は、表示フラグで「1」となっているレコードを表示対象として表示するため、where句で条件を指定しています。
　

$this->DataSamples->find()->where(["view_flag"=>1])->all();

1	$this->DataSamples->find()->where(["view_flag"=>1])->all();

　
この処理を実行すると、下記のエラーが発生しました。
　
2019-01-01 01:01:01 Error: [PDOException] SQLSTATE[23000]: Integrity constraint violation: 1052 Column 'view_flag' in where clause is ambiguous
　
contain句を書いていないため分かりにくいのですが、このエラーは、「アソシエーションのテーブルの中に『view_flag』というカラムが複数存在するため、カラムが特定できません（あいまいです）。」という内容です。
　
　

テーブルを指定すると「Column not found」のエラー

　
というわけで、「view_flag」に、テーブル名の「data_samples」を追加し「data_samples.view_flag」のようにしました。（下記のようにしました。）
　

$this->DataSamples->find()->where(["data_samples.view_flag"=>1])->all();

1	$this->DataSamples->find()->where(["data_samples.view_flag"=>1])->all();

　
そうすると、今度は下記のエラーになりました。
　
2019-01-01 01:01:01 Error: [PDOException] SQLSTATE[42S22]: Column not found: 1054 Unknown column 'data_samples.view_flag' in 'where clause'
　
これは比較的よく見かけるエラーです。
「指定のカラムがありません。」というものですね。
　
なので、テーブル名が間違っているのか、カラム名が間違っているのか、を目を皿のようにして見比べてみたり、テーブル名、カラム名を改めてコピペしてみたりするのですが、不具合は解消しないのです．．．
　
　

エラーの解消はテーブル名ではなく Model名を指定する！

　
なぜか！
テーブル名称の指定が間違っているからです。
　
実物のテーブル名は「data_samples」であったとしても、CakePHP3が Model（の tableファイル）を通じて認識しているテーブル名は「DataSamples」となるのです。
　
そのため、下記のように記述する必要があるのです。
　

$this->DataSamples->find()->where(["DataSamples.view_flag"=>1])->all();

1	$this->DataSamples->find()->where(["DataSamples.view_flag"=>1])->all();

　
　
よく行き当たるエラーではあるので、プログラム開発の質問サイトなどにもよく質問が投稿されているのですが、「[PDOException] SQLSTATE[42S22]: Column not found」というエラーなので、「カラム名が間違っていませんか？」という回答になってしまいがちなのです。
　
そのため、
不具合が解消しない！！！
のです．．．
　
　
というわけで、自分自身の備忘録も兼ねて記事を書きました。
　
同じところで引っかかっている方の助けになればいいなと思っています。
　
　

- CakePHP 3.x 4.x 5.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP4のCakeDC/Usersの Usersへの接続、バリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。CakePHP4で使う場合のUsersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

: CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

入力された値によってバリデーション（入力チェック）の内容を切り替える。その処理をCakePHPで実装する方法を解説。条件ごとに unset関数を使ってバリデーションを削除する、という方法を採る。

: CakePHP4のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

CakePHP4の英語のメッセージを日本語化（多言語化）する手順を解説。オリジナルのメッセージを作成する方法やプログラムで文言を追加する場合の対応なども解説。

: CakePHP3でファイルのアップロード処理を自作・解説付き・その１

CakePHP3でファイルをアップロードする処理を、php.netにある「エラーを起こさない」と説明がある処理を参考に作成。サンプルソースとその解説付きで、コピペでも動くし、カスタマイズも簡単！

: CakePHP 2.3で saveの便利な使い方・サンプルソース付き

CakePHPのレコードを保存、更新する際に使う Saveを詳細解説します。

: CakePHP3でシェルを作成しコマンドラインから実行・CakePHP2との違い

CakePHP3のシェルスクリプトを作成し、コマンドラインから実行する方法を解説。複数単語をつなげる場合の対応方法がCakePHP2より制限が厳しくなったのでCakePHP3の命名規則の確認が必要だ。

: CakePHP2の検索Plugin CakeDC/Searchで重複を省くgroup by（distinct）の実装方法

CakePHP2の検索プラグイン「CakeDC/Search」で、重複レコードを省くgroup by、distinctを使う方法についての解説。設定する場所はpaginatorの条件とするので、find()関数と同じ。

: CakePHP 2.3でOn Duplicate Key構文を実装

CakePHPで On Duplicate Key構文を Queryを利用して実装する方法をサンプルソース付きで解説します。

: CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも

CakePHPでAuto Incrementの設定を変更したときに「Duplicate entry ‘0’ for key」のエラーが出た。原因はModel内で IDを編集する処理の追加を忘れていたからだった。