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) 返回 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 命令中的主键字段值。每个字段都以文本形式表示。
以 text 形式返回所请求的 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)
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。