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
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
-
Prepare instruções com
sqlite3_prepare_v2()ousqlite3_prepare_v3()para que o SQLite as re-prepare para você. -
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.
-
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
SQLITE_PERMpermissão de acesso negadaSQLITE_ABORTconsulta abortadaSQLITE_BUSYo banco de dados está bloqueadoSQLITE_LOCKEDa tabela do banco de dados está bloqueadaSQLITE_NOMEMsem memóriaSQLITE_READONLYtentativa de escrever em um banco de dados somente leituraSQLITE_INTERRUPTinterrompidoSQLITE_IOERRerro de E/S do disco
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.
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.