pg_copy_from

Insert records into a table from an array

&reftitle.description; `bool` `pg_copy_from` `PgSql\Connection` `connection` `string` `table_name` `array` `rows` `string` `separator`"\t" `string` `null_as`"\\\\N"

`pg_copy_from` inserts records into a table from `rows`. It issues a `COPY FROM` SQL command internally to insert records.

&reftitle.parameters;

`connection`

- &pgsql.parameter.connection;

`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"`).

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
&pgsql.changelog.connection-object;

&reftitle.examples;

### `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);
    ?>

&reftitle.seealso;

- `pg_copy_to`