Postgres+Citus列存表读取及Vacuum报错求助：stripe未刷新等问题

问题背景 #

环境：PostgreSQL 14.2 + Citus 11.0-1
针对列存表daily_p2022_10_11出现以下异常：

• 告警日志报错：

ERROR: attempted to read an unexpected stripe while reading columnar table daily_p2022_10_11, stripe with id=281134 is not flushed.

• 执行VACUUM操作失败：

ccap_proddb=> vacuum verbose daily_p2022_10_11;
ERROR:  invalid columnar chunk entry
DETAIL:  Chunk number out of range: 0

• 无法执行基础查询：SELECT count(*) FROM daily_p2022_10_11;

解决步骤 #

1. 修复列存表元数据 #

Citus列存表的元数据损坏可能导致stripe和chunk关联异常，优先尝试元数据修复命令：

SELECT columnar_restore_table('daily_p2022_10_11');

执行完成后，重新尝试VACUUM verbose daily_p2022_10_11;和查询操作，验证是否恢复正常。

2. 手动刷写未完成的Stripe #

如果元数据修复无效，定位并强制刷写未刷写的stripe：

-- 查询目标表的所有stripe状态
SELECT stripe_id, status FROM columnar.stripe WHERE table_name = 'daily_p2022_10_11';

找到状态为unflushed的stripe（即ID=281134），执行刷写：

SELECT columnar_flush_stripe('daily_p2022_10_11', 281134);

刷写完成后再次执行VACUUM清理无效chunk。

3. 备份重建表（终极方案） #

若上述方法均无效，通过备份有效数据重建表：

1. 导出表结构与可访问数据：

-- 导出表结构
COPY (SELECT * FROM daily_p2022_10_11 LIMIT 0) TO '/tmp/daily_p2022_10_11_schema.sql';
-- 尝试导出全量数据（若部分数据可访问）
COPY (SELECT * FROM daily_p2022_10_11) TO '/tmp/daily_p2022_10_11_data.csv';

2. 创建新的列存表：

CREATE TABLE daily_p2022_10_11_new (LIKE daily_p2022_10_11 INCLUDING ALL) USING columnar;

3. 导入数据并替换原表：

COPY daily_p2022_10_11_new FROM '/tmp/daily_p2022_10_11_data.csv';
ALTER TABLE daily_p2022_10_11 RENAME TO daily_p2022_10_11_old;
ALTER TABLE daily_p2022_10_11_new RENAME TO daily_p2022_10_11;

4. 版本升级建议 #

Citus 11.0-1存在列存表的已知稳定性问题，升级至Citus 11.1及以上版本可修复此类元数据与stripe管理的bug，同时确保PostgreSQL版本与Citus版本兼容。

内容的提问来源于stack exchange，提问作者user2873848