dblink_exec
dblink_exec — выполнÑет команду в удалённой базе данных
СинтакÑиÑ
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, и заданное подключение уÑтанавливаетÑÑ Ñ‚Ð¾Ð»ÑŒÐºÐ¾ на Ð²Ñ€ÐµÐ¼Ñ Ð²Ñ‹Ð¿Ð¾Ð»Ð½ÐµÐ½Ð¸Ñ Ñтой команды.
Ðргументы
connnameÐ˜Ð¼Ñ Ð¸Ñпользуемого подключениÑ; опуÑтите Ñтот параметр, чтобы иÑпользовать безымÑнное подключение.
connstrСтрока подключениÑ, опиÑÐ°Ð½Ð½Ð°Ñ Ñ€Ð°Ð½ÐµÐµ длÑ
dblink_connect.sqlSQL-запроÑ, который вы хотите выполнить в удалённой базе данных, например
insert into foo values(0, 'a', '{"a0","b0","c0"}').fail_on_errorЕÑли равен true (Ñто значение по умолчанию), в Ñлучае ошибки, выданной на удалённой Ñтороне ÑоединениÑ, ошибка также выдаётÑÑ Ð»Ð¾ÐºÐ°Ð»ÑŒÐ½Ð¾. ЕÑли равен false, ÑƒÐ´Ð°Ð»Ñ‘Ð½Ð½Ð°Ñ Ð¾ÑˆÐ¸Ð±ÐºÐ° выдаётÑÑ Ð»Ð¾ÐºÐ°Ð»ÑŒÐ½Ð¾ как ЗÐМЕЧÐÐИЕ, и возвращаемым значением функции будет
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)