当主库发生宕机或计划内切换时，PostgreSQL热备库能否快速接管业务直接决定了系统可用性。热备库默认运行在只读恢复模式，持续从主库接收WAL日志并重放，此时无法接受写请求。要让备库变为主库，核心操作就是执行promote，将其从恢复模式切换到正常读写模式。本文围绕pg_ctl promo...

栏目：PostgreSQL 时间：10-06 PostgreSQL 热备库 promote命令

SP-GiST索引是PostgreSQL中容易被忽略的一类索引，它基于空间划分树实现，与常见的B-tree和GiST在结构上有本质区别。B-tree追求平衡，GiST依赖键范围聚合，而SP-GiST将数据空间递归分割为不相交的区域，每个内部节点对应一个划分函数的结果。这种设计适合处理非均匀分布的数据，例如...

栏目：PostgreSQL 时间：10-06 PostgreSQL SP-GiST索引 空间划分 查询优化

慢查询堆积、连接数飙升、缓存命中率异常，想排查却只能反复敲SQL翻系统表？PgHero 把这件麻烦事变成了打开网页就能看的仪表盘。它专门针对 PostgreSQL 设计，能展示慢查询、索引缺失、连接占用和复制延迟等关键指标。本文从零开始梳理 PgHero 的部署流程，重点介绍 Docker 方式...

栏目：PostgreSQL 时间：10-06 PgHero PostgreSQL性能监控 数据库仪表盘

针对PostgreSQL慢查询，常规的pg_stat_statements往往只能看到总耗时、调用次数和平均时间，执行计划版本、等待事件、CPU与IO时间占比等关键信息缺失。pg_stat_monitor在这套统计基础上增加了更多观察维度，包括执行计划哈希、等待事件分类、时间桶聚合、实际返回与扫描行数、...

栏目：PostgreSQL 时间：10-06 PostgreSQL慢查询优化 pg_stat_monitor 查询性能监控

设计PostgreSQL数据库结构时，直接照搬其他ORM的习惯往往会在Prisma中埋下类型不匹配和迁移冲突的隐患。Prisma schema作为独立的声明式模型层，与PostgreSQL的强类型系统既互补又存在一些需要特别留意的边界，比如定点数映射、数组字段以及枚举类型的处理方式。本文围绕Prisma...

栏目：PostgreSQL 时间：10-05 PostgreSQL Prisma 数据库Schema设计

有人把 SAVEPOINT 当成普通回滚点的别名，却在批量任务里只回滚了报错语句却丢了前面已提交的保存点状态，问题往往出在对 ROLLBACK TO SAVEPOINT 和 RELEASE SAVEPOINT 的混用上。PostgreSQL 的保存点并不是简单的语句标记，它对应一个内部子事务，有独立的事务ID、命令计数器和...

栏目：PostgreSQL 时间：10-05 PostgreSQL SAVEPOINT 事务回滚

pg_stat_activity并不是一张普通表，而是PostgreSQL统计收集器暴露的系统视图，每一行都对应一个后端进程的实时快照。数据库在运行时会持续更新这个视图，让运维人员无需开启日志或审计插件就能看到当前谁在连接、执行什么SQL、等待在哪个事件上。理解这一点后，排查连接数耗尽...

栏目：PostgreSQL 时间：10-05 pg_stat_activity PostgreSQL会话监控 实时会话查询

数据库故障通常发生在最不设防的时间点，如果没有一套可验证的备份恢复流程，再稳定的PostgreSQL也可能变成数据黑洞。本文不空谈概念，直接围绕pg_dump、pg_basebackup和WAL归档三种主流方案展开，给出cron与systemd timer的自动化调度示例，并结合恢复演练说明时间点恢复的完整步...

栏目：PostgreSQL 时间：10-05 PostgreSQL备份 自动化恢复 pg_dump

把远程数据库的密码直接写在postgres_fdw的用户映射选项里，不仅会让密码出现在系统目录中，还可能在导出DDL或备份时泄露。PostgreSQL的libpq库支持从密码文件中自动读取认证信息，postgres_fdw作为基于libpq的外部数据包装器，同样可以复用这一机制。密码文件通常位于运行Postg...

栏目：PostgreSQL 时间：10-05 postgres_fdw 密码文件 PostgreSQL

逻辑复制默认会把发布中所有表的全部行变更同步到订阅端，但实际场景里往往只需要复制部分数据。直接在线上修改发布端的表过滤条件或行过滤条件，可能引发订阅端数据不一致、初始化同步中断等问题。本文剖析逻辑复制过滤的底层机制，梳理一套无需停库的在线调整方案：利用临时发...

栏目：PostgreSQL 时间：10-05 PostgreSQL逻辑复制 复制过滤 在线变更

