Edit Report a Bug

pg_copy_to

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

pg_copy_to — Copy a table to an array

Description

pg_copy_to ( resource $connection , string $table_name [, string $delimiter [, string $null_as ]] ) : array

pg_copy_to() copies a table to an array. It issues COPY TO SQL command internally to retrieve records.

Parameters

connection: PostgreSQL database connection resource.
table_name: Name of the table from which to copy the data into rows.
delimiter: The token that separates values for each field in each element of rows. Default is TAB.
null_as: How SQL NULL values are represented in the rows. Default is \N ("\\N").

Return Values

An array with one element for each line of COPY data. It returns FALSE on failure.

Examples

Example #1 pg_copy_to() 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);
?>

User Contributed Notes 2 notes

down

setantae at submonkey dot net ¶

16 years ago


"It issues COPY TO SQL command internally to insert records"

I suspect this statement is incorrect, or that s/insert/retrieve/ is appropriate.

down

-3

etiger13 at gmail dot com ¶

9 years ago


You cannot specify the schema name in this command. You can change the search path for just one query by using the following code: 


<?php

pg_query($conn, "SET search_path TO myschema;");

    

$copy_to = pg_copy_to($conn, 'tablename');

    

pg_query("RESET search_path;");

?>

add a note