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

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

线上一个数据同步任务突然从分钟级拖到小时级，同样的SQL在psql里执行很快，通过JDBC游标读取却慢得离谱。排查执行计划后发现，优化器选择了索引扫描加大量回表操作，而实际业务会完整遍历结果集。这个问题根子在于PostgreSQL的cursor_tuple_fraction参数，它的默认值0.1让优化器...

栏目：PostgreSQL 时间：10-02 PostgreSQL慢查询优化 cursor_tuple_fraction 游标优化

备份文件能正常列出并不代表它们一定能用于恢复。pgBackRest 的 verify 命令会在恢复前重新计算每个文件的校验和，并与备份清单中的记录逐项比对，从而发现存储介质静默损坏、网络传输截断或人为误删造成的备份缺陷。不少数据库管理员只关注备份是否成功，却忽略了校验这一关...

栏目：PostgreSQL 时间：10-02 pgBackRest 备份校验 PostgreSQL备份修复

PostgreSQL 在处理半结构化数据时，把 JSON 与 JSONB 设计成两条不同路径，背后不是简单的新旧版本关系，而是存储与查询的权衡。JSON 类型保留原始文本，写入成本低，但每次读取都要解析；JSONB 在写入阶段就把 JSON 解析成二进制格式，去掉重复键、空白和原始顺序，换来更高的查询和索...

栏目：PostgreSQL 时间：10-02 PostgreSQL JSON JSONB JSON 数据类型

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

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

一条看似简单的SELECT语句，在PostgreSQL日志里却频繁超过阈值，定位之后发现总是集中在几张被反复读取的业务表上。热点数据访问过于密集，不仅拖慢单次查询，还会把连接池和缓冲池的争抢放大成全局性能问题。本文从识别热点数据的方法入手，结合pg_stat_statements和pg_buffercac...

栏目：PostgreSQL 时间：10-01 PostgreSQL慢查询 缓存热点数据 查询优化

PostgreSQL的复合类型允许把多个基础列打包成一个逻辑单元，功能上类似C语言的结构体或面向对象语言中的简单对象。创建复合类型的核心命令是CREATE TYPE，接着定义字段名和数据类型，该类型可以被表、函数、数组反复引用。访问复合类型字段时必须写成(composite_value).field_...

栏目：PostgreSQL 时间：10-01 PostgreSQL复合类型 字段访问 CREATE TYPE

在搭建PostgreSQL逻辑复制时，序列值不同步是一个容易被忽略的坑。主库通过serial自增列写入数据后，订阅端虽然能收到对应行，但序列的last_value仍停留在初始状态，等切换或写入时容易出现主键冲突。本文围绕逻辑复制中序列对象的处理机制展开，说明为什么发布和订阅不会自动同步...

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

连接PostgreSQL时经常遇到无法解析URI、密码特殊字符报错、多主机切换不生效等问题，根源往往是对URI语法和编码规则理解不够。PostgreSQL连接串URI由scheme、用户信息、主机端口、数据库名和查询参数五部分组成，其中百分号编码和查询参数分隔符最容易被忽略。例如密码中的@...

栏目：PostgreSQL 时间：10-01 PostgreSQL连接字符串 数据库URI 连接参数

PostgreSQL 里正则匹配最容易出错的并不是语法，而是对返回类型、替换次数和转义规则的理解偏差。regexp_match 和 regexp_matches 只差一个字母，前者返回单个数组，后者返回多行结果；regexp_replace 不加 g 参数时只会替换第一次匹配。这篇文章覆盖匹配操作符、提取函数、替换...

栏目：PostgreSQL 时间：10-01 PostgreSQL正则表达式 REGEXP_REPLACE regexp_matches

数据库相关单元测试最棘手的地方在于数据状态难以彻底清理，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

PostgreSQL的事件触发器运行在DDL命令前后，与普通行级触发器不同，它关注的是CREATE、ALTER、DROP等结构性变更。事件触发器由触发器函数和触发器声明两部分组成，能在sql_drop、ddl_command_start、ddl_command_end、table_rewrite等事件点上执行逻辑。借助事件触发器可以记...

栏目：PostgreSQL 时间：09-30 PostgreSQL事件触发器 DDL审计 数据库触发器

PostgreSQL 数据量上来后，备份时间很容易从分钟级滑到小时级，如果还原还需要更久，RTO 就顶不住。pgBackRest 的并行能力不是简单调高 process-max 就行，它涉及文件压缩、校验、WAL 归档和仓库布局的协同。本文从并行备份的执行流程入手，说明多进程如何在 full、incremental、d...

栏目：PostgreSQL 时间：09-30 pgBackRest PostgreSQL备份 并行还原

发布端已经创建成功，订阅端却始终无法建立复制连接，或者初始数据同步后增量没有正常应用，这类问题在PostgreSQL逻辑复制的实施中并不少见。逻辑复制依赖发布和订阅两个核心对象：发布节点把指定表的变更写入逻辑日志，订阅节点通过复制槽消费这些变更，两端使用流复制协议保持连接...

栏目：PostgreSQL 时间：09-30 PostgreSQL逻辑复制 发布订阅 节点添加

一条包含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

在PostgreSQL数据库中，删除操作并不是简单地执行一条SQL那么简单，其背后的机制直接影响数据安全和性能。删除数据看似容易，一条DELETE语句就能完成，但其中隐藏着不少容易踩坑的细节。误删整张表、忘记写WHERE条件、忽略外键约束和触发器、删除后磁盘空间不释放……这些问题轻...

