pg_copy_to
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_copy_to — Kopiert eine Tabelle in ein Array
Beschreibung
PgSql\Connection
$connection
,string
$table_name
,string
$separator
= "\t",string
$null_as
= "\\\\N"): array|false
pg_copy_to() kopiert eine Tabelle in ein Array. Intern
wird das SQL-Kommando COPY TO
aufgerufen, um die
Datensätze einzufügen.
Parameter-Liste
-
connection
-
Eine PgSql\Connection-Instanz.
-
table_name
-
Der Name der Tabelle, aus der die Daten in das Array
rows
kopiert werden. -
separator
-
Der Feldbegrenzer, mit dem die Werte in den Elementen von
rows
separiert werden. Der Vorgabewert ist\t
. -
null_as
-
Bestimmt, wie SQL
NULL
-Werte inrows
dargestellt werden. Der Standardwert ist\\N
("\\\\N"
).
Rückgabewerte
Die Funktion gibt ein array zurück, in dem jedes Element eine
Zeile der mit COPY
erzeugten Daten enthält. Bei einem Fehler wird false
zurückgegeben.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter connection erwartet nun eine PgSql\Connection-Instanz;
vorher wurde eine Ressource erwartet.
|
Beispiele
Beispiel #1 pg_copy_to()-Beispiel
<?php
$db = pg_connect("dbname=publisher") or die("Konnte keine Verbindung aufbauen");
$rows = pg_copy_to($db, $table_name);
pg_query($db, "DELETE FROM $table_name");
pg_copy_from($db, $table_name, $rows);
?>