dblink_open

PostgreSQL 9.4.4 中文手册
上一页 | 上一级 |  | 下一页

# dblink_open

## 名称

dblink_open -- 打开远程数据库中的游标

## 大纲

    dblink_open(text cursorname, text sql [, bool fail_on_error]) returns text
    dblink_open(text connname, text cursorname, text sql [, bool fail_on_error]) returns text

## 描述

`dblink_open()`打开了远程数据库中的游标。 游标可以随后使用`dblink_fetch()`和`dblink_close()` 被操作。

## 参数

`conname`

  要使用的连接名称；省略这个参数使用未命名连接。

`cursorname`

  分配给这个游标的名称。

`sql`

  你希望在远程数据库中执行的`SELECT`语句，比如`select * from pg_class`。

`fail_on_error`

  如果真（忽略时缺省）那么在连接的远程端抛出的错误也会导致本地抛出错误， 如果假，那么远程错误在本地作为NOTICE被报告， 并且函数的返回值设置为`ERROR`。

## 返回值

返回状态，`OK`或者`ERROR`。

## 注意

因为游标只能停留在事务块中，如果远程端已经不在事务中， 那么`dblink_open`在远程端开始显式事务块（`BEGIN`）， 当执行匹配的`dblink_close`时，则该事务将再次被关闭。 注意如果在`dblink_open`和`dblink_close`之间使用 `dblink_exec`改变数据，那么会产生错误或者你在`dblink_close`之前使用 `dblink_disconnect`，你的改变将丢失，因为终止了事务。

## 例子

    SELECT dblink_connect('dbname=postgres');
     dblink_connect
    ----------------
     OK
    (1 row)

    SELECT dblink_open('foo', 'select proname, prosrc from pg_proc');
     dblink_open
    -------------
     OK
    (1 row)

上一页 | 起始页 | 下一页
dblink_exec | 上一级 | dblink_fetch