SQLite: códigos de erro

O erro SQLITE_NOLFS pode ser devolvido em sistemas que não suportam arquivos grandes quando o banco de dados cresce para ser maior do que o que o sistema de arquivos pode lidar. "NOLFS" significa "NO Large File Support".

O código de resultado SQLITE_NOMEM indica que o SQLite não conseguiu alocar toda a memória necessária para completar a operação. Em outras palavras, uma chamada interna para sqlite3_malloc() ou sqlite3_realloc() falhou em um caso em que a memória alocada foi necessária para continuar a operação.

Ao tentar abrir um arquivo, o erro SQLITE_NOTADB indica que o arquivo a ser aberto não parece ser um arquivo de banco de dados SQLite.

O código de resultado SQLITE_NOTFOUND é exposto de três maneiras: O código de resultado SQLITE_NOTFOUND também é usado internamente pela implementação SQLite, mas esses usos internos não são expostos à aplicação.

O código de resultado SQLITE_NOTICE não é devolvido por nenhuma interface C/C++. No entanto, SQLITE_NOTICE (ou melhor, um de seus códigos de erro estendidos) é usado como o primeiro argumento em um callback sqlite3_log() para indicar que uma operação incomum está ocorrendo.

O código de resultado SQLITE_NOTICE_RECOVER_ROLLBACK é passado para o callback de sqlite3_log() quando um jornal quente é rolado para trás.

O código de resultado SQLITE_NOTICE_RECOVER_WAL é passado para o callback do sqlite3_log() quando um arquivo de banco de dados do modo WAL é recuperado.

O código de resultado SQLITE_PERM indica que o modo de acesso solicitado para um banco de dados recém-criado não pôde ser fornecido.

O código de resultado SQLITE_PROTOCOL indica um problema com o protocolo de bloqueio de arquivos utilizado pelo SQLite. O erro SQLITE_PROTOCOL só é devolvido atualmente quando se usa o modo WAL e se tenta iniciar uma nova transação. Existe uma condição de corrida que pode ocorrer quando duas conexões separadas de banco de dados tentam iniciar uma transação ao mesmo tempo no modo WAL. O perdedor da corrida recua e tenta novamente, após um breve atraso. Se a mesma conexão perder a corrida de bloqueio dezenas de vezes ao longo de um intervalo de vários segundos, irá eventualmente desistir e devolver SQLITE_PROTOCOL. O erro SQLITE_PROTOCOL deve aparecer na prática muito, muito raramente, e apenas quando há muitos processos separados que competem intensamente para escrever no mesmo banco de dados.

O erro SQLITE_RANGE indica que o argumento do número de parâmetro para uma das rotinas sqlite3_bind ou o número de coluna em uma das rotinas sqlite3_colunn está fora de alcance.

O código de resultado SQLITE_READONLY é devolvido quando uma tentativa é feita para alterar alguns dados para os quais a conexão de banco de dados atual não tem permissão de escrita.

O código de resultado SQLITE_READONLY_CANTINIT origina- se no método xShmMap de um VFS para indicar que a região de memória compartilhada usada pelo modo WAL existe, mas que o seu conteúdo não é confiável e inutilizável pelo processo atual, uma vez que o processo atual não tem permissão de escrita na região de memória compartilhada. (A região de memória compartilhada para o modo WAL é normalmente um arquivo com um sufixo "-wal" que é mmapped no espaço do processo. Se o processo atual não tem permissão de escrita nesse arquivo, então não pode escrever em memória partilhada.) A lógica de nível superior dentro do SQLite normalmente interceptará o código de erro e criará uma região de memória compartilhada temporária dentro da memória para que o processo atual possa pelo menos ler o conteúdo da base de dados. Este código de resultado não deve atingir a camada de interface da aplicação.

