pg_copy_from
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_copy_from — Fügt Datensätze aus einem Array in eine Tabelle ein
Beschreibung
PgSql\Connection
$connection,string
$table_name,array
$rows,string
$separator = "\t",string
$null_as = "\\\\N"): bool
pg_copy_from() fügt Datensätze aus einem Array in
eine Tabelle ein. Intern wird der COPY-Befehl
aufgerufen, um die Datensätze einzufügen. Bei Erfolg gibt die
Funktion true zurück, false sonst.
Parameter-Liste
-
connection -
Eine PgSql\Connection-Instanz.
-
table_name -
Name der Tabelle, in die die
rowseingefügt werden. -
rows -
Ein array mit Werten, die in die
table_nameeingefügt werden. Jedes Element vonrowswird zu einer Zeile intable_name. Die Elemente inrowsmüssen Strings mit Feldbegrenzern sein, und mit einem Zeilenvorschub abgeschlossen sein. -
separator -
Der Feldbegrenzer, mit dem die Werte in den Elementen von
rowssepariert werden. Der Vorgabewert ist\t. -
null_as -
Bestimmt, wie SQL
NULLWerte inrowsdargestellt werden. Der Standardwert ist\\N("\\\\N").
Rückgabewerte
Gibt bei Erfolg true zurück. 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_from() 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);
?>
