dblink_close — リモートデータベースでカーソルを閉ざします
dblink_close(text cursorname [, bool fail_on_error]) returns text dblink_close(text connname, text cursorname [, bool fail_on_error]) returns text
dblink_close
は前もってdblink_open
で開かれたカーソルを閉ざします。
connname
使用する接続の名前です。 無名の接続を使用する場合はこのパラメータを省略します。
cursorname
閉ざすカーソルの名前です。
fail_on_error
真(省略時のデフォルト)の場合、接続のリモート側で発生したエラーによりローカル側でもエラーが発生します。
偽の場合リモート側のエラーはローカル側にはNOTICEとして報告され、この関数の戻り値はERROR
になります。
状態、つまりOK
またはERROR
を返します。
dblink_open
が明示的なトランザクションブロックを開始し、これが接続上で最後まで開き続けているカーソルであった場合、dblink_close
は対応するCOMMIT
を発行します。
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) SELECT dblink_close('foo'); dblink_close -------------- OK (1 row)