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

ORA-12899: значение слишком большое для столбца

Значение длиннее, чем позволяет столбец. Сообщение указывает имя столбца и дает фактическую и максимальную длину, часто в байтах, а не в символах.

Код ошибки
ORA-12899
Категория
Значения данных и преобразование
Сообщение об ошибке
value too large for column string (actual: string, maximum: string)

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

ORA-12899 означает, что строка не помещается в свой столбец, например ORA-12899: value too large for column "SALES"."CUSTOMERS"."NAME" (actual: 61, maximum: 50). A VARCHAR2(50) по умолчанию столбец имеет 50 байт (NLS_LENGTH_SEMANTICS = BYTE), так что текст с акцентированными или нелатинскими символами, каждый из которых занимает от 2 до 4 байт в AL32UTF8, может переполнить столбец, который выглядит достаточно длинным.

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

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

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

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

    SELECT column_name, data_type, data_length, char_length, char_used
    FROM all_tab_columns WHERE table_name = 'CUSTOMERS' AND column_name = 'NAME';
  2. Расширьте столбец и задайте размер в символах, если он содержит текст на нескольких языках.

    ALTER TABLE customers MODIFY (name VARCHAR2(200 CHAR));
  3. Или обрежьте намеренно перед вставкой, если потеря конца данных допустима.

    INSERT INTO customers (name) VALUES (SUBSTR(:name, 1, 50));

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

Больше ошибок значений и преобразования данных

Код и текст сообщения взяты из Справка по ошибкам Oracle Database. Смотрите весь Список ошибок Oracle или поиск по всем ошибкам баз данных.

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

Работа с Oracle в SQLly

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