array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.pg-copy-from.php', 1 => 'pg_copy_from', 2 => 'Вставляет записи из массива в таблицу', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Функции PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-convert.php', 1 => 'pg_convert', ), 'next' => array ( 0 => 'function.pg-copy-to.php', 1 => 'pg_copy_to', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/pgsql/functions/pg-copy-from.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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