7.0 KiB
7.0 KiB
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
сообщений и чата записи, есть фоновые чаты трёх уровней. Их состав
задаёт профиль: в
full10 чатов по 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 сообщений наполнения на размер, сравнение вариантов и стоимость записи.