dblink_fetch — 从远程数据库中已打开的游标返回行
dblink_fetch(text cursorname, int howmany [, bool fail_on_error]) returns setof record dblink_fetch(text connname, text cursorname, int howmany [, bool fail_on_error]) returns setof record
dblink_fetch 从先前由 dblink_open 建立的游标取回行。
connname要使用的连接名称;省略该参数以使用未命名连接。
cursorname要从中取行的游标名称。
howmany
要检索的最大行数。从当前游标位置开始向前取回接下来的 howmany 行。游标到达末尾后不再产生更多行。
fail_on_error如果为真(省略时的默认值),连接远端抛出的错误也会导致本地抛出错误。如果为假,远程错误会在本地以 NOTICE 报告,并且函数不返回任何行。
该函数返回从游标取回的行。要使用该函数,你需要指定期望的列集合,如前面对 dblink 的讨论。
当 FROM 子句中指定的返回列数与远程游标实际返回的列数不匹配时,会抛出错误。此时,远程游标仍会前进相当于未发生错误时前进的行数。远程 FETCH 完成后在本地查询中发生的任何其他错误也是如此。
SELECT dblink_connect('dbname=postgres options=-csearch_path=');
dblink_connect
----------------
OK
(1 row)
SELECT dblink_open('foo', 'select proname, prosrc from pg_proc where proname like ''bytea%''');
dblink_open
-------------
OK
(1 row)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
----------+----------
byteacat | byteacat
byteacmp | byteacmp
byteaeq | byteaeq
byteage | byteage
byteagt | byteagt
(5 rows)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
-----------+-----------
byteain | byteain
byteale | byteale
bytealike | bytealike
bytealt | bytealt
byteane | byteane
(5 rows)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
------------+------------
byteanlike | byteanlike
byteaout | byteaout
(2 rows)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
----------+--------
(0 rows)