SQLite Query Explainer: интерактивный разбор планов запросов

Если вы когда-нибудь смотрели на вывод EXPLAIN QUERY PLAN в SQLite и думали: «Что это вообще значит?» — знайте, вы не одиноки. Джулия Эванс (Julia Evans), известный технический блогер и автор популярных «зин» о программировании, честно призналась в своём свежем посте «Learning a few things about running SQLite»:

«Может, когда-нибудь я научусь читать планы запросов.»

Эта фраза вдохновила разработчика и исследователя Саймона Уиллисона (Simon Willison) создать нечто полезное: интерактивный инструмент SQLite Query Explainer, который не просто показывает сырой вывод команд, но и объясняет его человеческим языком.

Что такое EXPLAIN и EXPLAIN QUERY PLAN?

Прежде чем разбираться с инструментом, стоит понять, что именно он объясняет.

Когда перед SQL-запросом добавляется ключевое слово EXPLAIN, оператор ведёт себя как запрос, возвращающий последовательность инструкций виртуальной машины, которые были бы выполнены без этого ключевого слова.

Когда же используется фраза EXPLAIN QUERY PLAN, оператор возвращает высокоуровневую информацию о плане запроса, который был бы применён.

По сути, это два разных уровня детализации:

EXPLAIN QUERY PLAN — полезная команда, которая рассказывает, как SQLite будет выполнять сортировку и поиск. Если программа работает недостаточно быстро, именно эта команда может помочь найти проблему.

EXPLAIN же рассказывает о том, как работает SQLite внутри. Рядовому пользователю она редко бывает полезна, поскольку он мало что может изменить на основе её вывода. Скорее она нужна команде разработчиков самого SQLite.

Что читать в выводе EXPLAIN QUERY PLAN?

Для каждой таблицы, читаемой запросом, вывод EXPLAIN QUERY PLAN содержит запись, в которой значение столбца «detail» начинается либо с SCAN, либо с SEARCH. SCAN означает полное сканирование таблицы, включая случаи, когда SQLite перебирает все записи в порядке, определённом индексом. SEARCH указывает на то, что посещается лишь подмножество строк таблицы.

Другими словами:

• SCAN = «читаем всё подряд» — медленно на больших таблицах
• SEARCH = «используем индекс» — быстро и эффективно

-- Пример: запрос без индекса
EXPLAIN QUERY PLAN
SELECT * FROM users WHERE email = 'user@example.ru';
-- Вывод: SCAN users  ← плохо, читает всю таблицу

-- После создания индекса
CREATE INDEX idx_users_email ON users(email);
EXPLAIN QUERY PLAN
SELECT * FROM users WHERE email = 'user@example.ru';
-- Вывод: SEARCH users USING INDEX idx_users_email  ← отлично!

Хотя полное сканирование таблицы вполне допустимо для маленьких таблиц, по мере роста данных понимание и использование индексов может кардинально изменить производительность.

Как работает новый инструмент

Саймон Уиллисон вдохновился постом Джулии Эванс и поручил Fable (AI-агенту от Anthropic) построить интерактивный инструмент для объяснения запросов. Техническая цепочка выглядит так:

graph LR
    A[Браузер пользователя] --> B[WebAssembly / Pyodide]
    B --> C[Python в браузере]
    C --> D[SQLite]
    D --> E[EXPLAIN]
    D --> F[EXPLAIN QUERY PLAN]
    E --> G[Человекочитаемое объяснение]
    F --> G

Проект Pyodide включает WebAssembly-сборки ряда Python C-расширений, и APSW оказался в этом списке. Это позволило создать веб-интерфейс, где пользовательский запрос выполняется в Python прямо в браузере через WebAssembly.

Таким образом, инструмент:

1. Принимает SQL-запрос прямо в браузере
2. Выполняет EXPLAIN и EXPLAIN QUERY PLAN через Python/SQLite в WebAssembly
3. Добавляет слой объяснений поверх сырого вывода

Технический стек

APSW — это «Another Python SQLite Wrapper» (ещё одна обёртка Python для SQLite), находящаяся в постоянной разработке с 2004 года. Функция apsw.ext.query_info() принимает SQL-запрос и возвращает подробный набор информации о нём — всё это без фактического выполнения запроса.

Почему это важно: боль с планами запросов

Понять вывод EXPLAIN QUERY PLAN — нетривиальная задача даже для опытных разработчиков. Вывод EXPLAIN нередко сложен и труден для понимания без глубокого знания внутреннего устройства SQLite.

Джулия Эванс работала над Django-сайтом и решила использовать SQLite в качестве базы данных. Прочитав множество постов о том, что SQLite вполне подходит для продакшена небольшого сайта, она осознала: SQLite — это всё равно база данных, базы данных устроены сложно, и она мало что знает об их эксплуатации.

Это типичная ситуация для многих разработчиков: SQLite воспринимается как «простое» решение, но стоит начать разбираться в деталях производительности — и вопросов становится больше, чем ответов.

Практический пример: читаем план запроса

Допустим, у вас есть таблица orders (заказы) с миллионом строк, и вы хотите найти все заказы конкретного пользователя:

-- Шаг 1: смотрим план без индекса
EXPLAIN QUERY PLAN
SELECT * FROM orders WHERE user_id = 42;

Вывод без индекса:

QUERY PLAN
`--SCAN orders

Это означает: SQLite читает все строки таблицы. На миллионе записей — это медленно.

-- Шаг 2: создаём индекс
CREATE INDEX idx_orders_user ON orders(user_id);

-- Шаг 3: проверяем план снова
EXPLAIN QUERY PLAN
SELECT * FROM orders WHERE user_id = 42;

Вывод с индексом:

QUERY PLAN
`--SEARCH orders USING INDEX idx_orders_user (user_id=?)

Теперь SQLite использует индекс для значительно более быстрого поиска. Вместо сканирования всей таблицы он быстро сужает круг нужных строк с помощью индекса, что демонстрирует существенный прирост производительности.

Стоимостная модель SQLite

Планировщик запросов SQLite не работает вслепую — он оценивает стоимость разных стратегий выполнения.

SQLite использует планировщик запросов, основанный на стоимости: он оценивает стоимость различных планов выполнения и выбирает вариант с наименьшей расчётной стоимостью. Стоимость, как правило, измеряется объёмом дискового ввода-вывода и процессорного времени.

При обработке запроса SQLite может извлекать данные из таблиц различными способами: сканировать все записи таблицы (полное сканирование), сканировать непрерывное подмножество записей на основе индекса rowid, сканировать непрерывное подмножество записей индекса базы данных или применять комбинацию этих стратегий в одном сканировании.

Где попробовать

Интерактивный инструмент SQLite Query Explainer доступен на сайте Саймона Уиллисона: tools.simonwillison.net/apsw-query

Всё работает прямо в браузере — никакой установки не требуется. Просто введите SQL-запрос и получите объяснение плана выполнения на человеческом языке.

Итог

SQLite Query Explainer — красивый пример того, как современные инструменты (AI-агенты + WebAssembly + Python) могут снижать барьер входа в сложные темы. Понимать планы запросов было трудно — теперь чуть легче.

Если вы работаете с SQLite в продакшене (а всё больше разработчиков делают именно это, особенно в Django и небольших веб-приложениях), умение читать EXPLAIN QUERY PLAN — один из самых ценных навыков для обеспечения производительности.

Лучший способ ускорить запрос — сначала понять, как он выполняется. EXPLAIN QUERY PLAN — ваш первый шаг к этому пониманию.