Inserta filas en una tabla a partir de un array

# 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

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open