DECLARE

DECLARE允许用户创建游标，游标可用于从较大的查询中一次取出少量行。游标创建后，可使用FETCH从中取出行。

关键字ASENSITIVE、BINARY、INSENSITIVE和SCROLL可以按任意顺序出现。

普通游标以文本格式返回数据，就像SELECT产生的结果一样。BINARY选项指定游标应以二进制格式返回数据。这减少了服务器和客户端两端的转换工作量，但代价是程序员需要付出更多精力来处理与平台相关的二进制数据格式。举例来说，如果某个查询从一个整型列返回值 1，那么默认游标会返回字符串 1，而二进制游标则会返回一个 4 字节字段，其中包含该值的内部表示（采用大端字节序）。

应谨慎使用二进制游标。许多应用程序（包括 psql）都没有准备好处理二进制游标，而是期望返回的数据为文本格式。

除非指定了WITH HOLD，否则该命令创建的游标只能在当前事务中使用。因此，DECLARE若不带WITH HOLD，在事务块之外就毫无用处：游标只能存活到该语句执行完成。所以，如果在事务块之外使用这种命令，PostgreSQL会报错。可使用BEGIN和COMMIT（或ROLLBACK）来定义事务块。

如果指定了WITH HOLD，且创建游标的事务成功提交，那么在同一会话中的后续事务里仍可继续访问该游标。（但如果创建事务被中止，游标会被移除。）使用WITH HOLD创建的游标会在对其发出显式CLOSE命令时关闭，或在会话结束时关闭。在当前实现中，这种游标所表示的行会被复制到临时文件或内存区域中，以便它们在后续事务中仍然可用。

当查询包括FOR UPDATE或FOR SHARE时，不能指定WITH HOLD。

在定义将用于向后取出行的游标时，应指定SCROLL选项。这是 SQL 标准所要求的。不过，为了兼容早期版本，如果游标的查询计划足够简单，以致支持向后取出不需要额外开销，PostgreSQL也允许在未指定SCROLL的情况下向后取出行。不过，建议应用开发者不要依赖于从未用SCROLL创建的游标中向后取出行。如果指定了NO SCROLL，那么无论如何都不允许向后取出行。

当查询包含FOR UPDATE或FOR SHARE时，同样不允许向后取出行。因此在这种情况下不能指定SCROLL。

如果游标的查询包含FOR UPDATE或FOR SHARE，那么返回的行会像带有这些选项的常规SELECT命令那样，在首次取出时被锁定。此外，返回的将是这些行的最新版本。

SQL 标准只为嵌入式SQL中的游标作出规定。PostgreSQL服务器没有为游标实现OPEN语句；游标在声明时即被视为打开。不过，ECPG是PostgreSQL的嵌入式 SQL 预处理器，它支持标准 SQL 的游标约定，包括涉及DECLARE和OPEN语句的那些约定。

打开的游标在服务器端的底层数据结构称为portal。客户端协议会暴露 portal 名称：只要知道该名称，客户端就可以直接从一个打开的 portal 中取出行。使用DECLARE创建游标时，portal 名称与游标名称相同。

可以通过查询pg_cursors 系统视图查看所有可用游标。

声明一个游标：

DECLARE liahona CURSOR FOR SELECT * FROM films;

更多游标用法示例见FETCH。

SQL 标准只允许在嵌入式SQL和模块中使用游标。PostgreSQL允许以交互方式使用游标。

根据 SQL 标准，通过UPDATE ... WHERE CURRENT OF和DELETE ... WHERE CURRENT OF语句对不敏感游标所做的更改，在同一个游标中是可见的。PostgreSQL将这些语句与所有其他更改数据的语句同等对待，因此这些更改在不敏感游标中不可见。

二进制游标是PostgreSQL的一种扩展。