Postgresql 中文操作指南

dblink_build_sql_update — 使用本地元组构建 UPDATE 语句,用备用提供的数值替换主键字段数值

Synopsis

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

Description

dblink_build_sql_update 可以帮助将本地表有目的地复制到远程数据库。它根据主键从本地表选择一行,然后构建一个 SQL UPDATE 命令,该命令将复制该行,但主键数值将替换为最后一个参数中的数值。(若要对该行进行完全复制,只需为最后两个参数指定相同的值即可。) UPDATE 命令始终分配该行的所有字段,其与 dblink_build_sql_insert 的主要区别在于它假设目标行已存在于远程表中。

Arguments

  • relname

    • 本地关系的名称,例如 foomyschema.mytab 。如果名称为混合大小写或包含特殊字符,请使用双引号,例如 "FooBar" ;不使用引号,字符串将折叠为小写。

  • primary_key_attnums

    • 主键字段的属性编号(以 1 为基数),例如 1 2

  • num_primary_key_atts

    • 主键字段的数量。

  • src_pk_att_vals_array

    • 用于查找本地元组的主键字段的值。每个字段都以文本形式表示。如果没有具有这些主键值的行,则会抛出错误。

  • tgt_pk_att_vals_array

    • 要放入所得 UPDATE 命令中的主键字段的值。每个字段都以文本形式表示。

Return Value

返回所请求的 SQL 语句作为文本。

Notes

截至 PostgreSQL 9.0, primary_key_attnums 中的属性编号被解释为逻辑列编号,对应于该列在 SELECT * FROM relname 中的位置。以前版本将数字解释为物理列位置。如果在表的生命周期内删除了指示列左侧的任何列,则会有差异。

Examples

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)