PostgreSQL 22P02: недопустимый синтаксис ввода для типа
Значение текста не удалось преобразовать к целевому типу: буквы в число, некорректный UUID, неправильный JSON, пустая строка в число.
- SQLSTATE
22P02- Имя
invalid_text_representation- Категория
- Исключение данных
Что это значит
PostgreSQL преобразует литералы и текст в типизированные значения с помощью функции ввода каждого типа. Если текст не является допустимым представлением типа, преобразование завершается ошибкой 22P02, и в сообщении приводится проблемное значение.
Значение может прийти из литерала в запросе, привязанного параметра, CASTили столбца текста, который сравнивается с типизированным столбцом или вставляется в него.
Распространённые причины
- Сравнение числового или UUID-столбца со строкой, которая не является числом или UUID, например
WHERE id = 'abc'или пустая строка''. - Передача пустой строки там, где ожидается число. PostgreSQL не превращает
''вNULLили 0. - Неверный ввод для
uuid,json/jsonb,boolean,inetили литерала массива. - Массово
COPYили загрузки CSV, где одна строка содержит текст в числовом столбце.
Как исправить
-
Найдите строки, которые не удастся преобразовать, до приведения типов (в PostgreSQL 16 и новее есть
pg_input_is_valid).SELECT raw_value FROM staging WHERE NOT pg_input_is_valid(raw_value, 'integer');
-
В старых версиях фильтруйте по шаблону до приведения типов.
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
Преобразуйте пустые строки в
NULLявно.SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
В коде приложения передавайте параметры с правильным типом вместо склейки SQL-строк и проверяйте ввод до того, как он попадёт в базу данных.
Безопасное воспроизведение
SELECT 'abc'::int; -- ERROR: invalid input syntax for type integer: "abc"
Связанные ошибки
22003числовое значение вне допустимого диапазона22007неверный формат даты и времени42804несоответствие типов данных22021недопустимая последовательность байтов для кодировки245SQL Server: не удалось преобразовать значение1366MySQL: Некорректное значение для столбцаORA-01722Oracle: неверное число
Больше ошибок данных
22008значение поля даты/времени вне допустимого диапазона22012деление на ноль22023неверное значение параметра22001значение слишком длинное для типа
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.