pg_copy_to

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    pg_copy_to — 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

    VersionBeschreibung
    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
    To Top