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

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

设计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 事务回滚

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

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

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

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

一条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 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 数据页校验和

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

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

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

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

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

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

在PostgreSQL中查询JSON数组并筛选特定键值，SQL该如何组织才能既清晰又高效？业务表常常把明细数据以JSON数组形式存在一个字段中，查询时需要拆开数组、定位到具体键再过滤，稍不注意就会写出全表扫描或者类型错误的语句。jsonb类型提供的jsonb_array_elements函数可以把数组拆...

栏目：Java 时间：10-03 PostgreSQL JSON数组 jsonb_array_elements

你是否在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 强制关闭

用字符串拼接SQL操作PostgreSQL，列名写错或类型不匹配往往要等到运行时甚至上线后才暴露。Quill 提供了一种基于 Scala 宏的编译时查询方案，能把数据库表映射成强类型对象，在编译阶段检查字段、类型和查询结构。本文围绕 PostgreSQL 与 Quill 的集成，说明 quoted DSL 如何生...

栏目：PostgreSQL 时间：10-02 PostgreSQL Quill 编译时查询

想存储温度区间、价格区间或者时间窗口，又希望SQL查询能直接判断值是否落在区间内，PostgreSQL的范围类型提供了一套完整的解决方案。除了内置的int4range、tsrange等类型，CREATE TYPE命令还能基于任意标量类型创建符合业务语义的自定义范围类型。本文将解析CREATE TYPE AS R...

栏目：PostgreSQL 时间：10-01 PostgreSQL CREATE TYPE 范围类型

XML数据在PostgreSQL中经常需要先验证格式合法性，xml_is_well_formed函数就是用于此场景的轻量级工具。该函数接收一个文本参数，返回布尔值，用于判断字符串是否为格式良好的XML文档或片段。与直接转换xml类型不同，它不会抛出异常，而是通过true或false给出结果，适合在WHERE子句...

栏目：XML/XSL 时间：10-01 PostgreSQL xml_is_well_formed XML格式校验

数据库相关单元测试最棘手的地方在于数据状态难以彻底清理，PostgreSQL 与 MikroORM 组合也不例外。测试用例一旦共享同一张表，前一个用例写入的脏数据就可能让后一个用例意外失败，甚至出现本地通过、CI 环境报错的不稳定现象。本文围绕 MikroORM 的 EntityManager、SchemaGe...

栏目：PostgreSQL 时间：09-30 PostgreSQL MikroORM 单元测试

Spring Cloud微服务接入PostgreSQL后，连接池耗尽、事务不生效或配置刷新后数据源不更新这类问题经常出现。这些现象通常不是数据库本身导致的，而是数据源装配方式与微服务环境没有对齐。本文从HikariCP基础参数讲起，分别演示application.yml与Java Config两种配置路径，再结合...

栏目：PostgreSQL 时间：09-30 PostgreSQL Spring Cloud 数据源配置

一条UPDATE语句在PostgreSQL里并不会直接修改原行，而是把旧行标记为删除，再插入一个新的行版本。事务ID没变的情况下，系统靠什么区分同一事务内先后产生的多个行版本？答案就是cmin和cmax这两个命令标识符。cmin表示插入该行版本时事务内部执行到第几条命令，cmax表示删除该行版...

栏目：PostgreSQL 时间：09-30 PostgreSQL cmin cmax

一条包含ORDER BY和GROUP BY的查询，可能让PostgreSQL在数据量增大后突然报出内存不足错误，甚至拖垮整个实例。问题的根源通常不是SQL写错，而是排序或哈希聚合所需的内存超过了work_mem参数的默认限制。当操作无法在内存中完成时，PostgreSQL会转而使用磁盘临时文件，但即便如此，...

栏目：PostgreSQL 时间：09-30 PostgreSQL 排序内存溢出 work_mem

在PostgreSQL中处理复杂数值计算时，仅靠SQL往往难以满足需求，尤其涉及矩阵运算、线性代数或大规模数组处理。PL/Python为数据库端引入Python生态提供了桥梁，而NumPy作为高性能数值计算库，能显著提升计算效率。但许多人并不清楚如何正确地在PL/Python函数中加载NumPy，也不了解...

栏目：PostgreSQL 时间：09-30 PLPython NumPy PostgreSQL