Buscar códigos de erro

O código de erro SQLITE_IOERR_SEEK é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro dos métodos xLead ou xWrite no objeto sqlite3_io_methods enquanto tenta procurar um descritor de arquivo para o ponto de início do arquivo onde ocorre a leitura ou escrita.

O código de erro SQLITE_IOERR_SHMLOCK já não é usado.

O código de erro SQLITE_IOERR_SHMMAP é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xShmMap no objeto sqlite3_io_methods enquanto tenta mapear um segmento de memória compartilhada no espaço de endereço do processo.

O código de erro SQLITE_IOERR_SHMOPEN é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xShmMap no objeto sqlite3_io_methods enquanto tenta abrir um novo segmento de memória compartilhada.

O código de erro SQLITE_IOERR_SHMSIZE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S no método xShmMap no objeto sqlite3_io_methods enquanto tenta ampliar um arquivo "shm" como parte do processamento de transação do modo WAL. Este erro pode indicar que o volume do sistema de arquivos subjacente está fora do espaço.

O código de erro SQLITE_IOERR_SHORT_READ é um código de erro estendido para SQLITE_IOERR indicando que uma tentativa de leitura na camada VFS não foi capaz de obter tantos bytes quanto solicitado. Isso pode ser devido a um arquivo truncado.

O código de erro SQLITE_IOERR_TRUNCATE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S na camada VFS enquanto tenta alterar o tamanho de um arquivo usando o método xTruncate do objeto sqlite3_io_methods.

O código de erro SQLITE_IOERR_UNLOCK é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xUnlock no objeto sqlite3_io_methods.

O código de erro SQLITE_IOERR_VNODE é um código reservado para uso por extensões. Não é usado pelo núcleo SQLite.

O código de erro SQLITE_IOERR_WRITE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S na camada VFS enquanto tenta escrever em um arquivo no disco. Este erro pode resultar de um defeito de hardware ou porque um sistema de arquivos ficou desmontado enquanto o arquivo estava aberto. Este erro não deve ocorrer se o sistema de arquivos estiver cheio, pois há um código de erro separado (SQLITE_FULL) para esse fim.

O código de resultado SQLITE_LOCKED indica que uma operação de gravação não poderia continuar por causa de um conflito dentro da mesma conexão de banco de dados ou de um conflito com uma conexão de banco de dados diferente que usa um cache compartilhado. Por exemplo, uma instrução DROP TABLE não pode ser executada enquanto outro thread está lendo a partir dessa tabela na mesma conexão de banco de dados porque a queda da tabela excluiria a tabela de sob o leitor concorrente. O código de resultado SQLITE_LOCKED difere de SQLITE_BUSY no que SQLITE_LOCKED indica um conflito na mesma conexão de banco de dados (ou em uma conexão com um cache compartilhado) enquanto que SQLITE_BUSY indica um conflito com uma conexão de banco de dados diferente, provavelmente em um processo diferente.

O código de resultado SQLITE_LOCKED_SHAREDCACHE indica que o acesso a um registro de dados SQLite é bloqueado por outra conexão de banco de dados que está usando o mesmo registro no modo cache compartilhado. Quando duas ou mais conexões de banco de dados compartilham o mesmo cache e uma das conexões está no meio da modificação de um registro nesse cache, então outras conexões são bloqueadas do acesso a esses dados enquanto as modificações estão em curso para evitar que os leitores vejam uma alteração corrompida ou parcialmente completada.

O código de resultado SQLITE_LOCKED_VTAB não é usado pelo núcleo SQLite, mas está disponível para ser utilizado por extensões. As implementações de tabela virtual podem devolver este código de resultado para indicar que não podem completar a operação atual por causa de bloqueios mantidos por outros threads ou processos. A extensão R-Tree retorna este código de resultado quando uma tentativa é feita para atualizar o R-Tree enquanto outra declaração preparada está a ler activamente o R-Tree. A atualização não pode prosseguir porque qualquer alteração para um R-Tree pode envolver remodelação e reequilibramento de nós, o que iria interromper os cursores de leitura, fazendo com que algumas linhas sejam repetidas e outras omitidas.

O código de erro SQLITE_MISMAtch indica um erro do tipo de dados. SQLite é normalmente muito indulgente quanto às divergências entre o tipo de um valor e o tipo declarado do recipiente em que esse valor deve ser armazenado. Por exemplo, SQLite permite que a aplicação guarde um BLOB grande em uma coluna com um tipo declarado de BOOLEAN. Mas em alguns casos, SQLite é rigoroso quanto aos tipos. O erro SQLITE_MISMAtch é devolvido nesses poucos casos quando os tipos não coincidem. O roeid de uma tabela deve ser um inteiro. Tentar definir o roeid para qualquer outra coisa que não um inteiro (ou um NULL que será convertido automaticamente para o próximo inteiro disponível) resulta num erro SQLITE_MISMAtch.

O código de retorno SQLITE_MISUSE pode ser devolvido se o aplicativo usar qualquer interface SQLite de uma forma indefinida ou não suportada. Por exemplo, usando uma declaração preparada após que essa declaração preparada tenha sido finalizada pode resultar em um erro SQLITE_MISUSE. SQLite tenta detectar o uso indevido e reportar o uso indevido usando este código de resultado. No entanto, não há garantia de que a detecção de uso indevido será bem sucedida. A detecção de erros é probabilística. As aplicações nunca devem depender de um valor de retorno SQLITE_MISUSE. Se o SQLite devolve alguma vez o SQLITE_MISUSE a partir de qualquer interface, isso significa que o aplicativo está codificado incorretamente e precisa ser corrigido. Não envie um aplicativo que às vezes retorna o SQLITE_MISUSE a partir de uma interface SQLite padrão, porque o aplicativo contém erros potencialmente graves.

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.