-- Обоснование индекса истории сообщений: EXPLAIN (ANALYZE, BUFFERS) на синтетических данных. -- Запуск: make explain > evidence/explain-history.txt -- (= docker compose exec -T postgres psql -U messenger -d messenger < infra/sql/explain_history.sql) -- -- Всё выполняется в одной транзакции и в конце откатывается (ROLLBACK): -- синтетические данные не остаются в базе, скрипт можно запускать сколько угодно раз. -- DROP INDEX внутри транзакции на время скрипта блокирует запись в messages — запускать на учебном стенде. \pset footer off BEGIN; -- 1 «большой» чат на 12 000 сообщений и 19 чатов по 500 (всего 21 500 сообщений): -- в таблице есть чужие сообщения, как в настоящей базе. CREATE TEMP TABLE seed_chats AS SELECT gen_random_uuid() AS chat_id, n, CASE WHEN n = 0 THEN 12000 ELSE 500 END AS size FROM generate_series(0, 19) AS n; CREATE TEMP TABLE seed_user AS SELECT gen_random_uuid() AS user_id; INSERT INTO users (id, username, display_name, password_hash) SELECT user_id, 'explain_' || substr(md5(random()::text), 1, 12), 'EXPLAIN', 'not-a-real-hash' FROM seed_user; INSERT INTO chats (id, title) SELECT chat_id, 'explain ' || n FROM seed_chats; INSERT INTO chat_members (chat_id, user_id) SELECT chat_id, user_id FROM seed_chats, seed_user; INSERT INTO messages (id, chat_id, sender_id, text, created_at) SELECT gen_random_uuid(), c.chat_id, u.user_id, 'synthetic message ' || g, timestamptz '2026-01-01 00:00:00+00' + g * interval '1 second' FROM seed_chats c, seed_user u, generate_series(1, c.size) AS g; ANALYZE messages; SELECT chat_id AS big_chat FROM seed_chats WHERE n = 0 \gset -- Курсор «середины истории»: ключ (created_at, id) 6000-го сообщения большого чата. SELECT created_at AS cur_ts, id AS cur_id FROM messages WHERE chat_id = :'big_chat' ORDER BY created_at, id OFFSET 5999 LIMIT 1 \gset \echo '=== Объём данных' SELECT count(*) AS messages_total, count(*) FILTER (WHERE chat_id = :'big_chat') AS messages_in_big_chat FROM messages; \echo '' \echo '=== Индекс истории (migrations/001_core.sql)' SELECT indexdef FROM pg_indexes WHERE indexname = 'messages_chat_history_idx'; \echo '' \echo '=== 1. Первая страница (limit=50, приложение просит 51 строку, чтобы понять, есть ли следующая)' EXPLAIN (ANALYZE, BUFFERS, COSTS OFF) SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = :'big_chat' ORDER BY created_at, id LIMIT 51; \echo '' \echo '=== 2. Страница из середины истории по keyset-курсору (после 6000-го сообщения)' EXPLAIN (ANALYZE, BUFFERS, COSTS OFF) SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = :'big_chat' AND (created_at, id) > (:'cur_ts'::timestamptz, :'cur_id'::uuid) ORDER BY created_at, id LIMIT 51; \echo '' \echo '=== 3. Для сравнения: та же страница через OFFSET (так приложение НЕ делает)' EXPLAIN (ANALYZE, BUFFERS, COSTS OFF) SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = :'big_chat' ORDER BY created_at, id OFFSET 6000 LIMIT 51; \echo '' \echo '=== 4. Для сравнения: запрос 2 без индекса (индекс удалён только внутри этой транзакции)' DROP INDEX messages_chat_history_idx; EXPLAIN (ANALYZE, BUFFERS, COSTS OFF) SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = :'big_chat' AND (created_at, id) > (:'cur_ts'::timestamptz, :'cur_id'::uuid) ORDER BY created_at, id LIMIT 51; ROLLBACK; \echo '' \echo '=== ROLLBACK: синтетические данные удалены, индекс на месте'