array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.pg-copy-from.php', 1 => 'pg_copy_from', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'PostgreSQL Functions', ), 'prev' => array ( 0 => 'function.pg-convert.php', 1 => 'pg_convert', ), 'next' => array ( 0 => 'function.pg-copy-to.php', 1 => 'pg_copy_to', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/pgsql/functions/pg-copy-from.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_copy_from — Insert records into a table from an array
$connection
,$table_name
,$rows
,$separator
= "\t",$null_as
= "\\\\N"
pg_copy_from() inserts records into a table from
rows
. It issues a COPY FROM
SQL command
internally to insert records.
connection
An PgSql\Connection instance.
table_name
Name of the table into which to copy the rows
.
rows
An array of data to be copied into table_name
.
Each value in rows
becomes a row in table_name
.
Each value in rows
should be a delimited string of the values
to insert into each field. Values should be linefeed terminated.
separator
The token that separates values for each field in each element of
rows
. Default is \t
.
null_as
How SQL NULL
values are represented in the
rows
. Default is \\N
("\\\\N"
).
Version | Description |
---|---|
8.1.0 |
The connection parameter expects an PgSql\Connection
instance now; previously, a resource was expected.
|
Example #1 pg_copy_from() example
<?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);
?>