想把分散在多个PostgreSQL实例里的数据合并起来做分析，又不想搭建复杂的数据管道？postgres_fdw提供了一种轻量的解决思路。它通过创建外部表的方式，让本地数据库直接读写远程PostgreSQL中的表，应用层几乎感知不到跨库差异。配置过程围绕四个对象展开：安装扩展、定义外部服务器...

栏目：PostgreSQL 时间：10-04 postgres_fdw PostgreSQL 远程数据查询

PostgreSQL里想要访问另一个数据库实例中的数据，不一定要通过ETL工具或手动导出，直接建立一条到远程节点的连接通道会更轻量。dblink扩展提供的就是这种能力。它基于libpq协议建立连接，允许当前会话把SQL发送到远程库执行，再将远程结果集包装成一张本地临时表参与JOIN、聚合...

栏目：PostgreSQL 时间：10-04 dblink远程查询 PostgreSQL dblink 跨库查询

一条SQL在数据量上来后突然变慢，EXPLAIN里明晃晃的Seq Scan让人头疼。没有可用索引时PostgreSQL只能逐行读取数据页，成本随记录数线性增长。要摆脱全表扫描，首先得理解优化器为什么放弃索引：统计信息是否过期、过滤条件是否无法利用B-tree、结果集占比是否过高。接下来可以从...

栏目：PostgreSQL 时间：10-04 PostgreSQL 全表扫描 索引优化

PostgreSQL 的 ON CONFLICT 子句支持一个可选的冲突目标，不少人误以为 WHERE 条件是在冲突发生时对目标行做二次过滤。实际上，这个 WHERE 必须精确匹配某个部分唯一索引的谓词，数据库用它来识别哪一条唯一索引会捕获冲突。如果索引定义是 WHERE status = active，而 ON CONFLI...

栏目：PostgreSQL 时间：10-04 PostgreSQL ON CONFLICT 部分唯一索引

某系统需要把部分表同步到下游，但全量复制带来带宽与隐私问题。PostgreSQL 的逻辑复制提供行级和列级过滤能力，通过发布端的 WHERE 条件与列列表控制数据流。本文从发布创建、复制槽行为到订阅端参数验证，拆解过滤策略在解析、重放阶段的作用机制，并对比物理复制与逻辑复制在...

栏目：PostgreSQL 时间：10-04 PostgreSQL逻辑复制 复制过滤 发布订阅

PostgreSQL 13 发布后，wal_keep_segments 参数为什么会被 wal_keep_size 取代？如果升级了主库却仍沿用旧配置，会出现什么样的警告和风险？这一调整的核心是把 WAL 保留策略的计量单位从段数改为字节数，让配置值不再依赖 WAL 段大小。wal_keep_size 指定 pg_wal 目录中为备用服...

栏目：PostgreSQL 时间：10-04 PostgreSQL wal_keep_size wal_keep_segments

如果业务数据已经存在PostgreSQL里，想要增加向量相似度搜索能力，最直接的方案是启用pgvector扩展；但当向量规模增长到千万级，查询延迟开始上升，Faiss就会进入选型视野。PostgreSQL的优势在于事务一致性、SQL过滤和运维简单，Faiss则专为大规模向量检索设计，索引类型丰富且支持GPU...

栏目：PostgreSQL 时间：10-04 PostgreSQL FAISS 相似度搜索

PostgreSQL的DDL大多支持事务回滚，但这并不等于迁移脚本可以随意组织。Liquibase借助DATABASECHANGELOG表和锁机制记录已应用的变更集，一旦变更集设计不当，迁移中途失败就会留下半套表结构，或者在校验和变化后拒绝启动。要真正管好PostgreSQL数据库版本，需要理解changeSet声明...

栏目：PostgreSQL 时间：10-04 PostgreSQL Liquibase 数据库版本管理

打开 ignore_checksum_failure 后，PostgreSQL 在读取数据页发现校验和不匹配时不会立刻终止查询，而是继续把页面内容返回给查询层，只在日志中留下警告。这个行为在紧急捞数据时能绕过坏块，但也可能让损坏的数据静默流入业务结果。本文从校验和机制、参数配置、会话级导出和风...

栏目：PostgreSQL 时间：10-04 PostgreSQL ignore_checksum_failure 数据页校验和

PostgreSQL 报错时总会返回一个由五个字符组成的错误码，例如 23505 或 40001，这个错误码并不是随机数字，而是遵循 SQL 标准的 SQLSTATE 分类体系。它比错误消息文本更稳定，适合程序逻辑做分支判断。本文从 SQLSTATE 的结构讲起，说明如何通过 psql 命令、系统文档和客户端异常...

栏目：PostgreSQL 时间：10-04 PostgreSQL错误代码 SQLState 数据库异常处理