栏目：PostgreSQL 时间：09-29 PostgreSQL 删除数据 数据库

发布一张父表后，为什么订阅端只能同步父表自身的行，子表里的数据却完全没被复制？这个问题在接触传统继承表的场景里经常被忽略。PostgreSQL 的逻辑复制并不会因为表之间存在 INHERITS 关系就自动扩展发布范围，发布父表只会精确选中该 OID 对应的物理表；而声明式分区表在 Postg...

栏目：PostgreSQL 时间：09-29 PostgreSQL 逻辑复制 继承表

业务报表需要同时展示每个销售人员的业绩排名、部门内累计占比和环比增长，过去往往要靠自连接、临时表或多条SQL拼接。PostgreSQL的窗口函数直接在一个查询里完成这类任务。本文通过实际表结构和数据，演示ROW_NUMBER、RANK、DENSE_RANK在并列名次上的差异，说明SUM OVER结合O...

栏目：PostgreSQL 时间：09-29 PostgreSQL窗口函数 SQL排名 累计统计

生产环境误执行DROP TABLE后，数据库并非只能重建。只要之前用pg_dump做过逻辑备份，即使整库备份里也包含被删表的结构和数据，可以单独提取该表复原。本文围绕PostgreSQL误删场景，梳理从发现误删、冻结写入，到定位可用备份、按表还原的完整路径；同时说明pg_dump的-Fc自定义格式...

栏目：PostgreSQL 时间：09-29 PostgreSQL误删恢复 pg_dump备份还原 数据恢复

安装PostgreSQL时，很多问题其实都源于两个环节没有做对：版本选型和初始化参数设置。有人习惯直接使用系统自带源安装，结果装到的是非常旧的版本，后续想用新特性又得迁移数据；有人则在初始化时忽略了编码和认证方式，导致应用连接阶段频繁报错。本文从实际安装场景出发，将Linux、W...

栏目：PostgreSQL 时间：09-29 PostgreSQL安装 数据库安装步骤 PostgreSQL配置

业务系统里经常会遇到需要记录数据生效起止时间的场景，比如价格、合同、权限配置等。要让查询既准确又高效，不能只依赖两个独立的开始时间和结束时间字段。PostgreSQL提供的范围类型以及对应的GiST索引，能让某个时间点查询和区间重叠查询都走索引。本文介绍如何用带时区的范...

栏目：PostgreSQL 时间：09-29 PostgreSQL 时间范围 有效时间段

在PostgreSQL里执行CREATE TABLE命令时，列类型、主键约束、表空间和填充因子等细节会直接决定后续写入性能与数据完整性。很多建表失败或查询变慢的问题，根源往往在最初几行SQL语句里。本文从创建一张基础表入手，逐步拆解常用数据类型、约束条件、默认值、自增列实现方式以...

栏目：PostgreSQL 时间：09-29 PostgreSQL 创建表 CREATE TABLE

PostgreSQL高可用体系里，Patroni把主库仲裁交给分布式配置存储，这层决策比很多人想象得更关键。它不只是在配置文件里写一个地址，而是通过DCS提供的原子写入、租约和监听回调完成选主。节点启动后会尝试在DCS中创建或更新leader键，成功写入并持有租约的节点成为主库。备库持...

栏目：PostgreSQL 时间：09-28 Patroni DCS 选主机制

误执行 TRUNCATE 往往是数据库运维中最让人手心冒汗的瞬间。与 DELETE 不同，TRUNCATE 直接截断底层数据文件，提交后不会留下可逐行回滚的旧版本，单纯靠事务回滚或常规闪回基本无解。但只要数据库开启了连续归档并且保留有基础备份，就可以借助 PostgreSQL 的时间点恢复机制，把...

栏目：PostgreSQL 时间：09-28 PostgreSQL WAL日志 truncate恢复 时间点恢复

排查PostgreSQL报错时，如果只看信息文本而忽略SQLSTATE，往往会绕远路。错误信息可能随本地化设置变化，但SQLSTATE五位代码是稳定不变的，ERRCODE对应的条件名更是异常捕获的关键。本文整理常见错误码分类、ERRCODE与SQLSTATE对照关系，以及如何在psql、日志和应用代码中快速定位...

栏目：PostgreSQL 时间：09-28 PostgreSQL错误码 ERRCODE SQLState

索引不是建完就不用管。PostgreSQL 中一个长期没有清理的大索引，可能占用数 GB 磁盘，写入性能却持续下降。监控索引体积不能只看 pg_relation_size 的单一结果，还要结合 pg_stat_user_indexes 中的扫描次数、元组读取数，识别出几乎不用却很大的索引。进一步可以借助 pgstattu...

栏目：PostgreSQL 时间：09-28 PostgreSQL索引监控 索引瘦身 pg_stat_user_indexes

备份文件里既有表结构也有数据，如果目标库已经修改过表定义，直接恢复会把现有字段和索引覆盖掉。pg_restore其实提供了数据专用选项，但单独使用仍有不少坑。本文从归档文件的内部结构说起，演示如何使用自定义格式备份配合--data-only和--table参数，只导入指定表的数据而不重建...

栏目：PostgreSQL 时间：09-28 pg_restore PostgreSQL 数据恢复