// Referência de erro do Oracle

ORA-12899: valor muito grande para a coluna

Um valor é maior do que a coluna permite. A mensagem menciona a coluna e informa o comprimento real e o máximo, muitas vezes em bytes em vez de caracteres.

Código de erro
ORA-12899
Categoria
Valores de dados e conversão
Mensagem de erro
value too large for column string (actual: string, maximum: string)

O que significa

ORA-12899 significa que uma string não cabe em sua coluna, por exemplo ORA-12899: value too large for column "SALES"."CUSTOMERS"."NAME" (actual: 61, maximum: 50). Uma VARCHAR2(50) coluna tem 50 bytes por padrão (NLS_LENGTH_SEMANTICS = BYTE), então texto com caracteres acentuados ou não latinos, que ocupam de 2 a 4 bytes cada em AL32UTF8, pode exceder o tamanho de uma coluna que parece ser grande o suficiente.

Causas comuns

  • Os dados são maiores do que a definição da coluna.
  • Caracteres multibyte em uma coluna dimensionada em bytes.
  • Migrando para um conjunto de caracteres Unicode no banco de dados, o que faz algumas strings ficarem maiores em bytes.

Como corrigir

  1. Encontre os maiores valores que entrariam na coluna e compare com a definição dela.

    SELECT column_name, data_type, data_length, char_length, char_used
    FROM all_tab_columns WHERE table_name = 'CUSTOMERS' AND column_name = 'NAME';
  2. Aumente a largura da coluna e dimensione-a em caracteres se ela armazenar texto em vários idiomas.

    ALTER TABLE customers MODIFY (name VARCHAR2(200 CHAR));
  3. Ou trunque deliberadamente antes de inserir, se perder o final for aceitável.

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

Erros relacionados

Mais erros de valores de dados e conversão

O código e o texto da mensagem são de Ajuda de erros do Oracle Database. Veja toda a Lista de erros do Oracle ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com Oracle no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o Oracle e os outros bancos de dados que você usa.