From 6473fd06e99452a219aafaf96645a5cf95b80522 Mon Sep 17 00:00:00 2001 From: Khamid Date: Thu, 8 Oct 2026 18:54:35 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20=D1=81=D0=BA=D1=80=D0=B8=D0=BF=D1=82=D1=8B=20EXPLAIN?= =?UTF-8?q?=20=D0=B8=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA=D0=B8=20?= =?UTF-8?q?SIGTERM?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/explain_history.sh | 11 ++++++ scripts/explain_history.sql | 44 +++++++++++++++++++++++ scripts/seed_history.sql | 26 ++++++++++++++ scripts/sigterm_check.py | 69 +++++++++++++++++++++++++++++++++++++ 4 files changed, 150 insertions(+) create mode 100755 scripts/explain_history.sh create mode 100644 scripts/explain_history.sql create mode 100644 scripts/seed_history.sql create mode 100644 scripts/sigterm_check.py diff --git a/scripts/explain_history.sh b/scripts/explain_history.sh new file mode 100755 index 0000000..371e03e --- /dev/null +++ b/scripts/explain_history.sh @@ -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 diff --git a/scripts/explain_history.sql b/scripts/explain_history.sql new file mode 100644 index 0000000..88d6444 --- /dev/null +++ b/scripts/explain_history.sql @@ -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; diff --git a/scripts/seed_history.sql b/scripts/seed_history.sql new file mode 100644 index 0000000..38bf2eb --- /dev/null +++ b/scripts/seed_history.sql @@ -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; diff --git a/scripts/sigterm_check.py b/scripts/sigterm_check.py new file mode 100644 index 0000000..64e312b --- /dev/null +++ b/scripts/sigterm_check.py @@ -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()