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', ), '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', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_copy_from — Вставляет записи из массива в таблицу
$connection
,$table_name
,$rows
,$separator
= "\t",$null_as
= "\\\\N"
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);
?>