函数名称:pg_copy_from()
适用版本:PHP 5 >= 5.4.0, PHP 7, PostgreSQL >= 9.0
用法: pg_copy_from()函数用于将数据从一个文件或字符串复制到PostgreSQL数据库表中。这个函数提供了一种高效的方式来插入大量数据。
语法: bool pg_copy_from(resource $connection, string $table_name, array $rows[, string $delimiter = '\t'[, string $null_as = '\N']])
参数:
- $connection:一个有效的 PostgreSQL 连接资源。
- $table_name:要插入数据的目标表的名称。
- $rows:包含要插入的数据的数组。每个数组元素都表示一行数据。数组的每个元素又是一个包含字段值的数组。
- $delimiter(可选):指定行中字段的分隔符,默认为制表符(\t)。
- $null_as(可选):指定空值的字符串表示,默认为"\N"。
返回值: 如果成功插入数据,则返回true。如果失败,则返回false。
示例: <?php // 创建一个 PostgreSQL 连接 $conn = pg_connect("host=localhost dbname=mydb user=myuser password=mypassword");
// 准备要插入的数据 $rows = array( array('John', 'Doe', 'john@example.com'), array('Jane', 'Smith', 'jane@example.com'), array('Bob', 'Johnson', 'bob@example.com'), );
// 将数据插入到表中 if (pg_copy_from($conn, 'users', $rows, ',', '\N')) { echo "数据插入成功!"; } else { echo "数据插入失败!"; }
// 关闭数据库连接 pg_close($conn); ?> 以上示例演示了如何使用pg_copy_from()函数将数据插入到名为"users"的表中。在这个例子中,我们首先创建了一个PostgreSQL连接,然后准备了要插入的数据。接下来,我们调用pg_copy_from()函数来执行插入操作。最后,我们关闭了数据库连接。
请注意,示例中的$delimiter和$null_as参数分别设置为逗号(,)和"\N"。这意味着每个字段之间使用逗号分隔,空值的表示为"\N"。你可以根据实际需求自行调整这些参数。