# dblink_exec ## Name dblink_exec?--?在遠程數據庫中執行命令 ## Synopsis ``` dblink_exec(text connname, text sql [, bool fail_on_error]) returns text dblink_exec(text connstr, text sql [, bool fail_on_error]) returns text dblink_exec(text sql [, bool fail_on_error]) returns text ``` ## 描述 `dblink_exec`在遠程數據庫中執行命令（即不返回行的任何SQL語句）。 當給定兩個`text`參數時，第一個作為持久連接名稱首先被查找；如果發現了， 那么在連接上執行該命令。如果沒有發現， 那么第一個參數被看作`dblink_connect`的連接信息字符串， 并且指定連接為了該命令的整個時間段。 ## 參數 `conname` 要使用的連接名稱；省略這個參數使用未命名連接。 `connstr` 連接信息字符串，如先前描述的`dblink_connect`。 `sql` 你希望在遠程數據庫中執行的SQL命令， 比如`insert into foo values(0,'a','{"a0","b0","c0"}')`。 `fail_on_error` 如果真（忽略時缺省）那么在連接的遠程端拋出的錯誤也會導致本地拋出錯誤， 如果假，那么遠程錯誤在本地作為NOTICE被報告， 并且函數的返回值設置為`ERROR`。 ## 返回值 返回狀態，該命令的狀態字符串或者`ERROR`。 ## 例子 ``` SELECT dblink_connect('dbname=dblink_test_standby'); dblink_connect ---------------- OK (1 row) SELECT dblink_exec('insert into foo values(21,''z'',''{"a0","b0","c0"}'');'); dblink_exec ----------------- INSERT 943366 1 (1 row) SELECT dblink_connect('myconn', 'dbname=regression'); dblink_connect ---------------- OK (1 row) SELECT dblink_exec('myconn', 'insert into foo values(21,''z'',''{"a0","b0","c0"}'');'); dblink_exec ------------------ INSERT 6432584 1 (1 row) SELECT dblink_exec('myconn', 'insert into pg_class values (''foo'')',false); NOTICE: sql error DETAIL: ERROR: null value in column "relnamespace" violates not-null constraint dblink_exec ------------- ERROR (1 row) ```