pg_put_line
(PHP 4 >= 4.0.3, PHP 5)
pg_put_line — Envoie une cha�ne au serveur PostgreSQL
Description
pg_put_line() envoie une cha�ne (termin�e par NULL) au serveur PostgreSQL. Ceci est n�cessaire en conjonction avec une commande COPY FROM PostgreSQL.
COPY est un chargement tr�s rapide des donn�es support� par PostgreSQL. Les donn�es sont pass�es sans �tre analys�es et dans une simple transaction.
Une alternative plut�t que d'utiliser la commande brute pg_put_line() est d'utiliser pg_copy_from(). C'est une interface bien plus simple.
Note: Notez que l'application doit explicitement ajouter les deux caract�res "\." � la fin de la cha�ne pour indiquer au serveur qu'elle a finit d'envoyer des donn�es, avant d'appeler pg_end_copy().
L'utilisation de pg_put_line() cause sur la plupart des objets de grande taille � �chouer, incluant pg_lo_read() et pg_lo_tell(). Vous pouvez utiliser pg_copy_from() et pg_copy_to() � la place.
Liste de param�tres
- connection
-
La ressource de connexion de la base de donn�es PostgreSQL. Lorsque connection n'est pas pr�sent, la connexion par d�faut est utilis�e. La connexion par d�faut est la derni�re connexion faite par pg_connect() ou pg_pconnect().
- data
-
Une ligne de texte � envoyer directement au serveur PostgreSQL. Un caract�re d'arr�t NULL est automatiquement ajout�.
Valeurs de retour
Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec.
Exemples
Exemple #1 Exemple avec pg_put_line()
<?php
$conn = pg_pconnect("dbname=foo");
pg_query($conn, "create table bar (a int4, b char(16), d float8)");
pg_query($conn, "copy bar from stdin");
pg_put_line($conn, "3\tBonjour le monde\t4.5\n");
pg_put_line($conn, "4\tAurevoir le monde\t7.11\n");
pg_put_line($conn, "\\.\n");
pg_end_copy($conn);
?>