pg_copy_from

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

pg_copy_from — Inserta filas en una tabla a partir de un array

Descripción

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

pg_copy_from() inserta los elementos del array rows en una tabla. Esta función utiliza la orden SQL interna COPY FROM.

Parámetros

connection: Una instancia PgSql\Connection.
table_name: Nombre de la tabla en la que rows será copiado.
rows: Datos iterable a ser copiados dentro de table_name. Cada valor en rows se convierte en una fila en table_name. Cada valor en rows debería ser una cadena delimitada por valores a insertar dentro de cada campo. Los valores deben terminar con un salto de línea.
separator: El marcador que separa los valores para cada campo en cada elemento de rows. Por omisión \t.
null_as: Cómo se representan los valores NULL de SQL en rows. Por omisión \\N ("\\\\N").

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión	Descripción
8.5.0	`rows` es ahora de tipo iterable. Anteriormente, era de tipo array.
8.1.0	El parámetro `connection` ahora espera una instancia de PgSql\Connection ; anteriormente, se esperaba un resource.

Ejemplos

Ejemplo #1 Ejemplo con pg_copy_from()

<?php
   $db = pg_connect("dbname=publisher") or die("Conexión imposible");

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

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

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

Ver también

pg_copy_to() - Copia una tabla en un array