ツール
PostgreSQL
標準準拠と拡張性で広く使われるオープンソースのリレーショナルデータベース。接続文字列・認証(pg_hba)・ポートやコネクション上限まわりで「接続できない」に陥りやすく、Prisma など ORM 経由でも同じ原因に当たる。
問題一覧(11)
PostgreSQL「column does not exist」が列はあるのに出る原因と直し方
column does not exist は、大文字を含む列名を引用符なしで参照すると出る。列名をダブルクオートで囲んで参照すれば直る。引用符なしの識別子は小文字へ畳まれるためで、文字列リテラルはシングルクオートで書く。
更新: 2026-10-05、タグ: column、identifier、case-sensitivity
PostgreSQL に「Connection refused」で接続できない(port 5432)
PostgreSQL の Connection refused は、サーバーを起動し、listen_addresses とポート番号を接続先に合わせれば直る。その host とポートで待ち受けるプロセスが無いと出る。
更新: 2026-11-04、タグ: connection-refused、listen_addresses、port
PostgreSQL「current transaction is aborted」の原因と直し方
current transaction is aborted は、ROLLBACK してやり直すか、失敗しうる文を SAVEPOINT で囲めば直る。同じトランザクションで先に失敗した SQL があると、後の文はすべてこのエラーで拒まれる。
更新: 2026-11-20、タグ: transaction、rollback、savepoint
PostgreSQL で「FATAL: database does not exist」で接続できない
FATAL: database does not exist は、接続先の DB が無いときに出る。createdb で作るか、psql -d で既存の DB を指定すれば直る。DB 名を省くとユーザー名と同名の DB に繋ぎに行く。
更新: 2026-10-05、タグ: database、createdb、psql
PostgreSQL「duplicate key value violates unique constraint」の原因と直し方
duplicate key value violates unique constraint は、DETAIL に出た値の重複を除くか、ずれたシーケンスを setval で最大値に合わせれば直る。id を明示して INSERT したあとの serial 列でよく起きる。
更新: 2026-11-19、タグ: duplicate-key、unique、sequence
PostgreSQL で「password authentication failed for user」になり接続できない
psql や ORM の接続で FATAL: password authentication failed が出るのは、パスワード不一致か pg_hba.conf の認証方式の食い違いが原因。ロールのパスワード再設定と pg_hba.conf の方式確認+reload で解消する。
更新: 2026-10-15、タグ: authentication、pg_hba、scram
PostgreSQL で「Peer authentication failed for user」が出て接続できない
Peer authentication failed for user は、OS のユーザー名と DB のユーザー名が違うと出る。同名の OS ユーザーで実行するか、TCP 接続かパスワード認証へ切り替えれば直る。
更新: 2026-10-18、タグ: authentication、pg_hba、peer
PostgreSQL で「permission denied for table」が出てテーブルを操作できない
permission denied for table は、ロールにテーブルの権限が無いと出る。GRANT でテーブル権限とスキーマの USAGE を付け、新しいテーブルには ALTER DEFAULT PRIVILEGES を使う。
更新: 2026-10-06、タグ: permission、grant、role
PostgreSQL で「relation does not exist」になる(テーブルはあるのに見つからない)
relation does not exist は、大文字を含む名前を引用符なしで参照したときに出る。参照側もダブルクオートで囲めば直る。search_path に対象スキーマが無い場合は schema.table と修飾する。
更新: 2026-11-10、タグ: relation、search-path、schema
PostgreSQL で「role does not exist」になり接続・操作できない
FATAL: role ... does not exist は、接続に使うロール(ユーザー)がそのクラスタに無いときに出る。CREATE ROLE で作るか、接続ユーザー名や POSTGRES_USER を実在するロールに合わせれば解消する。
更新: 2026-10-07、タグ: role、authentication、createrole
PostgreSQL で「sorry, too many clients already」が出て接続できない
FATAL: sorry, too many clients already は同時接続数が max_connections に達したサイン。接続リークを止めるかコネクションプーラを挟むのが本筋で、max_connections の引き上げは最後の手段。
更新: 2026-10-21、タグ: max_connections、pgbouncer、pooling