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でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

CakePHP4でcontrollerで実行したバリデーションの結果をModelのバリデーション結果に追加するメソッド「setError()」「setErrors()」の使い方の解説。

: CakePHP 2.3　bakeの超初心者向けフォロー講座

CakePHP 2.3　bakeの超初心者向けフォロー講座

: CakePHP3でcomposerを利用してライブラリ・プラグインをインストールする方法

CakePHP3でcomposerを使ってパッケージ（ライブラリ、プラグイン）をインストールする方法の解説。PHPを使うのはCakePHP3が初めてというような方への使い方から解説。

: CakePHPのFlashエラーは出るが入力項目ごとのメッセージが出ないエラーの原因

Bakeして自動生成した入力フォーム処理を元に少し処理を追加したら、入力エラーがあってもエラーメッセージが表示されなくなった。原因はリダイレクトの処理にあった。

: CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

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

: CakePHP5系で認証機能のAuthenticationプラグインをインストール・エラー発生注意

CakePHPのユーザ認証に使用するオフィシャルなプラグインAuthenticationだが、CakePHP5系では Authentication Ver.3系を使う必要があるが、公式ChiffonBookが間違えている。

: CakePHP3にデザインテンプレートBootstrapを導入する方法・friendsofcake/bootstrap-ui使用

CakePHP3にプラグイン「friendsofcake/bootstrap-ui」、デザインテンプレート「Bootstrap」を設置する手順を解説。Bootstrapの簡単な使い方やデフォルトのデザインとの混在方法なども解説。