dblink_build_sql_update — 使用本地元组构建 UPDATE 语句,并用替代值替换主键字段值
dblink_build_sql_update(text relname,
int2vector primary_key_attnums,
integer num_primary_key_atts,
text[] src_pk_att_vals_array,
text[] tgt_pk_att_vals_array) returns text
dblink_build_sql_update 可用于把本地表选择性地复制到远程数据库。它根据主键从本地表选择一行,然后构建一条 SQL UPDATE 命令来复制该行,但主键值被最后一个参数中的值替换。(要制作该行的精确副本,只需为最后两个参数指定相同的值。)UPDATE 命令总是赋值该行的所有字段 — 它与 dblink_build_sql_insert 的主要区别在于它假定目标行已存在于远程表中。
relname
本地关系的名称,例如 foo 或 myschema.mytab。如果名称混合大小写或包含特殊字符,请加上双引号,例如 "FooBar";不带引号时,字符串会被折叠为小写。
primary_key_attnums
主键字段的属性编号(从 1 开始),例如 1 2。
num_primary_key_atts主键字段的数量。
src_pk_att_vals_array用于查找本地元组的主键字段的值。每个字段以文本形式表示。如果没有具有这些主键值的本地行,将抛出错误。
tgt_pk_att_vals_array
要放入结果 UPDATE 命令中的主键字段的值。每个字段以文本形式表示。
以文本形式返回所请求的 SQL 语句。
从 PostgreSQL 9.0 起,primary_key_attnums 中的属性编号被解释为逻辑列号,对应于该列在 SELECT * FROM relname 中的位置。以前的版本把这些编号解释为物理列位置。如果在表的存续期间指示列左侧的某些列被删除过,两者会有差别。
SELECT dblink_build_sql_update('foo', '1 2', 2, '{"1", "a"}', '{"1", "b"}');
dblink_build_sql_update
-------------------------------------------------------------
UPDATE foo SET f1='1',f2='b',f3='1' WHERE f1='1' AND f2='b'
(1 row)