PostgreSQL XX001:数据损坏
PostgreSQL 读到的某个数据页未能通过完整性或校验和检查。应将其视为存储损坏:先保护好数据,再进行恢复或抢救。
- SQLSTATE
XX001- 名称
data_corrupted- 类别
- 内部错误
它的意思
XX001(data_corrupted)表示从磁盘读出的页无效:页头已损坏、校验和不匹配(在启用数据校验和的情况下),或者文件比表所需的长度要短(could not read block ... read only 0 of 8192 bytes)。消息中的文件路径(base/<database oid>/<relfilenode>)用来标识表或索引。
PostgreSQL 本身很少导致这种情况。常见原因是磁盘或控制器故障、存储谎报已刷新写入、硬件缺乏正确的写入顺序导致崩溃,或者文件在复制或恢复时出现了不一致。
常见原因
- 硬件或存储故障:磁盘、RAID 控制器、SAN 或云存储卷。
- 不遵循
fsync,接着断电或崩溃。 fsync = off或者full_page_writes = off在生产环境中。- 通过复制数据目录得到的备份,过程中没有
pg_basebackup或通过备份 API,或文件被其他软件改过。
如何修复它
-
在尝试任何修复之前,先停下来对整个数据目录做一份文件级副本,这样无论做什么都不会让情况更糟。
-
找出该文件所属的对象。
SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
-
如果它是索引,则重建它。
REINDEX INDEX CONCURRENTLY orders_pkey;
-
如果是表,请从备份或副本恢复它。作为最后手段,要抢救出仍可读取的行,
zero_damaged_pages = on会让 PostgreSQL 在你把表复制出来时跳过损坏的页(丢掉这些页里的行)。SET zero_damaged_pages = on; -- superuser, salvage only CREATE TABLE orders_salvage AS SELECT * FROM orders; RESET zero_damaged_pages;
-
检查硬件和存储日志,并在新集群上启用数据校验和(
initdb --data-checksums,或pg_checksums --enable在已停止的集群上)以便及早检测到数据损坏。
相关错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。