PostgreSQL匿名DO块中游标使用的两类报错问题

问题梳理 #

尝试用匿名DO块替代函数操作游标时，会碰到两类典型问题：

问题1：块内执行FETCH触发语法错误 #

将FETCH写在DO块内部时，会提示缺少INTO子句，无论游标名是否加引号都会报错，对应代码如下：

DO 
$$
DECLARE  _query TEXT;
DECLARE  _cursor CONSTANT refcursor := _cursor;

BEGIN
   _query := 'select "Port", "Version", "AddDate" from "LatestLogEntry";';

   OPEN _cursor FOR EXECUTE _query;

   FETCH ALL FROM _cursor;   -- 语法错误：此处缺少INTO子句
END
$$;

问题2：块外执行FETCH提示游标不存在 #

参照示例将FETCH放在DO块外部时，会收到游标不存在的报错，且游标名加引号与否会影响报错细节，对应代码及报错如下：

DO 
$$
DECLARE  _query TEXT;
DECLARE  _cursor CONSTANT refcursor := '_cursor';

BEGIN
   _query := 'select "Port", "Version", "AddDate" from "LatestLogEntry";';

   OPEN _cursor FOR EXECUTE _query;
END
$$;

FETCH ALL FROM _cursor -- 错误：游标 "_cursor" 不存在

原因分析与解决办法 #

问题1：PL/pgSQL块内FETCH必须指定结果接收变量 #

PostgreSQL的PL/pgSQL环境中，FETCH语句不能直接返回结果到客户端，必须通过INTO子句将结果存入变量（或记录、行类型）。如果只是想查看结果，可以通过RAISE NOTICE输出；如果需要返回结果，建议改用函数而非DO块。

修正后的示例（块内处理结果）：

DO 
$$
DECLARE  
  _query TEXT;
  _cursor refcursor;
  _log_rec record; -- 定义记录变量接收游标结果
BEGIN
   _query := 'select "Port", "Version", "AddDate" from "LatestLogEntry";';
   OPEN _cursor FOR EXECUTE _query;
   -- 循环读取游标内容
   LOOP
      FETCH _cursor INTO _log_rec;
      EXIT WHEN NOT FOUND; -- 无数据时退出循环
      -- 输出结果到控制台
      RAISE NOTICE '端口: %, 版本: %, 添加日期: %', _log_rec."Port", _log_rec."Version", _log_rec."AddDate";
   END LOOP;
   CLOSE _cursor; -- 关闭游标
END
$$;

问题2：DO块内游标是局部变量，外部无法访问 #

DO块内声明的游标属于块的局部作用域，DO块执行完毕后，局部游标会被自动销毁，外部会话无法访问。如果要在块外使用游标，需要使用全局命名游标，且必须在事务中操作（全局游标仅在事务生命周期内有效）。

修正后的示例（全局游标跨块访问）：

-- 开启事务，全局游标仅在事务内有效
BEGIN;

DO 
$$
DECLARE  
  _query TEXT;
BEGIN
   _query := 'select "Port", "Version", "AddDate" from "LatestLogEntry";';
   -- 直接打开全局命名游标，无需在块内声明变量
   OPEN my_global_cursor FOR EXECUTE _query;
END
$$;

-- 块外读取全局游标内容
FETCH ALL FROM my_global_cursor;

-- 关闭游标并提交事务
CLOSE my_global_cursor;
COMMIT;

另外注意：原代码中DECLARE _cursor CONSTANT refcursor := '_cursor';的写法存在问题——局部游标无需赋值为字符串，直接声明类型即可；全局游标则不需要在DO块内声明变量，直接在OPEN时指定名称。

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