Добавить скрипты EXPLAIN и проверки SIGTERM

This commit is contained in:
2026-10-08 18:54:35 +03:00
parent ef24bc1635
commit 6473fd06e9
4 changed files with 150 additions and 0 deletions
+11
View File
@@ -0,0 +1,11 @@
#!/bin/sh
# Наполняет БД синтетической историей и печатает планы запросов пагинации.
set -eu
cd "$(dirname "$0")/.."
run_sql() {
docker compose --env-file .env exec -T postgres psql -U messenger -d messenger -v ON_ERROR_STOP=1 -q
}
run_sql < scripts/seed_history.sql
run_sql < scripts/explain_history.sql
+44
View File
@@ -0,0 +1,44 @@
\set chat '00000000-0000-4000-8000-000000000100'
\pset pager off
\echo '== Объём данных'
SELECT count(*) AS messages_total,
count(*) FILTER (WHERE chat_id = :'chat') AS messages_in_chat,
pg_size_pretty(pg_relation_size('messages')) AS table_size,
pg_size_pretty(pg_relation_size('messages_chat_history_idx')) AS index_size
FROM messages;
\echo
\echo '== 1. Первая страница (limit 50, запрос берёт 51 строку)'
EXPLAIN (ANALYZE, BUFFERS)
SELECT id, chat_id, sender_id, text, created_at FROM messages
WHERE chat_id = :'chat'
ORDER BY created_at, id LIMIT 51;
-- cursor на 5000-е сообщение чата, как его получил бы клиент после 100 страниц
SELECT created_at AS after_time, id AS after_id FROM messages
WHERE chat_id = :'chat' ORDER BY created_at, id OFFSET 4999 LIMIT 1 \gset
\echo
\echo '== 2. Страница из середины истории: keyset после 5000-го сообщения'
EXPLAIN (ANALYZE, BUFFERS)
SELECT id, chat_id, sender_id, text, created_at FROM messages
WHERE chat_id = :'chat' AND (created_at, id) > (:'after_time', :'after_id')
ORDER BY created_at, id LIMIT 51;
\echo
\echo '== 3. Та же страница через OFFSET (так делать не стали)'
EXPLAIN (ANALYZE, BUFFERS)
SELECT id, chat_id, sender_id, text, created_at FROM messages
WHERE chat_id = :'chat'
ORDER BY created_at, id OFFSET 5000 LIMIT 51;
\echo
\echo '== 4. Запрос из пункта 2 без индекса messages_chat_history_idx (DROP INDEX внутри транзакции с ROLLBACK)'
BEGIN;
DROP INDEX messages_chat_history_idx;
EXPLAIN (ANALYZE, BUFFERS)
SELECT id, chat_id, sender_id, text, created_at FROM messages
WHERE chat_id = :'chat' AND (created_at, id) > (:'after_time', :'after_id')
ORDER BY created_at, id LIMIT 51;
ROLLBACK;
+26
View File
@@ -0,0 +1,26 @@
-- Синтетические данные для EXPLAIN: 21 чат и 60 000 сообщений, из них 10 000 в исследуемом чате.
-- Повторный запуск ничего не добавляет. Войти под этим пользователем нельзя: вместо hash стоит заглушка.
INSERT INTO users (id, username, display_name, password_hash)
VALUES ('00000000-0000-4000-8000-000000000001', 'explain_seed', 'Данные для EXPLAIN', '!')
ON CONFLICT DO NOTHING;
INSERT INTO chats (id, title)
SELECT ('00000000-0000-4000-8000-0000000001' || lpad(n::text, 2, '0'))::uuid, 'EXPLAIN чат ' || n
FROM generate_series(0, 20) AS n
ON CONFLICT DO NOTHING;
INSERT INTO chat_members (chat_id, user_id, position)
SELECT id, '00000000-0000-4000-8000-000000000001', 0 FROM chats WHERE title LIKE 'EXPLAIN чат %'
ON CONFLICT DO NOTHING;
-- чат 00: 10 000 сообщений; чаты 01..20: по 2 500. Время идёт с шагом в секунду и перемешано между чатами.
INSERT INTO messages (chat_id, sender_id, text, created_at)
SELECT ('00000000-0000-4000-8000-0000000001' || lpad((CASE WHEN n % 6 = 0 THEN 0 ELSE 1 + n % 20 END)::text, 2, '0'))::uuid,
'00000000-0000-4000-8000-000000000001',
'сообщение ' || n,
now() - make_interval(secs => 60000 - n)
FROM generate_series(1, 60000) AS n
WHERE NOT EXISTS (SELECT 1 FROM messages WHERE chat_id = '00000000-0000-4000-8000-000000000100');
ANALYZE messages;
+69
View File
@@ -0,0 +1,69 @@
#!/usr/bin/env python3
"""Проверка SIGTERM (перенесена из lab1): начатый запрос завершается, новые не принимаются, выход быстрее 10 секунд."""
import json
import socket
import subprocess
import sys
import time
import urllib.parse
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / "student-tests"))
from api import BASE_URL, call, new_chat, new_user
LIMIT_SECONDS = 10
def main():
container = subprocess.run(
["docker", "compose", "--env-file", ".env", "ps", "-q", "api"],
cwd=ROOT, check=True, capture_output=True, text=True,
).stdout.strip()
address = urllib.parse.urlsplit(BASE_URL)
user = new_user("sigterm")
chat = new_chat(user)
# отправляем заголовки и только половину тела: запрос уже начат, но ещё не закончен
body = json.dumps({"text": "сообщение, отправленное во время остановки"}).encode()
head = (
"POST /api/v1/chats/%s/messages HTTP/1.1\r\n"
"Host: %s\r\nContent-Type: application/json\r\nContent-Length: %d\r\nAuthorization: Bearer %s\r\n\r\n"
% (chat["id"], address.netloc, len(body), user["token"])
).encode()
connection = socket.create_connection((address.hostname, address.port), timeout=LIMIT_SECONDS)
connection.sendall(head + body[:10])
time.sleep(0.3)
print("$ docker kill --signal=SIGTERM <контейнер api>")
started = time.monotonic()
subprocess.run(["docker", "kill", "--signal=SIGTERM", container], check=True, stdout=subprocess.DEVNULL)
time.sleep(1)
try:
status = call("GET", "/health/live")[0]
print("новый запрос после SIGTERM: принят, статус", status)
accepted = True
except OSError as error:
print("новый запрос после SIGTERM: не принят (%s)" % type(error).__name__)
accepted = False
connection.sendall(body[10:])
status_line = connection.recv(65536).split(b"\r\n")[0].decode()
connection.close()
print("начатый до SIGTERM запрос:", status_line)
exit_code = subprocess.run(["docker", "wait", container], check=True, capture_output=True, text=True).stdout.strip()
elapsed = time.monotonic() - started
print("процесс завершился за %.2f с, код выхода %s" % (elapsed, exit_code))
# контейнер, остановленный через docker kill, сам не перезапускается: поднимаем его обратно
subprocess.run(["docker", "start", container], check=True, stdout=subprocess.DEVNULL)
if accepted or " 201 " not in status_line or elapsed > LIMIT_SECONDS or exit_code != "0":
raise SystemExit("FAIL")
print("PASS: остановка корректная и укладывается в %d секунд" % LIMIT_SECONDS)
if __name__ == "__main__":
main()