Fügt Datensätze aus einem Array in eine Tabelle ein

# 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

function pg_copy_from(
PgSql\Connection `$connection`,
string `$table_name`,
array|Traversable `$rows`,
string `$separator` = "\t",
string `$null_as` = "\\\\N"
): bool

pg_copy_from() fügt Datensätze aus `rows` in eine Tabelle ein. Intern wird dazu der `COPY FROM`-SQL-Befehl verwendet.

### Parameter-Liste

`connection`

  Eine PgSql\Connection-Instanz.

`table_name`

  Name der Tabelle, in die die `rows` eingefügt werden.

`rows`

  iterable Daten, die in `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

Version | Beschreibung
--- | ---
8.5.0 | `rows` hat nun den Typ iterable; vorher war er vom Typ array.
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

- pg_copy_to() - Kopiert eine Tabelle in ein Array

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open