Kopiert eine Tabelle in ein Array

Beschreibung

pg_copy_to(
    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 in rows 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);
?>

Siehe auch

pg_copy_from() - Fügt Datensätze aus einem Array in eine Tabelle ein