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でDocumentRootやwebroot、imgフォルダのURLやドメイン、パスを取得

URLやドメイン、フォルダへのパスの取得は、ビューではUrlHelperを使い、コントローラーではRouterクラスを使います。第2引数の指定でURLを取得することも可能。

: CakePHPを学ぶ際にはオブジェクト指向を学ぼう

CakePHPはオブジェクト指向で書かれていますので、CakePHPを学ぶにはオブジェクト指向も学びましょう。

: CakePHP3のアソシエーションでJOINのタイプのLEFT、INNERを切り替えながら使う方法

CakePHP3でテーブルのアソシエーションしたデータの取得をコントローラー側でINNERかLEFTを指定する方法を解説。TableファイルにINNERで指定していてもController側で変更ができる。

: CakePHP4のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。ユーザ新規登録の流れを紹介しつつ、テンプレートファイル、設定情報ファイルの場所とそれらをカスタマイズする方法を説明します。

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

ID以外のカラムでアソシエーション（連携）させるための考え方とサンプルソースを用いての説明を行っています。

: CakePHP3でアソシエーション先のカラムでデータをソートして取得したい

アソシエーション先のテーブルのカラムをキーにソートをしたデータを取得したい！ときの記述方法を解説。「orderAsc()」ではなく「contain()」の中にSort条件を記述する。

: CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介

PHPでサーバ情報、環境情報を取得する際は「$_SERVER」を利用するが、似たような情報をCakePHPの関数で取得する際は「getUri()」を使用する。取得出来る値は一致するものもあるが、違うものもあり便利な使い方もある。

: CakePHP4の数値項目は「like %10%」の部分一致検索（find select）はできない

CakePHP4でテーブルの数値項目に対してlike句を使用した部分一致検索を実行するとエラーが発生する。クリエービルダーの不具合だと思われ対処方法が分からない。

: CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

CakePHP3をインストールしたら URL rewriting is not properly configured.のエラーが。原因は.htaccessが有効になっていないこと。httpd.confに設定を追加すればOK。

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

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