PostgreSQL Elephant Logo
2025年9月25日: PostgreSQL 18 发布!
dblink_build_sql_update
上一步  上一级 F.11. dblink — 连接到其他 PostgreSQL 数据库 首页  下一步

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 在将本地表选择性复制到远程数据库时非常有用。它根据主键从本地表中选择一行,然后构建一个 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)

上一步  上一级  下一步
dblink_build_sql_delete  首页  F.12. dict_int — 整数示例全文搜索字典