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