pg_squeeze 项目教程

pg_squeeze 项目教程

pg_squeeze A PostgreSQL extension for automatic bloat cleanup 项目地址: https://gitcode.com/gh_mirrors/pg/pg_squeeze

1. 项目的目录结构及介绍

pg_squeeze 是一个用于自动清理 PostgreSQL 表中未使用空间的扩展。以下是该项目的目录结构及其介绍：

pg_squeeze/
├── github/workflows/
│   └── expected
├── sql/
│   ├── pg_squeeze--1.2--1.3.sql
│   ├── pg_squeeze--1.2.sql
│   ├── pg_squeeze--1.3--1.4.sql
│   ├── pg_squeeze--1.4--1.5.sql
│   ├── pg_squeeze--1.5--1.6.sql
│   ├── pg_squeeze--1.6--1.7.sql
│   └── pg_squeeze.sql
├── dir-locals.el
├── .gitignore
├── LICENSE
├── Makefile
├── NEWS
├── README.md
├── concurrent.c
├── pg_squeeze.c
├── pg_squeeze.control
├── pg_squeeze.h
├── pgstatapprox.c
└── worker.c

目录结构介绍

• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• sql/: 包含 PostgreSQL 扩展的 SQL 脚本文件，用于定义扩展的功能和版本升级。
• dir-locals.el: Emacs 的目录本地变量配置文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目的开源许可证文件。
• Makefile: 项目的构建文件，用于编译和安装扩展。
• NEWS: 项目更新日志。
• README.md: 项目的介绍和使用说明。
• concurrent.c: 并发处理相关的源代码文件。
• pg_squeeze.c: pg_squeeze 扩展的主要源代码文件。
• pg_squeeze.control: PostgreSQL 扩展的控制文件，定义扩展的元数据。
• pg_squeeze.h: 头文件，包含扩展的函数和变量声明。
• pgstatapprox.c: 统计近似值相关的源代码文件。
• worker.c: 后台工作进程相关的源代码文件。

2. 项目的启动文件介绍

pg_squeeze 的启动文件主要是 pg_squeeze.c，它是扩展的核心实现文件。该文件包含了扩展的主要功能逻辑，包括表的自动清理和优化。

主要功能

• 自动清理: 定期检查表中的未使用空间，并自动进行清理。
• 并发处理: 在清理过程中，允许其他事务继续读写表数据。
• 逻辑解码: 使用逻辑解码技术来捕获并发更改，确保数据一致性。

3. 项目的配置文件介绍

pg_squeeze 的配置文件主要包括 pg_squeeze.control 和 postgresql.conf 中的相关配置项。

pg_squeeze.control

pg_squeeze.control 是 PostgreSQL 扩展的控制文件，定义了扩展的元数据，如扩展名称、版本号、依赖关系等。

# pg_squeeze.control
comment = 'A PostgreSQL extension for automatic bloat cleanup'
default_version = '1.7'
module_pathname = '$libdir/pg_squeeze'
relocatable = true

postgresql.conf

在 postgresql.conf 中，需要配置以下参数以启用 pg_squeeze 扩展：

wal_level = logical
max_replication_slots = 1  # 或者在现有值基础上增加 1
shared_preload_libraries = 'pg_squeeze'  # 或者将该库添加到现有库列表中

配置说明

• wal_level: 设置为 logical，以启用逻辑解码功能。
• max_replication_slots: 设置为至少 1，以确保有足够的复制槽供 pg_squeeze 使用。
• shared_preload_libraries: 将 pg_squeeze 添加到预加载库列表中，以便在 PostgreSQL 启动时加载该扩展。

通过以上配置，pg_squeeze 扩展将能够在 PostgreSQL 数据库中自动清理表中的未使用空间，并优化表的存储结构。

pg_squeeze A PostgreSQL extension for automatic bloat cleanup 项目地址: https://gitcode.com/gh_mirrors/pg/pg_squeeze