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 コメントをキャンセル

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

: CakePHP3、CakePHP4のキャッシュをクリアする方法「bin/cake cache clear_all」を使う

CakePHP3、CakePHP4では処理を高速化する手法の一つとしてキャッシュを利用している。しかし、その情報は元の情報を更新しても反映されない場合がある。そんなときはキャッシュを削除する必要がある。

: CakePHP3、CakePHP4のdatetime型カラムの日時の扱い。秒まで表示する方法

CakePHP3の日時カラムで秒まで扱う場合はdate()、strtotime()関数ではうまくいかない。CakePHP3であらかじめ用意された「i18nFormat()」を使用する。

: CakePHP3で Ajaxを使う方法の解説。3.6以降対応。Successとthenの両方を解説。

CakePHP3でajaxを利用する処理の実装方法を解説。プルダウンを変更するとデータベースの値を取得し検索結果の内容を変更するというような処理を想定。CakePHP3.6以降の CSRF対策対応済。

: CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説

CakePHP3で定数や共通で使う変数をまとめて設定し、プログラム内で読み込む方法を、bootstrap.phpに直接記述する方法と定数ファイルを分ける方法の3つの方法で解説。

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

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

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP3でkeywords、DescriptionをHTMLヘルパーを使って設定する

CakePHP3のkeywordsとdescriptionを設定する方法の解説。CakePHP3にはmetaタグを編集するHTMLヘルパーが用意されているためそれを利用すればOK！ポイントはブロック化を有効にすること。

: CakePHPで favicon.icoやapple-touch-icon-144-precomposed.pngが could not be foundのエラーが出るときの対処方法

CakePHPで「CakeDC/Users」などルーティングを行うプラグインを利用するときに、favicon.icoやapple-touch-icon-144-precomposed.pngがNotFoundエラーになることがある。その対処方法の解説。

: CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

CakePHP5のヘルパーで他のヘルパーを読み込む方法を解説。公式の日本語CookbookはCakePHP4のソースのままで間違っているため注意が必要。CakePHP4からの移行の際も同じ点に注意が必要。

: CakePHP3のCakeDC/Usersでログインユーザの所有レコードのみ更新、削除する権限管理の設定方法

CakePHP3のユーザ管理、ログイン認証プラグイン「CakeDC/Users」の権限管理を行う方法やアクセスできるコントローラー、アクションを設定、所有権を持つレコードのみ更新できる設定方法を解説。