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

dblink_build_sql_insert

dblink_build_sql_insert — 使用本地元组构建 INSERT 语句,用提供的替代值替换主键字段值

概要

dblink_build_sql_insert(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_insert 可用于将本地表选择性地复制到远程数据库。它根据主键从本地表中选择一行,然后构建一个 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

要放入生成的 INSERT 命令中的主键字段值。每个字段都以文本形式表示。

返回值

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

注释

自 PostgreSQL 9.0 起,primary_key_attnums 中的属性号被解释为逻辑列号,对应于 SELECT * FROM relname 中列的位置。之前的版本将这些数字解释为物理列位置。如果指定的列左侧的任何列在表生命周期内已被删除,则存在差异。

示例

SELECT dblink_build_sql_insert('foo', '1 2', 2, '{"1", "a"}', '{"1", "b''a"}');
             dblink_build_sql_insert
--------------------------------------------------
 INSERT INTO foo(f1,f2,f3) VALUES('1','b''a','1')
(1 row)

上一步  上一级  下一步
dblink_get_pkey  首页  dblink_build_sql_delete