supa_audit快速入门：3步启用PostgreSQL表变更跟踪功能

【免费下载链接】supa_auditGeneric Table Auditing项目地址: https://gitcode.com/gh_mirrors/su/supa_audit

supa_audit是一款轻量级PostgreSQL表审计工具，能够自动记录数据库表的插入、更新、删除操作，帮助开发者轻松实现数据变更跟踪。本文将通过3个简单步骤，教你如何快速在PostgreSQL项目中部署和使用supa_audit。

1. 准备工作：安装必要依赖

在开始前，请确保你的PostgreSQL环境已安装uuid-ossp扩展，这是supa_audit的核心依赖项。你可以通过以下SQL命令检查并安装：

-- 检查uuid-ossp扩展是否已安装 SELECT * FROM pg_extension WHERE extname = 'uuid-ossp'; -- 如未安装，执行以下命令 CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

supa_audit当前最新版本为0.3.1，支持PostgreSQL 9.6及以上版本。项目源码可通过以下命令获取：

git clone https://gitcode.com/gh_mirrors/su/supa_audit cd supa_audit

2. 安装部署：3分钟完成插件安装

2.1 使用Makefile快速安装

项目提供了便捷的Makefile安装方式，只需在项目根目录执行：

make install

该命令会自动将扩展文件复制到PostgreSQL的扩展目录，并执行必要的权限设置。

2.2 手动安装（适合高级用户）

如果你需要手动安装，可以执行以下步骤：

1. 连接到目标数据库：

psql -U your_username -d your_database

2. 执行安装脚本：

-- 安装核心功能 \i supa_audit--0.3.1.sql -- 如果从旧版本升级，执行相应的升级脚本 -- \i supa_audit--0.3.0--0.3.1.sql

安装完成后，可以通过以下命令验证：

SELECT * FROM pg_extension WHERE extname = 'supa_audit';

3. 启用跟踪：为目标表配置审计功能

3.1 基础跟踪启用

要开始跟踪某个表，只需调用supa_audit.enable_tracking函数：

-- 为users表启用完整审计跟踪 SELECT supa_audit.enable_tracking('public.users');

这个函数会自动创建触发器，记录所有INSERT、UPDATE、DELETE操作，并将变更历史存储在audit.logs表中。

3.2 高级配置选项

supa_audit提供了灵活的配置选项，满足不同场景需求：

-- 仅跟踪特定列的变更 SELECT supa_audit.enable_tracking( 'public.orders', tracked_columns => ARRAY['total_amount', 'status'] ); -- 启用幂等模式（防止重复审计记录） SELECT supa_audit.enable_idempotent('public.products');

3.3 查看审计记录

审计记录存储在audit.logs表中，你可以通过简单查询查看变更历史：

-- 查看最近10条变更记录 SELECT * FROM audit.logs ORDER BY created_at DESC LIMIT 10; -- 查看特定表的变更 SELECT * FROM audit.logs WHERE table_name = 'users';

常见问题与解决方案

Q: 如何禁用表跟踪功能？

A: 使用supa_audit.disable_tracking函数：

SELECT supa_audit.disable_tracking('public.users');

Q: 审计记录会占用大量存储空间吗？

A: 项目提供了自动清理机制，可通过supa_audit.set_retention_period设置保留天数：

-- 设置审计记录保留30天 SELECT supa_audit.set_retention_period(30);

总结

通过以上3个步骤，你已经成功在PostgreSQL项目中启用了表变更跟踪功能。supa_audit作为一款轻量级审计工具，既避免了复杂的配置过程，又提供了灵活的定制选项，非常适合中小型项目使用。项目的核心实现位于supa_audit--0.3.1.sql文件中，包含了所有审计逻辑和触发器定义。

如果你在使用过程中遇到问题，可以查阅项目测试目录中的示例脚本，如test/sql/enable_and_disable_tracking.sql提供了详细的功能测试案例，帮助你更好地理解和使用supa_audit的各项特性。

【免费下载链接】supa_auditGeneric Table Auditing项目地址: https://gitcode.com/gh_mirrors/su/supa_audit