PostgreSQL中insert_username的扩展使用

 更新时间:2025年06月16日 08:28:37   作者:文牧之  
insert_username 是 PostgreSQL 的一个实用扩展,用于自动记录数据行的创建者和最后修改者信息,本文就来详细的介绍一下insert_username扩展,感兴趣的可以了解一下

insert_username 是 PostgreSQL 的一个实用扩展,用于自动记录数据行的创建者和最后修改者信息。这个扩展特别适合需要审计跟踪的应用场景。

一 扩展安装与启用

1.1 安装扩展

-- 使用超级用户安装
CREATE EXTENSION insert_username;

1.2 验证安装

-- 查看已安装扩展
SELECT * FROM pg_available_extensions WHERE name = 'insert_username';

-- 查看扩展提供的函数
\df+ insert_username.*

输出示例:

white=# CREATE EXTENSION insert_username;
CREATE EXTENSION
white=# SELECT * FROM pg_available_extensions WHERE name = 'insert_username';
      name       | default_version | installed_version |                  comment                   
-----------------+-----------------+-------------------+--------------------------------------------
 insert_username | 1.0             | 1.0               | functions for tracking who changed a table
(1 row)

white=# \df+ insert_username.*
                                                                           List of functions
 Schema | Name | Result data type | Argument data types | Type | Volatility | Parallel | Owner | Security | Access privileges | Language | Internal name | D
escription 
--------+------+------------------+---------------------+------+------------+----------+-------+----------+-------------------+----------+---------------+--
-----------
(0 rows)

white=# 

二 基本功能与使用

2.1 核心功能

该扩展提供两个主要功能:

  • 自动插入当前用户名到指定列(记录创建者)
  • 自动更新当前用户名到指定列(记录最后修改者)

2.2 基本用法示例

-- 创建测试表
CREATE TABLE documents (
    id serial PRIMARY KEY,
    content text,
    created_by text,  -- 记录创建者
    modified_by text  -- 记录最后修改者
);

-- 为表添加触发器
CREATE TRIGGER track_document_users
BEFORE INSERT OR UPDATE ON documents
FOR EACH ROW EXECUTE FUNCTION insert_username();

输出示例:

