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|Traversable $rows,
    string $separator = "\t",
    string $null_as = "\\\\N"
): bool

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

参数

connection

PgSql\Connection 实例。

table_name

复制 rows 到其中的表名。

rows

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

separator

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

null_as

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

返回值

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

更新日志

版本 说明
8.5.0 rows 现在是 iterable 类型。 之前是 array 类型。
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);
?>

参见