# pg_copy_from

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_copy_from — 将数组中的记录插入到表

### 说明

pg_copy_from(
PgSql\Connection `$connection`,
string `$table_name`,
array `$rows`,
string `$separator` = "\t",
string `$null_as` = "\\\\N"
): bool

pg_copy_from() 将 `rows` 插入记录到表中。在内部发出 `COPY FROM` 命令以插入记录。

### 参数

`connection`

  PgSql\Connection 实例。

`table_name`

  复制 `rows` 到其中的表名。

`rows`

  要复制 array 中的数据到 `table_name`。`rows` 中的每个值都成为 `table_name` 中的一行。`rows` 中的每个值都应该用字符串分割以插入到每个字段。值应该换行终止。

`separator`

  `rows` 的每个元素分割为每个字段的值的标记。默认为 `\t`。

`null_as`

  SQL `NULL` 值在 `rows` 中的表示方式。默认为 `\\N`（`"\\\\N"`）。

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

### 更新日志

版本 | 说明
--- | ---
8.1.0 | 现在 `connection` 参数接受 PgSql\Connection 实例，之前接受 resource。

### 示例

示例 #1 pg_copy_from() 示例

`<?php
$db = pg_connect("dbname=publisher") or die("Could not connect");
$rows = pg_copy_to($db, $table_name);
pg_query($db, "DELETE FROM $table_name");
pg_copy_from($db, $table_name, $rows);
?>`

### 参见

- pg_copy_to() - 将表复制到数组

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open