PostgreSQL自定义函数获取表列名返回空结果的原因排查

你编写了一个名为get_table_columns的PL/pgSQL函数，参数为表名（text类型），返回类型为SETOF information_schema.columns，用于获取指定表的所有列信息。单独执行对应查询语句能正常得到结果，但封装成函数后，调用SELECT * from get_table_columns('event');返回空结果。原函数代码如下：

CREATE OR REPLACE FUNCTION get_table_columns(tablename text) RETURNS SETOF information_schema.columns AS
$$
    BEGIN
        EXECUTE format('SELECT * FROM information_schema.columns WHERE table_name = %s;', quote_literal(tablename));
    END
$$
LANGUAGE plpgsql;

问题原因 #

1. 缺少结果返回逻辑：PL/pgSQL中使用EXECUTE执行动态SQL时，必须搭配RETURN QUERY关键字才能将查询结果返回给调用者。原函数仅执行了查询，但没有输出结果，因此返回空集。
2. 未指定表模式（可选但重要）：information_schema.columns包含所有模式下的表信息，仅过滤table_name可能因同名表导致结果不准确，或在非public模式下查询不到目标表。

修正后的函数 #

CREATE OR REPLACE FUNCTION get_table_columns(tablename text, schemaname text DEFAULT 'public') 
RETURNS SETOF information_schema.columns AS
$$
BEGIN
    RETURN QUERY EXECUTE format(
        'SELECT * FROM information_schema.columns 
         WHERE table_name = %L AND table_schema = %L;', 
        tablename, schemaname
    );
END
$$
LANGUAGE plpgsql;

修正说明 #

• 添加RETURN QUERY，将动态查询的结果返回给调用者。
• 使用format函数的%L格式符自动处理字符串转义，替代手动调用quote_literal()，更简洁安全。
• 新增可选的schemaname参数（默认值为public），支持查询指定模式下的表，避免同名表干扰。

调用示例 #

-- 查询public模式下event表的列信息
SELECT * FROM get_table_columns('event');

-- 查询test_schema模式下event表的列信息
SELECT * FROM get_table_columns('event', 'test_schema');

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