dblink_build_sql_update

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可用于对本地表进行选择性复制到远程数据库。它根据主键从本地表中选择一行，然后构建一个 SQLUPDATE命令，该命令将复制该行，但将主键值替换为最后一个参数中的值。（要对行进行精确复制，只需对最后两个参数指定相同的值。）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 语句。

备注

从PostgreSQL9.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)