RETURN TABLE函数必须用RETURN QUERY配对，不能用RETURN或RETURN NEXT；列名、顺序、类型须完全一致，且需显式别名确保匹配。
RETURN TABLE 语句必须配 RETURN QUERY，不能用 RETURN
PostgreSQL 的 RETURNS TABLE 只是声明函数返回结构（列名+类型），**不自动构造结果集**。常见错误是写成 RETURN (SELECT ...) 或 RETURN my_record，这会报错：ERROR: cannot return a value from a function returning a table。
正确做法只有一种：用 RETURN QUERY 后接一个完整查询（SELECT、VALUES、CTE 等）。它把查询结果整批推入返回流，和声明的 TABLE 结构逐列对齐。
RETURN QUERY SELECT id, name FROM users WHERE active;RETURN QUERY VALUES (1, 'a'), (2, 'b');- 不能用
RETURN NEXT row_var;（那是SETOF的写法） - 不能在同一个函数里混用
RETURN QUERY和RETURN NEXT
函数体必须用 PL/pgSQL，不能用 SQL 语言
RETURNS TABLE 本身支持 LANGUAGE sql，但一旦需要条件分支、变量、循环或多次 RETURN QUERY，就必须切到 LANGUAGE plpgsql。很多人卡在这儿：写了 IF ... THEN RETURN QUERY ... END IF; 却还声明 LANGUAGE sql，直接报错 ERROR: invalid language "sql"。
- 声明函数时明确写
LANGUAGE plpgsql -
LANGUAGE sql函数只能是单条查询（无逻辑控制），此时RETURNS TABLE等价于包装一层SELECT - PL/pgSQL 下可多次
RETURN QUERY（如分表查询合并），每次追加一批行
列名和类型必须与 RETURNS TABLE 完全一致
PostgreSQL 不做隐式列名映射。如果 RETURNS TABLE (id INT, label TEXT)，而 RETURN QUERY SELECT user_id, title FROM posts;，运行时报错：ERROR: structure of query does not match function result type。
- 列名必须字面匹配（大小写敏感，除非双引号包裹）
- 列数、顺序、类型需一一对应；类型不兼容时不会自动转换（比如
INTvsBIGINT可能失败） - 安全写法：显式别名，如
RETURN QUERY SELECT id AS id, name AS label FROM users; - 用
pg_typeof()查实际类型：SELECT pg_typeof((SELECT 1::BIGINT));
性能注意：RETURN QUERY 不缓存中间结果
每次 RETURN QUERY 都实时执行查询并流式返回，没有“构建临时表再返回”的过程。这意味着：
- 若多次
RETURN QUERY查询同一张大表，可能重复扫描（没共享计划） - 无法在函数内对返回数据做排序/去重——必须在每个
RETURN QUERY子句里单独加ORDER BY或DISTINCT - 想复用结果？先
CREATE TEMP TABLE或用 CTE（放在单个RETURN QUERY内） - 大数据量时，客户端接收可能阻塞，注意超时设置（如
statement_timeout）
最易忽略的是列名拼写和大小写——双引号包裹的列名（如 "Id"）和未加引号的 id 在 PostgreSQL 中是两个不同标识符，对不上就报错，且错误信息不提示具体哪一列。
