// справочник ошибок SQLite

SQLITE_RANGE: индекс столбца вне диапазона

Номер параметра, переданный функции sqlite3_bind, или номер столбца, переданный функции sqlite3_column, находится вне допустимого диапазона.

Код результата
SQLITE_RANGE
Имя
25
Категория
Основные коды результатов
Сообщение об ошибке
column index out of range

Что это значит

SQLITE_RANGE (25) означает, что индекс привязки или столбца не существует в запросе. Номера параметров начинаются с 1, а максимальный соответствует числу ? заполнителей (или наибольшему ?NNN). Языковые привязки сообщают об одной и той же ошибке, когда вы передаёте больше значений, чем заполнителей в запросе, — например, ошибка Python Incorrect number of bindings supplied.

Распространённые причины

  • Привязка параметра 0 — или на один параметр больше, чем у инструкции заполнителей.
  • Передача списка значений, который не соответствует числу ? заполнителей.
  • Чтение индекса столбца за пределами числа столбцов результата.
  • Поместив ? в кавычках, где это литеральный знак вопроса, а не заполнитель.

Как исправить

  1. Посчитайте плейсхолдеры и передайте ровно столько значений. Индексы привязки начинаются с 1.

  2. Используйте именованные параметры, чтобы избежать ошибок при подсчете.

    SELECT * FROM users WHERE email = :email AND status = :status;
  3. Никогда не заключайте заполнитель в кавычки: пишите WHERE name = ?, а не WHERE name = '?'.

Связанные ошибки

Больше ошибок основных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQLite в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.