O código de erro SQLITE_READONLY_CANTLOCK é um código de erro estendido para SQLITE_READONLY. O código de erro SQLITE_READONLY_CANTLOCK indica que SQLite não consegue obter um bloqueio de leitura em um banco de dados do modo WAL porque o arquivo de memória compartilhada associado a esse banco de dados é apenas de leitura.

O código de erro SQLITE_READONLY_DBMOVED é um código de erro estendido para SQLITE_READONLY. O código de erro SQLITE_READONLY_DBMOVED indica que um banco de dados não pode ser modificado porque o arquivo de banco de dados foi movido desde que foi aberto, e assim qualquer tentativa de modificar o banco de dados pode resultar em corrupção de banco de dados se os processos falharem porque o rollback journal não seria nomeado corretamente.

O código de resultado SQLITE_READONLY_DIRECTORY indica que o banco de dados é leído somente porque o processo não tem permissão para criar um arquivo de revista no mesmo diretório que o banco de dados e a criação de um arquivo de revista é um pré-requisito para a escrita.

O código de erro SQLITE_READONLY_RECOVERY é um código de erro estendido para SQLITE_READONLY. O código de erro SQLITE_READONLY_RECOVERY indica que um banco de dados do modo WAL não pode ser aberto porque o arquivo do banco de dados precisa ser recuperado e a recuperação requer acesso à escrita, mas só o acesso à leitura está disponível.

O código de erro SQLITE_READONLY_ROLLBACK é um código de erro estendido para SQLITE_READONLY. O código de erro SQLITE_READONLY_ROLLBACK indica que um banco de dados não pode ser aberto porque tem um jornal quente que precisa ser rodado de volta, mas não porque o banco de dados é readonly.

O código de resultado SQLITE_SCHEMA indica que o esquema do banco de dados mudou. Este código de resultado pode ser devolvido de sqlite3_step() para uma declaração preparada que foi gerada usando sqlite3_prepare() ou sqlite3_prepare16(). Se o esquema do banco de dados foi alterado por algum outro processo entre o tempo em que a declaração foi preparada e o tempo em que a declaração foi executada, este erro pode resultar. Se uma declaração preparada é gerada de sqlite3_prepare_v2() então a declaração é automaticamente re-preparada se o esquema mudar, até os tempos SQLITE_MAX_SCHEMA_RETRY (por omissão: 50). A interface sqlite3_step() só retornará a aplicação se a falha persistir após estes muitos ret. Não, não.

O código de erro SQLITE_TOOBIG indica que uma string ou BLOB era demasiado grande. O comprimento máximo padrão de uma string ou BLOB em SQLite é 1.000.000.000 bytes. Este comprimento máximo pode ser alterado no tempo de compilação usando a opção de compilação SQLITE_MAX_LENGTH, ou no tempo de execução usando a interface sqlite3_limit(db,SQLITE_LIMIT_LENGTH,...). O erro SQLITE_TOOBIG resulta quando o SQLite encontra uma string ou BLOB que excede o tempo de compilação ou o tempo de execução limite. O código de erro SQLITE_TOOBIG também pode resultar quando uma instrução SQL sobredimensionada é passada para uma das interfaces sqlite3_prepare_v2(). O comprimento máximo de uma instrução SQL é padrão para um valor semelhante. O comprimento máximo da instrução SQL pode ser definido em tempo de compilação usando SQLITE_MAX_SQL_LENGTH ou em tempo de execução usando sqlite3_limit(db,SQLITE_LIMIT_SQL_LENGTH,...).

O código de resultado SQLITE_WARNING não é devolvido por nenhuma interface C/C++. No entanto, SQLITE_WARNING (ou melhor, um de seus códigos de erro estendidos) é usado como o primeiro argumento em um callback sqlite3_log() para indicar que uma operação incomum e possivelmente mal-conselhada está acontecendo.

O código de resultado SQLITE_WARNING_AUTOINDEX é passado para o callback de sqlite3_log() sempre que a indexação automática é usada. Isso pode servir como um aviso aos designers de aplicativos de que o banco de dados pode se beneficiar de índices adicionais.