EXPLAIN QUERY PLAN в SQLite: почему сканируется таблица с индексом?

План запроса отвечает точнее догадок: SCAN показывает проход по записям, SEARCH — поиск подходящего подмножества. Но одно слово в плане не измеряет время выполнения.

SQL Studio / Разборы SQL / EXPLAIN QUERY PLAN

Запрос выбирает три оплаченных заказа из шести, а SQLite показывает SCAN. Это не всегда признак ошибки: на небольшой таблице полный проход может оказаться разумным. Команда EXPLAIN QUERY PLAN SELECT ... раскрывает решение планировщика; после CREATE INDEX сопоставьте план ещё раз. Важны таблица, используемый индекс и способ доступа, а не обещание «будет в десять раз быстрее». Ниже каждый блок создаёт собственную учебную таблицу eqp_orders; запускайте блоки по отдельности в чистой SQLite-базе. Не выполняйте их на пользовательских таблицах.

1. Без индекса: что означает SCAN

На старте шесть заказов. Индекс для поля status ещё не создан. SQLite приходится проверить условие отбора при проходе по таблице. У EXPLAIN QUERY PLAN четыре технических столбца; здесь нас интересует значение detail.

CREATE TABLE eqp_orders (
  order_id INTEGER PRIMARY KEY,
  status TEXT NOT NULL,
  amount_kop INTEGER NOT NULL
);
INSERT INTO eqp_orders VALUES
  (1,'paid',10000), (2,'new',5000),
  (3,'paid',7000), (4,'cancelled',2000),
  (5,'new',8000), (6,'paid',9000);
EXPLAIN QUERY PLAN
SELECT order_id FROM eqp_orders WHERE status='paid';
SQLite 3.46.1 — поле detail
detail
SCAN eqp_orders

Числа внутренних ID узлов плана в разных версиях могут меняться. SCAN не сообщает, сколько миллисекунд занял запрос. Для чтения плана полезнее знать, какая таблица обходится и по какой причине.

2. CREATE INDEX меняет способ доступа

Добавим индекс по статусу и повторим тот же выбор. Данные и предикат не изменились. При извлечении только order_id SQLite может обойтись содержимым индекса: в таблице с INTEGER PRIMARY KEY ключ является rowid и доступен через индекс.

CREATE TABLE eqp_orders (
  order_id INTEGER PRIMARY KEY,
  status TEXT NOT NULL,
  amount_kop INTEGER NOT NULL
);
INSERT INTO eqp_orders VALUES
  (1,'paid',10000), (2,'new',5000),
  (3,'paid',7000), (4,'cancelled',2000),
  (5,'new',8000), (6,'paid',9000);
CREATE INDEX eqp_status_idx ON eqp_orders(status);
EXPLAIN QUERY PLAN
SELECT order_id FROM eqp_orders WHERE status='paid';
SQLite 3.46.1 — поле detail
detail
SEARCH eqp_orders USING COVERING INDEX eqp_status_idx (status=?)

SEARCH означает, что условие status=? использовано для адресного доступа. COVERING INDEX означает, что нужные запросу поля доступны в индексе без дополнительного чтения строки таблицы. Это описание стратегии, не измеренное ускорение.

3. Индекс создан, но в плане всё ещё SCAN

Теперь изменим только предикат: добавим конкатенацию пустой строки. Для человека условие эквивалентно сравнению статуса, но обычный индекс по status больше не применяется как поиск по равенству выражения status || ''. Это правдоподобная ошибка: SQL вернёт правильные строки, но план другой.

CREATE TABLE eqp_orders (
  order_id INTEGER PRIMARY KEY,
  status TEXT NOT NULL,
  amount_kop INTEGER NOT NULL
);
INSERT INTO eqp_orders VALUES
  (1,'paid',10000), (2,'new',5000),
  (3,'paid',7000), (4,'cancelled',2000),
  (5,'new',8000), (6,'paid',9000);
CREATE INDEX eqp_status_idx ON eqp_orders(status);
EXPLAIN QUERY PLAN
SELECT order_id FROM eqp_orders WHERE status || '' = 'paid';
SQLite 3.46.1 — поле detail
detail
SCAN eqp_orders USING COVERING INDEX eqp_status_idx

Заметьте тонкость: здесь SCAN всё-таки упоминает индекс — он используется как источник данных, но не для выборочного поиска по status=?. Поэтому фраза «SCAN означает, что индекс не используется» неверна. Для другого набора данных, статистики и версии SQLite план может отличаться; не переносите строку detail в жёсткий тест продукта. Разбор формата у авторов SQLite прямо предупреждает об изменениях представления плана.

4. Сверьте план с самими строками

Индекс не меняет бизнес-ответ запроса. Этот отдельный исполняемый блок проверяет именно строки, а не состояние оптимизатора.

CREATE TABLE eqp_orders (
  order_id INTEGER PRIMARY KEY,
  status TEXT NOT NULL,
  amount_kop INTEGER NOT NULL
);
INSERT INTO eqp_orders VALUES
  (1,'paid',10000), (2,'new',5000),
  (3,'paid',7000), (4,'cancelled',2000),
  (5,'new',8000), (6,'paid',9000);
CREATE INDEX eqp_status_idx ON eqp_orders(status);
SELECT order_id FROM eqp_orders WHERE status='paid' ORDER BY order_id;
Ожидаемые строки
order_id
1
3
6

Мини-практика

Замените в блоке 2 условие на status='new', затем на status || '' = 'new'. Какие строки и какой способ доступа вы ожидаете? Проверьте отдельно план и фактические ID. В бесплатной изолированной SQL-лаборатории используйте только новую учебную таблицу: не создавайте индекс на рабочей базе.

Смежные разборы: где JOIN размножает строки, порядок и топ-N, как выполнять свои запросы. Здесь задача иная: объяснить выбранную стратегию чтения, не исправлять число строк.


Если после SQLite хотите потренировать запросы на другом диалекте, курс SQL для аналитика на Stepik использует MySQL 8; EXPLAIN и детали плана в нём устроены иначе. Бесплатные примеры SQLite выше доступны без курса.