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()
來操作。
connname
要使用的連線名稱;省略此參數以使用未命名的連線。
cursorname
要分配給此游標的名稱。
sql
您希望在遠端資料庫中執行的 SELECT
語句,例如 select * from pg_class
。
fail_on_error
如果為 true(省略時的預設值),則連線遠端發生的錯誤也會在本機引發錯誤。 如果為 false,則遠端錯誤會在本機報告為 NOTICE,並且函數的回傳值會設定為 ERROR
。
回傳狀態,OK
或 ERROR
。
由於游標只能在交易中持續存在,如果遠端尚未在交易中,則 dblink_open
會在遠端啟動一個明確的交易區塊(BEGIN
)。 當執行對應的 dblink_close
時,此交易將再次關閉。 請注意,如果您在 dblink_open
和 dblink_close
之間使用 dblink_exec
變更資料,然後發生錯誤或在 dblink_close
之前使用 dblink_disconnect
,您的變更將會遺失,因為交易將被中止。
SELECT dblink_connect('dbname=postgres options=-csearch_path='); dblink_connect ---------------- OK (1 row) SELECT dblink_open('foo', 'select proname, prosrc from pg_proc'); dblink_open ------------- OK (1 row)
如果您在文件中發現任何不正確、與特定功能的使用經驗不符或需要進一步說明的內容,請使用此表單報告文件問題。