doc-fr/reference/pgsql/functions/pg-put-line.xml at 54fdd1e1d779932d6866717a87b30cfd870b3f31 · lacatoire/doc-fr · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c43a3cd9b49627b8d42a4b6ad530e10e26ca30dd Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pg-put-line" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_put_line</refname>
  <refpurpose>
   Envoie une chaîne au serveur PostgreSQL
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>pg_put_line</methodname>
   <methodparam choice="opt"><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>pg_put_line</function> envoie une chaîne (terminée
   par &null;) au serveur PostgreSQL. Ceci est nécessaire en conjonction avec
   une commande <literal>COPY FROM</literal> PostgreSQL.
  </para>
  <para><literal>COPY</literal> 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.
  </para>
  <para>
   Une alternative plutôt que d'utiliser la commande brute
   <function>pg_put_line</function> est d'utiliser
   <function>pg_copy_from</function>. C'est une interface bien plus simple.
  </para>
  <note>
   <para>
    À noter que l'application doit explicitement ajouter les deux caractères
    "\." à la fin de la chaîne pour indiquer au serveur qu'elle a fini
    d'envoyer des données, avant d'appeler <function>pg_end_copy</function>.
   </para>
  </note>
  <warning>
   <para>
    L'utilisation de <function>pg_put_line</function> cause sur la plupart des
    objets de grande taille à échouer, incluant <function>pg_lo_read</function>
    et <function>pg_lo_tell</function>. Il est possible d'utiliser
    <function>pg_copy_from</function> et <function>pg_copy_to</function> à la
    place.
   </para>
  </warning>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      &pgsql.parameter.connection-with-unspecified-default;
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       Une ligne de texte à envoyer directement au serveur PostgreSQL. Un
       caractère d'arrêt &null; est automatiquement ajouté.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     &pgsql.changelog.connection-object;
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <function>pg_put_line</function></title>
    <programlisting role="php">
<![CDATA[
<?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);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pg_end_copy</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->