// справочник ошибок PostgreSQL

PostgreSQL 22001: значение слишком длинное для типа

Строка длиннее, чем лимит varchar(n) или char(n) столбца. PostgreSQL отклоняет её, а не обрезает молча.

SQLSTATE
22001
Имя
string_data_right_truncation
Категория
Исключение данных
Сообщение об ошибке
value too long for type character varying(20)

Что это значит

A varchar(n) или char(n) столбец содержит не более n символов. Вставка или обновление более длинного значения завершается ошибкой 22001 (string_data_right_truncation). PostgreSQL обрезает значение без предупреждения только при явном приведении типа, как в 'abcdef'::varchar(3), что требуется стандартом SQL.

Сообщение называет тип, но не столбец, поэтому если несколько столбцов имеют ограничения длины, придётся проверять, какое значение слишком длинное.

Распространённые причины

  • Пользовательский ввод или импортированные данные длиннее определения столбца.
  • Многоколоночная INSERT где значения идут в другом порядке, чем список столбцов, из-за чего длинное значение попадает в короткий столбец.
  • Схема, перенесенная из другой базы данных с жесткими ограничениями.

Как исправить

  1. Найдите, какой столбец переполнен, сравнивая длины значений с ограничениями.

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. Расширьте столбец или используйте text, которая не имеет ограничения по длине и работает так же, как varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. Если усечение допустимо, сделайте это явно.

    INSERT INTO customers (name) VALUES (left('a very long name ...', 20));

Безопасное воспроизведение

SELECT CAST('abc' AS varchar(2)) AS silently_truncated;
CREATE TEMP TABLE t (code varchar(2));
INSERT INTO t VALUES ('abc');  -- ERROR: value too long for type character varying(2)

Вопросы

Медленнее ли text, чем varchar, в PostgreSQL?

Нет. text и varchar используют одно и то же хранилище. Ограничение на длину касается данных, а не производительности.

Связанные ошибки

Больше ошибок данных

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.