// Referência de erro do SQLite

SQLITE_TOOBIG: string ou blob grande demais

Uma string, BLOB ou instrução SQL era maior que o limite do SQLite, 1.000.000.000 bytes por padrão, ou um limite menor definido pela aplicação.

Código de resultado
SQLITE_TOOBIG
Nome
18
Categoria
Códigos de resultado primários
Mensagem de erro
string or blob too big

O que significa

SQLITE_TOOBIG (18) é retornado quando uma string ou BLOB excede o comprimento máximo, definido em tempo de compilação com SQLITE_MAX_LENGTH (padrão 1.000.000.000 bytes) ou reduzido em tempo de execução com sqlite3_limit(db, SQLITE_LIMIT_LENGTH, ...). Uma instrução SQL grande demais recebe o mesmo erro; o limite dela é SQLITE_MAX_SQL_LENGTH / SQLITE_LIMIT_SQL_LENGTH. Uma linha maior que o limite de comprimento também falha.

Causas comuns

  • Armazenar um arquivo ou documento muito grande em um único valor BLOB ou TEXT.
  • Construir uma única instrução SQL enorme, como um INSERT com milhões de valores literais.
  • Um aplicativo ou binding que tenha reduzido o limite com sqlite3_limit().
  • A group_concat() ou concatenação de strings que exceda o limite.

Como corrigir

  1. Armazene arquivos grandes fora do banco de dados e mantenha seus caminhos, ou divida o conteúdo em partes distribuídas por linhas.

  2. Insira muitas linhas com uma instrução preparada executada repetidamente, com parâmetros vinculados, em vez de uma única instrução enorme.

    INSERT INTO items (id, name) VALUES (?, ?);  -- prepare once, bind and run per row
  3. Verifique se o seu binding define um limite de comprimento menor e, se apropriado, aumente-o.

Erros relacionados

Mais erros de códigos de resultado primário

O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.

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

Trabalhe com SQLite 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 SQLite e os outros bancos de dados que você usa.