PostgreSQL『more than one row returned by a subquery used as an expression』の原因と対処
- 2025.09.26
単一の値を返す前提（スカラ副問い合わせ）の場所で、実際には2行以上返ってしまったときに発生する。=（等価比較）の右側、SELECT句の式、INSERT/UPDATEの値式、CHECK制約や生成列の式などが対象。要件別の書き換え（IN/EXISTS/JOIN/集約/上位1件の決定規則/配列化）と、スキ […]
その他
PostgreSQL『cast from type to integer is not allowed』の原因と対処
- 2025.09.25
「X という型から integer へのキャストは許可されない」趣旨のエラー（典型表示：cannot cast type X to integer）が出る状況を整理。発生しやすい型（boolean/jsonb/uuid/date/enum/bytea/array/ドメイン型）ごとの解決パターン、数値 […]
PostgreSQL『ERROR: index row size exceeds maximum』の原因と対処
- 2025.09.24
B-treeインデックスに格納される1レコード（インデックスタプル）が上限サイズを超えたときに出る。8KBブロックの環境では1タプルあたり約2.7KB前後が実質上限で、巨大なtext/varcharや多列インデックス、INCLUDE列の盛り過ぎ、jsonbのB-tree化などで発生しやすい。即効回避 […]
PostgreSQL『connection limit exceeded for non-superusers』の原因と対処
- 2025.09.24
新規接続が上限に達し、一般ユーザー（非スーパーユーザー）の接続を受け付けられない状態で発生する。典型メッセージの読み方、発生条件、即効復旧（安全にセッションを開放）、恒久対策（接続数設計・プーリング・設定値の見直し）、クラウド環境での注意点までを体系化した。 エラーメッセージの読み方（代表例） ・「 […]
PostgreSQL『ERROR: cannot change name of input parameter in FUNCTION』の原因と対処
- 2025.09.22
CREATE OR REPLACE FUNCTIONで既存関数の「入力（IN）パラメータ名」を変更しようとすると、このエラーが出る。呼び出し側の名前付き引数（named notation）互換性を壊すのを防ぐため、PostgreSQLはIN引数名の置き換えを禁止している。最短復旧、恒久対策、互換維持 […]
PostgreSQL「ERROR: invalid input syntax for type」の原因と対処
- 2025.09.17
概要。型に合わない文字列やフォーマットを列やキャストに渡すと、PostgreSQL は「invalid input syntax for type 」(SQLSTATE 22P02) を返す。代表的な発生箇所（INSERT/UPDATE/COPY/CAST/関数引数）と型別の落とし穴、ETLでの切り […]
PostgreSQLでのエラー『 table referenced in 』の原因と対処
- 2025.09.10
他テーブルの外部キー（FOREIGN KEY）が参照している表をDROPしようとすると、依存関係の保全のために拒否される。正しい手順は「依存の見える化 → 参照元のテーブル/制約を先に処理 → 必要ならCASCADEで一括」と段階的に進める。再現用コード、依存の洗い出しSQL、DROP順序の自動生成 […]
PostgreSQL『ERROR: cannot execute SELECT FOR UPDATE』の原因と対処
- 2025.09.10
SELECT … FOR UPDATE/NO KEY UPDATE/SHARE/KEY SHARE で行ロックを取得しようとした際、トランザクション状態や接続先、クエリ形状の制約により実行できないときに発生する。代表メッセージ別に切り分け、最短復旧手順、正しいクエリ形、代替手段（UPDATE … R […]
PostgreSQL『current transaction is aborted, commands ignored until end of transaction block』エラーの原因と対処
- 2025.09.05
トランザクション内で先行ステートメントが失敗すると、そのトランザクションは「失敗状態（aborted）」になり、ROLLBACK（またはSAVEPOINTによる部分ロールバック）で状態を戻すまで後続コマンドがすべて拒否される。代表メッセージ、発生条件、最短復旧、原因特定のコツ、psql/各言語ドライ […]
PostgreSQL「column reference is ambiguous」の原因と対処
- 2025.09.03
タイトルの直後に概要を配置。複数テーブル結合やサブクエリで同名列を未修飾のまま参照すると、PostgreSQLは「どのテーブルの列か特定できない」と判断して「column reference is ambiguous」を出す。発生条件、再現コード、典型的な落とし穴、実務での直し方と予防策までを網羅。 […]