dev 与 main 从 294c6cd 分叉后,各自新增了一个 0040 迁移(都从 20261002_0039 起链):
- main:20261003_0040 douyu_tasks.account_assigned_to(生产已应用)
- dev: 20261002_0040 account_events(未上生产)
两者合并即两个 alembic head,upgrade head 会直接失败。因为账号事件迁移从未被生产库
应用过,改号是安全的:
1. account_events 迁移改名为 20261003_0041,down_revision 指向 20261003_0040;
2. tests/test_migrations.py 的 HEAD_REVISION 同步改 20261003_0041;
3. 迁移保持幂等,本机开发库(alembic_version 已是 20261003_0040、account_events 表已存在)
实跑 upgrade 通过,仅推进版本号、数据未动;
4. 顺带修正规划/解耦设计里「下一个迁移编号」的过期取值(现为 20261003_0042)。
排查报告去重:两个会话各自写了一份《生产服务器高负载排查…》报告,内容重叠且互相矛盾
(一处写 8 核/16GB,另一处有 nproc 原始输出为 4 vCPU/7.1GiB)。合并为单一文档
docs/生产服务器高负载排查与优化报告.md,以带原始命令输出的事实为准,删除重复的那份,
并修正引用它的迁移方案文档。
118 lines
5.2 KiB
Python
118 lines
5.2 KiB
Python
"""账号事件流表,以及审计日志的账号关联列。
|
||
|
||
## 为什么需要 account_events
|
||
|
||
`accounts` 存的是**账号当前状态**(积分、余额、开通标记…),这些字段都是覆盖式更新 ——
|
||
「什么时候变成这样」没有任何记录。而账号相关的操作散在 `douyu_tasks`(22 万行 / 687MB,
|
||
掺着大量例行轮询),既不能直接给用户看,也不适合当历史长期保留。
|
||
|
||
于是把「发生过什么」独立成一张 append-only 的事件表:`accounts` 是状态,`account_events`
|
||
是流水。账号详情页 = 状态卡 + 事件时间线。
|
||
|
||
**不做历史回填**(2026-10-03 已定):事件从上线起往后累积,既有历史仍去各自的页面查。
|
||
|
||
## 为什么审计日志要加 account_id
|
||
|
||
实测 `audit_logs.target` 是自由文本(`冰柳192` / `导入103个` / `douyu_batch:xxx` 混着),
|
||
无法可靠关联到账号,导致「谁什么时候分配/改标签/删除了这个账号」进不了账号时间线。
|
||
加一列可空的 account_id,账号相关操作写入时带上即可(旧记录保持 NULL)。
|
||
|
||
## 编号为什么是 0041 而不是 0040
|
||
|
||
本迁移最初取号 `20261002_0040`(`down_revision` = `20261002_0039`)。开发期间生产上并发落地了
|
||
索引优化 `20261003_0040`,它同样从 `20261002_0039` 起链 —— 两边一合并就是**两个 alembic head**,
|
||
`upgrade head` 会直接报 `Multiple head revisions are present`。
|
||
|
||
因为本迁移**从未被生产库应用过**(`dev` 未部署),改号是安全的:接在 `20261003_0040` 之后成为
|
||
`20261003_0041`。升级脚本写成幂等的(`sa.inspect` 先查存在),所以对已手工建过表的本地库
|
||
重跑也只会空过并把版本号推进,不会重复建表。
|
||
"""
|
||
|
||
from collections.abc import Sequence
|
||
|
||
import sqlalchemy as sa
|
||
from alembic import op
|
||
|
||
revision: str = "20261003_0041"
|
||
down_revision: str | None = "20261003_0040"
|
||
branch_labels: str | Sequence[str] | None = None
|
||
depends_on: str | Sequence[str] | None = None
|
||
|
||
|
||
def _tables(bind) -> set[str]:
|
||
return set(sa.inspect(bind).get_table_names())
|
||
|
||
|
||
def _columns(bind, table: str) -> set[str]:
|
||
return {item["name"] for item in sa.inspect(bind).get_columns(table)}
|
||
|
||
|
||
def upgrade() -> None:
|
||
bind = op.get_bind()
|
||
|
||
if "account_events" not in _tables(bind):
|
||
op.create_table(
|
||
"account_events",
|
||
sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True),
|
||
sa.Column(
|
||
"account_id",
|
||
sa.Integer(),
|
||
sa.ForeignKey("accounts.id"),
|
||
nullable=False,
|
||
),
|
||
# import / login_ok / ck_invalid / relogin_ok / relogin_failed /
|
||
# bind_ok / recharge / exchange / points_credit /
|
||
# elite_opened / esports_opened / assigned / tag_changed ...
|
||
sa.Column("event_type", sa.String(length=32), nullable=False),
|
||
sa.Column("occurred_at", sa.DateTime(), nullable=False),
|
||
# 直接可展示的一句话,避免前端再各自拼文案
|
||
sa.Column(
|
||
"title", sa.String(length=256), nullable=False, server_default=""
|
||
),
|
||
# 变动量(充值/消耗/到账,有符号)与变动后余额
|
||
sa.Column("amount", sa.Integer(), nullable=True),
|
||
sa.Column("balance_after", sa.Integer(), nullable=True),
|
||
# 精简细节(不是原始大 JSON),便于排障与以后扩展
|
||
sa.Column("detail", sa.JSON(), nullable=True),
|
||
# 来源:login / task / audit / manual
|
||
sa.Column(
|
||
"source", sa.String(length=24), nullable=False, server_default=""
|
||
),
|
||
# 幂等键:如 douyu_task:123456、login_task:14166、audit:789。
|
||
# 收集器重跑、事件重复发射都靠它兜住,漏了会造出重复时间线。
|
||
# **可空且唯一**:MySQL 的唯一索引允许多个 NULL,所以「没有幂等键」的事件
|
||
# (如手工记录)存 NULL;不能用空串 —— 空串会互相冲突,第二条就插不进去。
|
||
sa.Column("source_ref", sa.String(length=96), nullable=True),
|
||
sa.Column("created_at", sa.DateTime(), nullable=False),
|
||
)
|
||
op.create_index(
|
||
"ix_account_events_account_occurred",
|
||
"account_events",
|
||
["account_id", "occurred_at"],
|
||
)
|
||
op.create_index(
|
||
"ix_account_events_event_type", "account_events", ["event_type"]
|
||
)
|
||
op.create_index(
|
||
"ix_account_events_source_ref",
|
||
"account_events",
|
||
["source_ref"],
|
||
unique=True,
|
||
)
|
||
|
||
if "account_id" not in _columns(bind, "audit_logs"):
|
||
op.add_column(
|
||
"audit_logs",
|
||
sa.Column("account_id", sa.Integer(), nullable=True),
|
||
)
|
||
op.create_index("ix_audit_logs_account_id", "audit_logs", ["account_id"])
|
||
|
||
|
||
def downgrade() -> None:
|
||
bind = op.get_bind()
|
||
if "account_id" in _columns(bind, "audit_logs"):
|
||
op.drop_column("audit_logs", "account_id")
|
||
if "account_events" in _tables(bind):
|
||
# 删表会一并删掉索引
|
||
op.drop_table("account_events")
|