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 2.x　3.x CakePHP3

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

Message コメントをキャンセル

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

: CakePHP3でComposerでインストールできないプラグイン、外部ライブラリを vendorに入れて手動で読み込む方法

CakePHP3にComposerからインストールできないプラグインやライブラリなどを利用する方法、vendorにファイルを設置し、composer.jsonを更新し、それを呼び出す方法を詳細に解説。

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

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

: CakePHP3でQRコードを作成、表示するライブラリ「cakePHP-QR-Code-Helper」

CakePHPでQRコードを生成するライブラリ「cakePHP-QR-Code-Helper」の紹介。GDライブラリのインストールも必要ないHelperとして提供されているため、ファイルを設置すればすぐに使用可能。

: CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数

CakePHP3で特定フォルダのパスの定数を解説。root、DocumentRoot、app、config、webroot、tests、tmp、cache、vendor、コア、コアの srcが設定済み。realpath()関数を使うと柔軟なパス指定が可能。

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

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

: CakePHP 2.3　Search Pluginで検索処理　その４前方一致検索、後方一致検索、不等号による検索、between句による範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で前方一致検索、後方一致検索、不等号による検索、between句による範囲検索の解説です。

: CakePHP3のfriendsofcake/searchでブックマークチュートリアルのタグ検索を実装

CakePHP3のCookbookにあるブックマークチュートリアル。ここで紹介されているタグで検索する処理を検索プラグイン「friendsofcake/search」で実現する方法を解説しました。

: CakePHP3で生の SQLの実行はConnectionManagerを使う

CakePHP3で生の SQL文を実行する方法を解説。クリエビルダーを使う場合は TableRegistryを利用するが、SQLを実行する場合は ConnectionManagerを使う。プリペアードステートメントの使用方法も解説。

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

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

: CakePHP3で /Layout/defult.ctpにある titleタグ、h1タグを編集する方法

CakePHP3でtitleタグ、h1タグのテキストをデフォルトから変更する方法を解説。テンプレートファイルに「$this->assign()」でテキストを指定して「/Layout/defult.ctp」で受け取る。