## 数据库链接\_建造\_sql\_插入

数据库链接\_建造\_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`插入`命令将复制该行，但主键值被最后一个参数中的值替换。（要制作行的精确副本，只需为最后两个参数指定相同的值。）

## 论据

*`相对名称`*

本地关系的名称，例如`富`或者`myschema.mytab`.如果名称是大小写混合或包含特殊字符，请包括双引号，例如`“美食吧”`;没有引号，字符串将被折叠成小写。

*`primary_key_attnums`*

主键字段的属性号（从 1 开始），例如`1 2`.

*`num_primary_key_atts`*

主键字段的数量。

*`src_pk_att_vals_array`*

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

*`tgt_pk_att_vals_array`*

要放置在结果中的主键字段的值`插入`命令。每个字段都以文本形式表示。

## 返回值

以文本形式返回请求的 SQL 语句。

## 笔记

从 PostgreSQL 9.0 开始，属性编号在*`primary_key_attnums`*被解释为逻辑列号，对应于列在`SELECT * FROM 相对名称`.以前的版本将数字解释为物理列位置。如果在表的生命周期内已删除指示列左侧的任何列，则存在差异。

## 例子

```
SELECT dblink_build_sql_insert('foo', '1 2', 2, '{"1", "a"}', '{"1", "b''a"}');
             dblink_build_sql_insert
```