// Referência de erro do SQLite

SQLITE_ERROR: erro de lógica SQL

Código de erro genérico do SQLite: um erro de sintaxe, uma tabela ou coluna ausente, ou outro problema com o SQL. O motivo real está na mensagem de erro, não no código.

Código de resultado
SQLITE_ERROR
Nome
1
Categoria
Códigos de resultado primários
Mensagem de erro
SQL logic error

O que significa

SQLITE_ERROR (1) é o código que o SQLite usa quando nenhum código mais específico se aplica. Quase todo erro no próprio SQL cai aqui: um erro de digitação, uma tabela ou coluna que não existe, uma tabela que já existe, uma quantidade errada de valores. O texto genérico é SQL logic error; a mensagem de sqlite3_errmsg() diz o que realmente deu errado, por exemplo no such table: users, no such column: emial, near "FORM": syntax error ou table users already exists.

Porque um único código cobre tantos problemas, registre e leia sempre a mensagem.

Causas comuns

  • Um erro de sintaxe: near "...": syntax error aponta para o token onde o parsing falhou.
  • no such table: o nome da tabela está escrito de forma incorreta, ela está em um banco de dados anexado que você não qualificou, ou o programa abriu um arquivo de banco de dados diferente (frequentemente novo e vazio) do que você pensa.
  • no such column: uma coluna escrita incorretamente, ou um literal de string escrito entre aspas duplas que o SQLite interpretou como nome de coluna.
  • table ... already exists de um CREATE TABLE sem IF NOT EXISTS.
  • Usando sintaxe ou funções que a sua versão do SQLite é muito antiga para suportar, como RETURNING (3.35) ou funções de janela (3.25).

Como corrigir

  1. Leia a mensagem completa e corrija o que ela indica. Verifique o esquema ao qual você está realmente conectado:

    SELECT name, type FROM sqlite_schema ORDER BY name;
    PRAGMA table_info(users);
  2. Se uma tabela estiver ausente, verifique qual arquivo está aberto. Um caminho relativo abre um arquivo relativo ao diretório de trabalho do processo, e abrir um caminho que não existe cria um novo banco de dados vazio.

    PRAGMA database_list;
  3. Use aspas simples para literais de string e aspas duplas apenas para identificadores.

    SELECT * FROM users WHERE status = 'active';
  4. Verifique a versão da biblioteca quando a sintaxe mais recente falhar.

    SELECT sqlite_version();

Reproduza com segurança

SELECT * FROM no_such_table;   -- Parse error: no such table: no_such_table

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.