Вставляет записи из массива в таблицу

# pg_copy_from

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

pg_copy_from — Вставляет записи из массива в таблицу

### Описание

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

pg_copy_from() вставляет записи в таблицу из массива `rows`. В ходе выполнения вызывает SQL-команду `COPY FROM` для вставки записей.

### Список параметров

`connection`
  Экземпляр класса PgSql\Connection.
`table_name`

  Имя таблицы, в которую копируются значения из `rows`.

`rows`

  Итерируемое значение (iterable) данных для копирования в `table_name`. Каждое значение в `rows` становится строкой в `table_name`. Каждое значение должно быть строкой с разделителем, содержащей значения для вставки в каждое поле таблицы. Значения должны заканчиваться символом перевода строки.

`separator`

  Символ, отделяющий значения друг от друга в каждом элементе массива `rows`. По умолчанию `\t`.

`null_as`

  Определяет, каким образом значения SQL `NULL` представлены в массиве `rows`. По умолчанию `\\N` (`"\\\\N"`).

### Возвращаемые значения

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Список изменений

Версия | Описание
--- | ---
8.5.0 | Значение параметра `rows` теперь является итерируемым значением (iterable). Ранее оно было массивом (array).
8.1.0 | Параметр `connection` теперь принимает объект PgSql\Connection; раньше параметр принимал тип resource.

### Примеры

Пример #1 Пример использования pg_copy_from()

    <?php
       $db = pg_connect("dbname=publisher") or die("Не удалось подключиться");

       $rows = pg_copy_to($db, $table_name);

       pg_query($db, "DELETE FROM $table_name");

       pg_copy_from($db, $table_name, $rows);
    ?>

### Смотрите также

- pg_copy_to() - Копирует данные из таблицы в массив

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