pg_copy_from

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

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

Описание

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

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

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

connection

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

table_name

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

rows

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

separator

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

null_as

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

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

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

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

Версия Описание
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() - Копирует данные из таблицы в массив