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)
如果您在文档中发现任何错误,与您对特定功能的体验不符或需要进一步澄清,请使用 此表格 报告文档问题。