array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pg-copy-from.php', 1 => 'pg_copy_from', 2 => 'Insère des lignes dans une table à partir d\'un tableau', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'pg_cancel_query', ), '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' => 'fr', '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 — Insère des lignes dans une table à partir d'un tableau

Description

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