// Referência de erro do SQLite

SQLITE_SCHEMA: o esquema do banco de dados foi alterado

Uma instrução preparada ficou inválida porque o esquema mudou depois que ela foi preparada, e o SQLite não conseguiu prepará-la de novo.

Código de resultado
SQLITE_SCHEMA
Nome
17
Categoria
Códigos de resultado primários
Mensagem de erro
database schema has changed

O que significa

SQLITE_SCHEMA (17) significa que o esquema mudou entre preparar uma instrução e executá-la, por exemplo, outra conexão adicionou um índice ou alterou uma tabela. Instruções preparadas com sqlite3_prepare_v2() (o que quase todas as bibliotecas modernas usam) são re-preparadas automaticamente, até 50 vezes por padrão, então você só vê esse erro com o legado sqlite3_prepare() ou quando a re-preparação continua falhando.

Causas comuns

  • Usando a interface legada sqlite3_prepare() interface, que não faz o re-prepare quando o esquema muda.
  • Outra conexão alterando o esquema constantemente enquanto as instruções estão sendo preparadas e executadas.
  • Uma alteração de esquema que deixa a instrução repreparada inválida, por exemplo remover uma coluna que ela usa.

Como corrigir

  1. Prepare instruções com sqlite3_prepare_v2() ou sqlite3_prepare_v3() para que o SQLite as re-prepare para você.

  2. Se você recebeu isso de um cache de instruções, libere a instrução em cache e prepare-a novamente após uma alteração de esquema.

  3. Execute migrações de esquema enquanto a aplicação estiver ociosa, não enquanto outras conexões estiverem executando instruções.

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.