dblink_get_result — 获取异步查询结果
dblink_get_result(text connname [, bool fail_on_error]) returns setof record
dblink_get_result收集先前使用dblink_send_query发送的异步查询的结果。如果查询尚未完成,dblink_get_result将等待直到完成。
connname要使用的连接的名称。
fail_on_error如果为 true(省略时默认为 true),则连接远程端抛出的错误也会导致本地抛出错误。如果为 false,则远程错误在本地报告为 NOTICE,并且该函数不返回任何行。
对于异步查询(即,返回行的 SQL 语句),该函数返回查询生成的行。要使用此函数,您需要指定预期的列集,如先前对dblink的讨论。
对于异步命令(即,不返回行的 SQL 语句),该函数返回一个单行,其中包含一个包含命令状态字符串的文本列。仍然需要在调用的FROM子句中指定结果将具有单个文本列。
如果dblink_send_query返回 1,则必须调用此函数。对于发送的每个查询,必须调用一次,并且在连接可以再次使用之前,还需要额外调用一次以获取空集结果。
当使用dblink_send_query和dblink_get_result时,dblink在将任何结果返回给本地查询处理器之前,会获取整个远程查询结果。如果查询返回大量行,这可能会导致本地会话中的瞬时内存膨胀。最好使用dblink_open将此类查询作为游标打开,然后一次提取可管理数量的行。或者,使用普通的dblink(),它通过将大型结果集假脱机到磁盘来避免内存膨胀。
contrib_regression=# SELECT dblink_connect('dtest1', 'dbname=contrib_regression');
dblink_connect
----------------
OK
(1 row)
contrib_regression=# SELECT * FROM
contrib_regression-# dblink_send_query('dtest1', 'select * from foo where f1 < 3') AS t1;
t1
----
1
(1 row)
contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
----+----+------------
0 | a | {a0,b0,c0}
1 | b | {a1,b1,c1}
2 | c | {a2,b2,c2}
(3 rows)
contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
----+----+----
(0 rows)
contrib_regression=# SELECT * FROM
contrib_regression-# dblink_send_query('dtest1', 'select * from foo where f1 < 3; select * from foo where f1 > 6') AS t1;
t1
----
1
(1 row)
contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
----+----+------------
0 | a | {a0,b0,c0}
1 | b | {a1,b1,c1}
2 | c | {a2,b2,c2}
(3 rows)
contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
----+----+---------------
7 | h | {a7,b7,c7}
8 | i | {a8,b8,c8}
9 | j | {a9,b9,c9}
10 | k | {a10,b10,c10}
(4 rows)
contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
----+----+----
(0 rows)
如果您在文档中发现任何不正确、与您使用特定功能的经验不符或需要进一步澄清的内容,请使用此表单报告文档问题。