Insère des lignes dans une table à partir d'un tableau

# pg_copy_from

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

pg_copy_from — Insère des lignes dans une table à partir d'un tableau

### Description

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

pg_copy_from() insère les éléments du tableau `rows` dans une table. Cette fonction utilise la commande SQL interne `COPY FROM`.

### Liste de paramètres

`connection`
  Une instance PgSql\Connection.
`table_name`

  Nom de la table dans laquelle `rows` sera copié.

`rows`

  Un iterable de données à copier dans `table_name`. Chaque valeur dans `rows` devient une ligne dans `table_name`. Chaque valeur dans `rows` devrait être une chaîne délimitée par des valeurs à insérer à l'intérieur de chaque champ. Les valeurs doivent être terminées par un saut à la ligne.

`separator`

  Le marqueur qui sépare les valeurs pour chaque champ dans chaque élément de `rows`. Par défaut `\t`.

`null_as`

  Comment les valeurs `NULL` de SQL sont représentées dans `rows`. Par défaut `\\N` (`"\\\\N"`).

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.5.0 | Le paramètre `rows` accepte désormais un iterable.
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple avec pg_copy_from()

    <?php
       $db = pg_connect("dbname=publisher") or die("Connexion impossible");

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

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

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

### Voir aussi

- pg_copy_to() - Copie une table dans un tableau

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