Symptoms
A PL/pgSQL SELECT INTO STRICT returned more than one row.
- The error is written to the server log and returned to the client carrying
SQLSTATE P0003. - Any driver (libpq, JDBC, psycopg, npgsql, pgx) surfaces this code in its error object so you can branch on it programmatically.
- PL/pgSQL can trap it by name:
EXCEPTION WHEN too_many_rows THEN.
Environment
Severity: ERROR | PostgreSQL versions: 12, 13, 14, 15, 16, 17
Reproduce with the exact statement and read the full message in the server log (raise log_min_messages / set log_min_error_statement for more context).
Root Cause
A SELECT ... INTO STRICT matched multiple rows, which STRICT forbids.
Diagnostic Queries
Recovery
Steps to resolve P0003:
- Make the query return exactly one row (add a key predicate or
LIMIT 1). - If multiple rows are valid, remove STRICT and loop or aggregate.
Reference: PostgreSQL error codes — Class P0 (PL/pgSQL Error).
Thanks — noted. This helps keep the database accurate.