逻辑复制订阅在初次建立时，快照决定了哪些数据会被复制到订阅端。当发布端表结构发生变更或需要重新同步时，刷新快照成为恢复一致性的关键操作。本文围绕 PostgreSQL 中 ALTER SUBSCRIPTION REFRESH PUBLICATION 的工作机制展开，说明它与初始快照的关系、refresh 和 copy_da...

栏目：PostgreSQL 时间：10-03 PostgreSQL逻辑复制 订阅刷新快照 ALTER SUBSCRIPTION

数据库迁移到新主库时，如果已经维护着一台物理流复制备库，通常还需要在目标端重新初始化逻辑订阅，这个过程既耗时又容易产生数据不一致。pg_createsubscriber 是 PostgreSQL 提供的一个命令行工具，它能直接利用物理备库的数据目录，把现有副本转换为新主库的逻辑订阅节点。工具...

栏目：PostgreSQL 时间：10-03 PostgreSQL pg_createsubscriber 逻辑复制

认为PostgreSQL大版本升级只能靠pg_dump导出再导入，其实是一个常见误区。pg_upgrade提供了一种基于数据目录复用的原地升级方案，升级过程不需要重建索引，也不逐行重写数据，因此十几亿行的库也可能在几分钟内完成主流程。它的核心是让新版本可执行程序读取旧版本数据目录，通过...

栏目：PostgreSQL 时间：10-03 PostgreSQL版本升级 pg_upgrade 数据库迁移

PostgreSQL的WAL归档日志保存了所有数据变更，如果归档文件在推送到备份服务器时采用明文scp或rsync，敏感数据可能被网络嗅探甚至篡改。要实现归档日志加密传输，常见思路分为传输层加密和文件级加密两大类。传输层加密可以基于SSH隧道，通过专用密钥和强制算法保护WAL文件在链...

栏目：PostgreSQL 时间：10-03 PostgreSQL 归档日志 加密传输

PostgreSQL官方源码包中除了数据库核心程序，还附带一批功能扩展，它们位于源码树的contrib目录，因此习惯上称为contrib模块。像pgcrypto、hstore、tablefunc、uuid-ossp这些常用能力，并不是数据库一启动就全部加载，而是需要单独安装并注册到目标库。安装的核心命令是CREATE EXT...

栏目：PostgreSQL 时间：10-03 PostgreSQL contrib模块 CREATE EXTENSION DROP EXTENSION

模糊匹配在数据清洗、搜索纠错和客户信息去重里经常被忽略，等值查询一遇到拼写差异就返回空结果。PostgreSQL 官方扩展 fuzzystrmatch 就是为这类需求准备的，它内置了 Soundex、Difference、Levenshtein、Metaphone 和 Double Metaphone 等函数，能够从发音和编辑距离两个维...

栏目：PostgreSQL 时间：10-03 PostgreSQL fuzzystrmatch 字符串相似度

PostgreSQL中该怎样把XML文档存进表并用XPath查出来？其实依靠原生XML数据类型和几个内置函数就能完成，无需额外扩展。XML类型会校验输入数据是否符合XML规范，不符合会直接报错，这能避免脏数据入库。查询时使用xpath函数，它接受XPath 1.0表达式，返回XML值数组；再配合unnest函数和...

栏目：PostgreSQL 时间：10-03 PostgreSQL XML类型 XPath查询 XML存储

你是否在PostgreSQL项目中遇到过Eloquent关联查询意外触发N+1问题，或者迁移文件里定义的外键约束没有生效？这类问题通常和数据库方言配置、模型关系定义方式以及查询构建策略有关。本文从PostgreSQL数据库特性切入，梳理Eloquent关联模型的配置要点，包括外键约束与级联删除、h...

栏目：PostgreSQL 时间：10-03 PostgreSQL Laravel Eloquent 关联查询

PostgreSQL数据库突然无响应，应用连接全部挂起，管理员往往会直接执行pg_ctl stop -m immediate想尽快恢复服务。这个操作虽然能立即终止数据库进程，但它跳过了事务回滚和检查点，本质上等同于一次系统崩溃。pg_ctl stop提供了smart、fast和immediate三种关闭模式，其中immediate...

栏目：PostgreSQL 时间：10-02 pg_ctl stop PostgreSQL 强制关闭

默认安装的PostgreSQL并不等于安全。不少团队完成部署后直接使用默认配置，忽略了认证方式、网络暴露面、日志审计等关键环节，导致数据库在公网环境下面临暴力破解、数据明文传输和越权访问等风险。系统性的安全增强需要从多个层面入手：首先收紧访问控制，强制使用强密码和基于...

栏目：PostgreSQL 时间：10-02 PostgreSQL安全 数据库加固 访问控制