PostgreSQL 8 min read

PostgreSQLの「column does not exist」 ― 大文字の列名・二重引用符・列別名で出るとき

※この記事にはアフィリエイト広告(プロモーション)が含まれます。

この記事の出力は PostgreSQL 18.6(Ubuntu 26.04)で採りました。

まず見る(結論)

エラーに出た名前 原因 直し方
小文字になった列名("username") 列が "UserName" のように大文字を含む名前で作られている "UserName" と二重引用符で囲む
検索したい値("HAAS") 文字列を二重引用符で囲んだ 単一引用符 'HAAS' にする
SELECT で付けた別名("p2") WHERE・HAVING で列別名を使った 式を書き直すか、副問い合わせにする
表の別名(column "u" of relation) UPDATE の SET で列に表名・別名を付けた SET price = 1 と列名だけにする
綴りの近い列名 打ち間違い HINT に出た列名を使う

SQLSTATE は 42703 です。表そのものが見つからないときは別のエラーで、relation does not exist の記事にまとめています。

HINT と ^ の位置を見る

ERROR:  column "nme" does not exist
LINE 1: SELECT nme FROM users;
               ^
HINT:  Perhaps you meant to reference the column "users.name".

^ がエラーになった語の位置です。綴りの近い列があれば、HINT に候補が出ます。打ち間違いならこれで解決します。

大文字を含む列名

PostgreSQL は二重引用符で囲まない名前を小文字にして扱います。CREATE TABLE で "UserName" と囲んで作った列は、大文字を含んだ名前のまま保存されます。

SELECT username FROM users;
ERROR:  column "username" does not exist
LINE 1: SELECT username FROM users;
               ^
HINT:  Perhaps you meant to reference the column "users.UserName".

SELECT UserName と大文字で書いても小文字の username として探すので、同じエラーになります。参照するたびに "UserName" と囲みます。表名が "Items" のように大文字を含む場合も同じです。

実際の列名は information_schema.columns で確かめます。

SELECT column_name FROM information_schema.columns
 WHERE table_name = 'users' ORDER BY ordinal_position;

 column_name
-------------
 id
 name
 UserName
 price

毎回囲むのが面倒なら、ALTER TABLE users RENAME COLUMN "UserName" TO user_name; で小文字の名前に変えます。アプリ側の SQL も合わせて直します。

文字列を二重引用符で囲んだ

SELECT * FROM users WHERE name = "HAAS";
ERROR:  column "HAAS" does not exist

PostgreSQL では二重引用符は列名や表名を囲む記号で、文字列は単一引用符で書きます。MySQL の既定の設定では "HAAS" が文字列として通るため、MySQL から移したSQLで出ます。WHERE name = 'HAAS' に直すと1行返りました。

MySQL の癖でバッククォートを使った場合は、column does not exist ではなく syntax error at or near になります。

WHERE で列別名を使った

SELECT price * 2 AS p2 FROM users WHERE p2 > 100;
ERROR:  column "p2" does not exist
列別名を書いた場所 結果
WHERE column does not exist
HAVING column does not exist
GROUP BY 通る
ORDER BY 通る

WHERE には price * 2 > 100 と式をそのまま書くか、SELECT * FROM (SELECT price * 2 AS p2 FROM users) s WHERE p2 > 100 のように副問い合わせで包みます。MySQL は HAVING で列別名を使えるので、ここも移行時に引っかかります。

UPDATE の SET に表名を付けた

UPDATE users u SET u.price = 1 WHERE id = 1;
ERROR:  column "u" of relation "users" does not exist
LINE 1: UPDATE users u SET u.price = 1 WHERE id = 1;
                           ^
HINT:  SET target columns cannot be qualified with the relation name.

エラーに出ているのは列名ではなく表の別名 u です。SET price = 1 と書きます。SET users.price も同じエラーです。

似ているが別のエラー

SQL エラー
SELECT u.nme FROM users u column u.nme does not exist(引用符なしで表示される)
SELECT x.name FROM users u missing FROM-clause entry for table "x"
JOIN した2表に同じ列名があり、表名を付けずに id column reference "id" is ambiguous
INSERT INTO users (id, nme) column "nme" of relation "users" does not exist
ALTER TABLE users DROP COLUMN nme 同上。IF EXISTS を付けると NOTICE で済む

別名を変えたのに SELECT 側を直し忘れると missing FROM-clause entry が出ます。表の列一覧は \d users でも確かめられます(テーブル定義を確認する記事)。

関連: PostgreSQLの「relation does not exist」 / PostgreSQLでテーブル定義を確認する / PostgreSQLのALTER TABLE / MySQLのERROR 1054

PostgreSQL をもっと深く知るための本

PostgreSQL実践入門 ──アーキテクチャ、運用監視、性能改善

技術評論社・2026年2月

アーキテクチャから運用監視・性能改善までを扱う。付録に PostgreSQL 18 の新機能と設定項目の差分がある。

Amazonで見る

[改訂3版]内部構造から学ぶPostgreSQL ―設計・運用計画の鉄則

技術評論社・2022年11月・PostgreSQL 14 ベース

内部構造の理解から、設計と運用計画の立て方を学ぶ。

Amazonで見る

Amazonのアソシエイトとして、FIRE SE は適格販売により収入を得ています。