// Referência de erro do SQLite

SQLITE_RANGE: índice da coluna fora do intervalo

Um número de parâmetro passado para uma função sqlite3_bind, ou um número de coluna passado para uma função sqlite3_column, está fora do intervalo válido.

Código de resultado
SQLITE_RANGE
Nome
25
Categoria
Códigos de resultado primários
Mensagem de erro
column index out of range

O que significa

SQLITE_RANGE (25) significa que um índice de bind ou de coluna não existe na instrução. Os números de parâmetro começam em 1, e o maior é o número de ? placeholders (ou o maior ?NNN). As bindings de linguagem reclamam do mesmo erro quando você passa mais valores do que a instrução tem placeholders, por exemplo, o do Python Incorrect number of bindings supplied.

Causas comuns

  • Vinculação do parâmetro 0, ou um parâmetro a mais do que a instrução tem.
  • Passar uma lista de valores que não corresponde ao número de ? placeholders.
  • Lendo um índice de coluna além do número de colunas de resultado.
  • Colocando ? dentro de aspas, onde é um ponto de interrogação literal, não um placeholder.

Como corrigir

  1. Conte os placeholders e passe exatamente esse número de valores. Os índices de bind começam em 1.

  2. Use parâmetros nomeados para evitar erros de contagem.

    SELECT * FROM users WHERE email = :email AND status = :status;
  3. Nunca coloque um placeholder entre aspas: escreva WHERE name = ?, não WHERE name = '?'.

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.