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

pg_copy_from(
    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 rows eingefügt werden.

rows

Ein array mit Werten, die in die table_name eingefügt werden. Jedes Element von rows wird zu einer Zeile in table_name. Die Elemente in rows müssen Strings mit Feldbegrenzern sein, und mit einem Zeilenvorschub abgeschlossen sein.

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 in rows dargestellt werden. Der Standardwert ist \\N ("\\\\N").

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

VersionBeschreibung
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);
?>

Siehe auch

To Top