KingbaseES 事务 ID wraparound 告警排查笔记

适用于 KingbaseES 数据库在遇到表接近事务 ID wraparound 的告警时的处理与分析：

---

📌 KingbaseES 事务 ID wraparound 告警排查笔记

🧾 原始告警信息

数据库实例 dbnode01 (10.1.1.100:5433) 中的数据库 bizdb 的表 analytics.tbl_index_metrics 距离 wraparound 回收的事务 ID 不足 20000000，当前剩余为 0。

---

🔍 排查指南

---

✅ 1. 表名或 schema 是否存在拼写/大小写问题

PostgreSQL/KingbaseES 默认将未加双引号的标识符转换为小写，需确保表名及 schema 是否拼写正确。

🔎 查看所有 schema：

SELECT schema_name 
FROM information_schema.schemata;

🔎 查看目标 schema 下所有表：

SELECT tablename 
FROM pg_tables 
WHERE schemaname = 'analytics';

🔎 模糊搜索目标表：

SELECT schemaname, tablename 
FROM pg_tables 
WHERE tablename ILIKE '%index_metrics%';

---

✅ 2. 判断是否为视图或物化视图

🔎 查找视图：

SELECT schemaname, viewname 
FROM pg_views 
WHERE schemaname = 'analytics' 
  AND viewname ILIKE '%index_metrics%';

🔎 查找所有对象类型：

SELECT 
    n.nspname AS schema_name,
    c.relname AS object_name,
    c.relkind AS type  -- r=table, v=view, m=materialized view
FROM 
    pg_class c
JOIN 
    pg_namespace n ON c.relnamespace = n.oid
WHERE 
    n.nspname = 'analytics'
  AND c.relname ILIKE '%index_metrics%';

---

✅ 3. 可能为历史表或已删除对象

若表无法找到，可能由于以下原因：

• 表曾经存在但已被删除；
• 第三方监控系统缓存了旧对象信息；
• 数据库或表对象近期重建，监控未同步更新。

建议与监控平台对接人员确认告警来源和数据刷新策略。

---

✅ 4. 核实连接的实例是否正确

请确认你当前连接的数据库实例是否为告警中指定的：

目标实例：dbnode01 (10.1.1.100:5433)

若不是，可使用以下命令重新连接：

psql -h 10.1.1.100 -p 5433 -U your_user -d bizdb

---

🧪 快速排查脚本：查找高事务 ID 年龄的表

SELECT 
    n.nspname AS schema,
    c.relname AS table,
    age(c.relfrozenxid) AS xid_age,
    current_setting('autovacuum_freeze_max_age')::int AS freeze_max_age
FROM 
    pg_class c
JOIN 
    pg_namespace n ON c.relnamespace = n.oid
WHERE 
    c.relkind = 'r'
ORDER BY 
    age(c.relfrozenxid) DESC
LIMIT 20;

---

✅ 建议与维护策略

• 对事务 ID 年龄高的表及时执行 VACUUM FREEZE；
• 定期巡检并生成事务 ID 报表；
• 检查并调优 autovacuum 参数配置；
• 确保监控平台过滤已删除表的历史告警；
• 所有操作建议在主节点上进行，以确保有效性。

---

如需自动化脚本、告警 SQL 模板或 PDF 导出版本，请告诉我，我可以立即为你生成。