// Referencia de errores de SQLite

SQLITE_RANGE: Índice de columna fuera de rango

Un número de parámetro pasado a una función sqlite3_bind, o un número de columna pasado a una función sqlite3_column, está fuera del rango válido.

Código de resultado
SQLITE_RANGE
Nombre
25
Categoría
Códigos de resultado primarios
Mensaje de error
column index out of range

Qué significa

SQLITE_RANGE (25) significa que un índice de enlace o de columna no existe en la instrucción. Los parámetros se numeran desde 1, y el más alto es el número de ? marcadores de posición (o el mayor ?NNN). Los bindings dan el mismo error cuando pasas más valores de los que la instrucción tiene placeholders, por ejemplo el de Python Incorrect number of bindings supplied.

Causas comunes

  • Enlazar el parámetro 0, o un parámetro más de los que tiene la instrucción.
  • Pasar una lista de valores que no coincide con el número de ? marcadores de posición.
  • Leer un índice de columna más allá del número de columnas de resultados.
  • Poner ? entre comillas, donde es un signo de interrogación literal, no un marcador de posición.

Cómo solucionarlo

  1. Cuenta los marcadores de posición y pasa exactamente esa cantidad de valores. Los índices de vinculación comienzan en 1.

  2. Usa parámetros con nombre para evitar errores de conteo.

    SELECT * FROM users WHERE email = :email AND status = :status;
  3. Nunca pongas comillas a un marcador de posición: escribe WHERE name = ?, no WHERE name = '?'.

Errores relacionados

Más errores de códigos de resultado principales

El código y el texto del mensaje son de Documentación de los códigos de resultado y de error de SQLite. Explora la lista completa de Lista de errores de SQLite o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con SQLite en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQLite y las demás bases de datos que uses.