如何在PostgreSQL中将单条记录/行作为参数传递给函数

思路正确性说明 #

你的思路完全正确，使用tablename%ROWTYPE声明参数、通过.运算符访问字段是PostgreSQL中单条行/记录参数传递的标准实现方案，不需要额外做数组封装。

完整实现示例 #

我们以users表为例演示完整用法：

1. 先准备测试表结构

CREATE TABLE users (
    id INT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL
);

2. 创建接收行类型参数的函数

CREATE OR REPLACE FUNCTION format_user_info(user_row users%ROWTYPE)
RETURNS TEXT 
LANGUAGE plpgsql
AS $$
BEGIN
    -- 直接通过.访问行记录的字段，和你提到的写法完全一致
    RETURN CONCAT('ID: ', user_row.id, ' | 用户名: ', user_row.username, ' | 邮箱: ', user_row.email);
END;
$$;

3. 调用函数的两种常见方式

• 直接传入表查询的单行结果：

SELECT format_user_info(users.*) FROM users WHERE id = 1;

• 手动构造行变量传入：

DO $$
DECLARE
    custom_user users%ROWTYPE;
BEGIN
    custom_user.id = 100;
    custom_user.username = 'demo_user';
    custom_user.email = 'demo@example.com';
    RAISE NOTICE '格式化结果：%', format_user_info(custom_user);
END $$;

其他可选方案 #

如果你有更灵活的需求，也可以选择另外两种实现方式：

• 使用泛型record类型作为参数：适用于函数逻辑兼容多种表结构的场景，不需要提前绑定特定表的行类型，调用时传入任意结构的单条记录即可，字段访问语法和%ROWTYPE完全一致。
• 自定义复合类型作为参数：如果需要传递的记录结构没有对应表，或者不需要和表结构绑定，可以先自定义复合类型：

CREATE TYPE custom_user_struct AS (
    user_id INT,
    nickname VARCHAR,
    contact VARCHAR
);

后续函数参数声明为custom_user_struct类型即可，字段访问语法不变。

内容的提问来源于stack exchange，提问作者Spyromancer