P0003 — too_many_rows
PostgreSQL SQLSTATE P0003 的源码与诊断参考。
P0003
速览
P0003 是 PL/pgSQL too_many_rows。固定路径给出准确的 message、可选 detail、hint 和按实际分支决定的严重级别。
| 字段 | 值 |
|---|---|
| SQLSTATE | P0003 |
| 条件名 | too_many_rows |
| 状态 | 有效 |
| 已知存在于 | 8.2.0 |
| 锁定快照 | 9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3 |
| 宏 | ERRCODE_TOO_MANY_ROWS |
| 别名 | — |
含义
当受检查的 PL/pgSQL 查询返回多于一行时，源码报告 query returned more than one row；开启 strict 参数打印时可附带 parameters: %s，并在一条路径提供 Make sure the query returns a single row, or use LIMIT 1. hint。普通多行 SELECT 不会因此自动成为 P0003。
诊断
先看是否是严格目标赋值或 modifying statement，再检查完整 detail/hint。固定源码先按 plpgsql.extra_errors/plpgsql.extra_warnings 对 too_many_rows 的选择设置级别：前者优先并使用 ERROR，只有后者生效时才使用 WARNING；strict/modifying 路径无论这些设置如何都使用 ERROR，所以不要只凭条件名断言严重级别。
处置
让查询满足单行契约，或改用能表达多行结果的 PL/pgSQL 结构；若业务允许第一行，必须显式设计排序和截取语义，而不是盲目套用 hint。修正查询契约后再执行，避免把同一多行结果自动重放成重复业务操作。
版本
锁定目录从 8.2.0 记录该条件，并在列出的正式快照及 19beta3 中出现；运行时未在本批次重演。
相关条件
来源
可直接阅读固定的 pl_exec.c GUC 分支和报告路径；完整范围见结构化证据记录。