# 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

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

### Siehe auch

- pg_copy_to() - Kopiert eine Tabelle in ein Array

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