# dblink_open ## Name dblink_open?--?打開遠程數據庫中的游標 ## Synopsis ``` 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) ```