Files
mtusi2026lab2/openspec/changes/track2-query-plans/proposal.md
T
2026-10-02 04:24:59 +03:00

7.0 KiB
Raw Blame History

Proposal

Why

Трек «5» №2 (README.md) требует исследовать ≥100 000 сообщений с неравномерными размерами чатов, сравнить ≥2 индекса или запроса и стоимость записи. Сейчас стенд make bench (change bench-postgres) наполняет один большой чат: селективность chat_id около 100%, и REPORT.md прямо называет это ограничением. План снимается только для текущего индекса и для варианта «без индекса», а стоимость записи по вариантам индекса не меряется. Generic plan prepared statement тоже не проверялся.

Пробный запуск на закреплённом образе Postgres (200k строк, один большой чат и 1000 маленьких) показал, что выбор не очевиден:

  • условие курсора, записанное через OR, читает весь чат до курсора: 2 634 буфера вместо ~50 у сравнения кортежей;
  • покрывающий индекс INCLUDE (sender_id, text) в 2,7 раза больше текущего;
  • сообщение длиной 4000 символов, которое контракт разрешает, при покрывающем индексе не вставляется: index row requires 12072 bytes.

What Changes

  • Неравномерные чаты. В стенде, кроме читаемого чата из N сообщений и чата записи, есть фоновые чаты трёх уровней. Их состав задаёт профиль: в full 10 чатов по 5 000, 100 по 400 и 1 000 по 10 сообщений, всего 100 000. Сообщения всех чатов перемешаны во времени отправки, как в живом мессенджере. В таблице на каждом размере ≥110 000 сообщений. Распределение по чатам после наполнения проверяется.
  • Планы по уровням чатов. Этап плана снимает auto_explain запроса приложения не только для читаемого чата. Для одного чата каждого уровня тоже: первая, средняя и последняя полная страница, у маленького — первая.
  • Сравнение вариантов. Для средней страницы каждого уровня (у маленького чата — первой) тот же запрос с теми же параметрами выполняется в psql в транзакции, которая откатывается:
    • текущий индекс (chat_id, created_at, id), custom и generic plan;
    • условие курсора через OR вместо сравнения кортежей;
    • варианты индекса из профиля: только (chat_id) и покрывающий (chat_id, created_at, id) INCLUDE (sender_id, text);
    • без индекса.
  • Стоимость записи по вариантам. В конце каждого размера, после прогонов, для каждого варианта индекса в откатываемой транзакции:
    • размер индекса и байты на сообщение;
    • время и WAL вставки порции сообщений во все чаты: медиана трёх повторов;
    • проверка, что сообщение максимальной длины по контракту вставляется.
  • Сводка и отчёт. В summary.md — планы по уровням и вариантам, таблица стоимости записи. В REPORT.md — трек 2, часть «план запроса»:
    • гипотезы, записанные до полной матрицы;
    • методика, результаты метки track2 и решение по индексу;
    • ограничения.
  • Методика меняется. Метки до этого change (baseline) со следующими не сравниваются, make bench_compare откажет по профилю. baseline остаётся доказательством уровня 4 со своей методикой.

Capabilities

New Capabilities

Нет.

Modified Capabilities

  • load-benchmark:
    • изменённые требования:
      • матрица: фоновые чаты неравномерных размеров и проверка их распределения;
      • план запроса истории: страницы по уровням чатов, сравнение индексов, формы запроса и generic plan;
      • сохранение результатов: планы по вариантам и стоимость записи в сводке;
    • новые требования:
      • стоимость записи по вариантам индекса;
      • исследование индексов в отчёте.

Impact

  • Код стенда:
    • bench/run.py: профиль с уровнями чатов и вариантами индекса, расписание наполнения, проверка распределения, этап плана по уровням, сравнение вариантов, замер стоимости записи, сводка;
    • bench/k6/: prepare.js (фоновые чаты), prefill.js (расписание по чатам), explain.js (список страниц из файла), новый plan_cursors.js;
    • bench/compare.py не меняется: новые поля профиля и так входят в методику.
  • Код приложения (src/), миграции, контракт, тесты не меняются. Индекс приложения меняется, только если исследование покажет вариант лучше без нарушения контракта. По пробе такого нет, и это решается по результатам, а не заранее.
  • Документация: .claude/rules/bench.md (что не меняется между метками, граница чёрного ящика), AGENTS.md, REPORT.md.
  • Доказательства: evidence/bench/track2/.
  • Время хоста: полная матрица ~35 минут вместо ~27: +100 000 сообщений наполнения на размер, сравнение вариантов и стоимость записи.