white=# CREATE TABLE yewu1.documents (
white(#     id int,
white(#     name varchar(20),
white(#     created_by text,   
white(#     modified_by text   
white(# );
CREATE TABLE
white=# CREATE TRIGGER track_document_users
white-# BEFORE INSERT OR UPDATE ON yewu1.documents
white-# FOR EACH ROW EXECUTE FUNCTION insert_username();
CREATE TRIGGER
white=# 
white=# \d yewu1.documents
                       Table "yewu1.documents"
   Column    |         Type          | Collation | Nullable | Default 
-------------+-----------------------+-----------+----------+---------
 id          | integer               |           |          | 
 name        | character varying(20) |           |          | 
 created_by  | text                  |           |          | 
 modified_by | text                  |           |          | 
Triggers:
    track_document_users BEFORE INSERT OR UPDATE ON yewu1.documents FOR EACH ROW EXECUTE FUNCTION insert_username()

三 高级配置选项

3.1 自定义列名

-- 创建使用不同列名的表
CREATE TABLE projects (
    id serial PRIMARY KEY,
    name text,
    creator text,      -- 替代 created_by
    last_editor text   -- 替代 modified_by
);

-- 使用参数指定列名
CREATE TRIGGER track_project_users
BEFORE INSERT OR UPDATE ON projects
FOR EACH ROW EXECUTE FUNCTION insert_username('creator', 'last_editor');

3.2 选择性应用

-- 只跟踪创建者
CREATE TRIGGER track_creator_only
BEFORE INSERT ON projects
FOR EACH ROW EXECUTE FUNCTION insert_username('creator', NULL);

-- 只跟踪修改者
CREATE TRIGGER track_editor_only
BEFORE UPDATE ON projects
FOR EACH ROW EXECUTE FUNCTION insert_username(NULL, 'last_editor');

四 扩展内部原理

4.1 实现机制

insert_username 扩展实际上创建了一个触发器函数,该函数:

  • 在 INSERT 操作时设置 created_by 列为当前用户名
  • 在 UPDATE 操作时设置 modified_by 列为当前用户名

4.2 使用的PostgreSQL特性

  • 触发器函数
  • current_user 系统函数
  • 可变参数处理

五 性能考虑

5.1 性能影响

  • 触发器增加的开销通常很小
  • 每行操作增加少量CPU时间
  • 不影响查询性能,只影响DML操作

5.2 优化建议

-- 对大表考虑禁用触发器进行批量操作
ALTER TABLE large_table DISABLE TRIGGER track_large_table_users;

-- 批量更新操作
UPDATE large_table SET ...;

-- 重新启用触发器
ALTER TABLE large_table ENABLE TRIGGER track_large_table_users;

六 与其他扩展的对比

特性insert_usernametemporal_tablespg_audit
用户跟踪
时间跟踪
完整审计
使用复杂度简单中等复杂
性能影响

七 最佳实践

命名一致性:在所有表中使用相同的列名(如created_by/modified_by)

组合使用:与时间戳触发器结合使用

权限控制

-- 防止手动修改跟踪列
REVOKE UPDATE ON created_by FROM public;

文档记录:在数据库文档中记录审计策略

异常处理:考虑添加错误处理逻辑

八 限制与注意事项

  • 不记录超级用户的更改(如postgres用户)
  • 需要触发器权限才能创建相关触发器
  • 不会跟踪DELETE操作
  • 在多语句事务中,用户名是事务开始时的用户

insert_username扩展提供了轻量级、简单易用的用户变更跟踪功能,非常适合基本的审计需求,但对于复杂的审计场景可能需要更全面的解决方案。

到此这篇关于PostgreSQL中insert_username的扩展的文章就介绍到这了,更多相关PostgreSQL insert_username扩展内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • PostgreSQL定时清理旧数据的实现方法

    PostgreSQL定时清理旧数据的实现方法

    最近觉得数据库中每日数据不需要都保持,只需要保留30天的,所以这篇文章给大家介绍了PostgreSQL定时清理旧数据的实现方法,文中通过代码示例和图文给大家介绍的非常详细,具有一定的参考价值,需要的朋友可以参考下
    2024-03-03
  • PostgreSQL配置远程连接简单图文教程

    PostgreSQL配置远程连接简单图文教程

    这篇文章主要给大家介绍了关于PostgreSQL配置远程连接的相关资料,PostgreSQL是一个功能非常强大的关系型数据库管理系统(RDBMS),文中通过代码介绍的非常详细,需要的朋友可以参考下
    2023-12-12
  • PotgreSQL 基于时间点恢复过程

    PotgreSQL 基于时间点恢复过程

    本篇文章介绍 PostgreSQL 基于时间点恢复(point-in-time-recover)需要的条件及恢复过程,属于操作说明,对PotgreSQL 时间点恢复相关知识感兴趣的朋友跟随小编一起看看吧
    2023-08-08
  • PostgreSQL中insert_username的扩展使用

    PostgreSQL中insert_username的扩展使用

    insert_username 是 PostgreSQL 的一个实用扩展,用于自动记录数据行的创建者和最后修改者信息,本文就来详细的介绍一下insert_username扩展,感兴趣的可以了解一下
    2025-06-06
  • 玩转PostgreSQL之30个实用SQL语句

    玩转PostgreSQL之30个实用SQL语句

    本文主要整理总结了30个实用SQL,方便大家可以高效利用PostgreSQL,需要的朋友可以参考下
    2022-11-11
  • PostgreSQL中查看当前时间和日期的几种常用方法

    PostgreSQL中查看当前时间和日期的几种常用方法

    在 PostgreSQL 中,有多个函数可以用来查看当前时间和日期,这些函数在处理时间戳、日期和时间的计算时非常有用,以下是几种常用的查看当前时间和日期的函数及示例,需要的朋友可以参考下
    2024-10-10
  • Postgresql根据响应数据反向实现建表语句与insert语句的过程

    Postgresql根据响应数据反向实现建表语句与insert语句的过程

    根据已有数据,可构建名为products的表,包含id(自增主键)、title(非空字符串)、progress(非空整数)三个字段,建表后,可通过insert语句插入数据,这种反向操作有助于从现有数据结构出发,快速构建数据库表,并进行数据填充,感兴趣的朋友跟随小编一起看看吧
    2022-02-02
  • PostgreSQL连接数过多报错:too many clients already的解决办法

    PostgreSQL连接数过多报错:too many clients already的解决

    在使用 Navicat 连接 PostgreSQL 数据库时,突然遭遇到了一个报错:“FATAL: sorry, too many clients already”,这一错误提示表明数据库连接数已经达到上限,无法再创建新连接,所以本文给大家介绍了相关的解决办法,需要的朋友可以参考下
    2024-03-03
  • PostgreSQL 实现登录及修改密码操作

    PostgreSQL 实现登录及修改密码操作

    这篇文章主要介绍了PostgreSQL 实现登录及修改密码操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-01-01
  • PostgreSQL copy 命令教程详解

    PostgreSQL copy 命令教程详解

    这篇文章主要介绍了PostgreSQL copy 命令教程详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-01-01

最新评论