如何编写自定义函数_RETURN子句与流水线函数实现-Oracle-PHP中文网

postgresql流水线函数不支持\_return子句；应使用return next逐行返回或return query直接透传查询结果，且需确保列名、类型、顺序与returns table声明完全匹配。

流水线函数里不能直接用 `_return` 子句

postgresql 的流水线函数（即 returns table 或 returns setof 函数）本身不支持在函数体里写 _return 子句——这个语法根本不存在。你看到的可能是对 return、return next、return query 的混淆，或是某些文档误写。

常见错误现象：ERROR: syntax error at or near "_RETURN"；或者函数编译通过但始终返回空集，其实是没触发任何 RETURN 语句。

RETURN 用于标量返回（如 RETURNS int），返回单个值后立即退出函数
RETURN NEXT 用于逐行输出（RETURNS TABLE / SETOF），每调一次推一行到结果集
RETURN QUERY 直接执行一个查询并把整批结果追加进返回集，更高效，也更常用

`RETURN QUERY` 是最稳妥的流水线实现方式

它天然适配 RETURNS TABLE(...)，且避免手动循环和类型对齐风险。只要查询的列名、类型、顺序与函数声明一致，就能直接“透传”结果。

使用场景：封装复杂 JOIN、带 WHERE 过滤的视图逻辑、需要复用的分页查询等。

示例：

CREATE OR REPLACE FUNCTION get_active_users()
RETURNS TABLE(id int, name text, last_login timestamptz) AS $$
  RETURN QUERY
    SELECT u.id, u.name, u.last_login
    FROM users u
    WHERE u.status = 'active' AND u.last_login > now() - interval '30 days';
$$ LANGUAGE sql;

函数声明的 TABLE 列必须和 SELECT 投影完全匹配（名字+类型），否则报错 structure of query does not match function result type
不能在 RETURN QUERY 后再写 RETURN NEXT 混用——行为未定义，多数情况只取第一个 RETURN
PL/pgSQL 中用 RETURN QUERY 比拼接循环 + RETURN NEXT 快得多，因为绕过了逐行赋值开销

PL/pgSQL 里用 `RETURN NEXT` 要小心变量绑定和 NULL 处理

当你需要动态构造每一行（比如从游标读、或做条件分支计算），才考虑 RETURN NEXT。但它要求你显式构造一个复合类型值，稍不注意就类型错位或漏字段。

常见错误现象：函数返回空、某列全为 NULL、或报错 record type has no field xxx。

如果函数声明为 RETURNS TABLE(a int, b text)，内部必须用 RETURN NEXT (val_a, val_b)::record 或更安全的方式：先定义 %ROWTYPE 变量
不要直接 RETURN NEXT my_var，除非 my_var 类型严格匹配函数返回类型
循环中若某次没触发 RETURN NEXT，那一行就丢了——没有隐式补 NULL 行，这点和 RETURN QUERY 不同