[edit] Last updated: Fri, 23 Mar 2012

pg_copy_from

(PHP 4 >= 4.2.0, PHP 5)

pg_copy_from — Wstawia wiersze do tabeli z tablicy

Opis

bool pg_copy_from ( resource $połączenie , string $nazwa_tabeli , array $wiersze [, string $delimiter [, string $null_jako ]] )

pg_copy_from() wstawia wiersze do tabeli z tablicy wiersze. Wywołuje wewnętrznie polecenie SQL COPY FROM aby wstawić wiersze. Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

Parametry

połączenie: Zasób, połączenie do bazy danych PostgreSQL.
nazwa_tabeli: Nazwa tabeli do której będą kopiowane wiersze.
wiersze: Tablica danych, które będą skopiowane do nazwa_tabeli. Każda wartość w wiersze stanie się wierszem w nazwa_tabeli. Każda wartość w wiersze powinna być łańcuchem znaków rozdzielonych wartości do wstawienia w każde pole. Wartości powinny być zakończone przejściem do nowej linii.
delimiter: Symbol jaki rozdziela wartości dla każdego pola w każdym elemencie wiersza. Domyślnie jest to TAB.
null_jako: Jak wartość SQL NULL jest reprezentowana w wierszu. Domyślnie jest to \N ("\\N").

Zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

Przykłady

Przykład #1 pg_copy_from() przykład


<?php
   $db = pg_connect("dbname=publisher") or die("Nie można się połączyć");
   
   $rows = pg_copy_to($db, $table_name);
   
   pg_query($db, "DELETE FROM $table_name");
   
   pg_copy_from($db, $table_name, $rows);
?>

Zobacz też:

pg_copy_to() - Kopiuje tabelę do tablicy

pg_copy_to

pg_convert

[edit] Last updated: Fri, 23 Mar 2012

add a note User Contributed Notes pg_copy_from

Dave 26-Jan-2012 12:40


As of postgresql 9.1 "standard_conforming_strings" is set to on



This will not work anymore

<?php

$copy_message = "1\t\\N\t300";

pg_copy_from($db, "message", $copy_message);

?>

result will be a "N" in that field. if the field allow text that is else it will fail to insert the post.



simple fix

<?php

$copy_message = "1\t\\NULL\t300";

pg_copy_from($db, "message", $copy_message, "\t","\\NULL");

?>

Dave 18-Feb-2011 04:39


Fix for "Copy command failed: ERROR: literal carriage return


found in data" or 


"Copy command failed: ERROR: missing data for column


"message" CONTEXT: COPY message, line 1:"





<?php


$message = "HEJ\rHEJ\nHEJ\r\nHEJ\n\rHEJ\tHELLO\\";





$message = addslashes($message);





$message = str_replace(


  array("\n","\r","\t"),


  array("\\n","\\r","\\t"),


  $message);





$copy_message = "1\t". $message ."\t300";





pg_copy_from($db, "message", $copy_message);


?>

etiger13 at gmail dot com 17-Nov-2009 01:10


This will not look in other schema's, only the schema's in your search path. You can temporarily change this behavior with the following code:





<?php


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





$copy_from = pg_copy_from($conn, 'tablename', $filetoarray, ",");


    


if ( !$copy_from )


{


    echo pg_last_error($conn);


        


    exit;


}





pg_query("RESET search_path;");


?>

Anonymous 11-Jun-2009 06:08


see also: pg_put_line for a solution that does not require buffering of all the data to be copied,

kapouer_php at melix dot org 26-Aug-2007 05:24


pg syntax is :

COPY test (cola, colb, colc) FROM stdin;

...



this function doesn't let you in which order the columns are !

vlad at php dot net 19-Mar-2003 03:38


By default NULL values are a backslash followed with capital N ("\\N"). 



Also, you can't insert entries with OIDs (I've added it to my TODO list though)

carl at thep.lu.se 10-Sep-2002 05:06


Something needs to be said about the format of the array.

Judging by what I've seen, it's pretty much what you get

from loading a tab-separated file with file(). That is, the

lines are linefeed-terminated and there's no need to have

an extra line with "\.". On the other hand, when I try using this

command the connection to the server ends up in some odd

state and is then lost:

PHP Warning:  U�S�o() query failed: server closed the connection unexpectedly



I think it might be safer to use the lower-level function

pg_put_line() for now.

add a note