archived-doc-de/reference/pgsql/functions/pg-send-query.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- EN-Revision: 1.13 Maintainer: conni Status: ready -->
<refentry id='function.pg-send-query'>
 <refnamediv>
  <refname>pg_send_query</refname>
  <refpurpose>
   Sendet eine asynchrone Abfrage
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>pg_send_query</methodname>
   <methodparam><type>resource</type><parameter>connection</parameter></methodparam>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
  </methodsynopsis>
  <methodsynopsis>
   <type>bool</type><methodname>pg_send_query</methodname>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>pg_send_query</function> sendet eine oder mehrere asynchrone
   Abfragen auf der Verbindung <parameter>connection</parameter>. Im
   Unterschied zu <function>pg_query</function> können hier mehrere
   Abfragen auf einmal an den Server gesendet werden und die Ergebnisse
   nacheinander mit <function>pg_get_result</function> geholt werden.
  </para>
  <para>
   Die Ausführung eines Skripts wird während der Abarbeitung der Anfragen
   nicht blockiert. Benutzen Sie die Funktion <function>pg_connection_busy</function>
   um zu prüfen, ob die Verbindung gerade benutzt wird (z.B. ob gerade
   eine Abfrage ausgeführt wird). Mit der Funktion    <function>pg_cancel_query</function>
   können Sie die Abfrage löschen. 
  </para>
  <para>
   Obwohl man mehrere Abfragen auf einmal an den Server senden kann,
   können die Abfragen nicht über eine gerade benutzte Verbindung 
   geschickt werden. Falls die Abfragen gesendet werden, während die
   Verbindung benutzt wird, wird abgewartet, bis die letzte Abfrage
   fertig ist und alle Ergebnisse werden verworfen.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      <para>
       PostgreSQL Verbindungkennung. Falls <parameter>connection</parameter>
       nicht angegeben wurde, wird die zuletzt mit <function>pg_connect</function> oder
        <function>pg_pconnect</function> geöffnete Verbindung benutzt.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       Das oder die SQL-Anweisung(en), die ausgeführt werden sollen.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>&return.success;</para>
  <para>
   Benutzen Sie <function>pg_get_result</function> um die Abfrageergebnisse zu ermitteln.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>pg_send_query</function> Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
  $dbconn = pg_connect("dbname=publisher") or die("Verbindungsaufbau fehlgeschlagen");

  if (!pg_connection_busy($dbconn)) {
      pg_send_query($dbconn, "select * from authors; select count(*) from authors;");
  }

  $res1 = pg_get_result($dbconn);
  echo "Der erste Aufruf von pg_get_result(): $res1\n";
  $rows1 = pg_num_rows($res1);
  echo "$res1 hat $rows1 Zeilen\n\n";
  
  $res2 = pg_get_result($dbconn);
  echo "Der zweite Aufruf von pg_get_result(): $res2\n";
  $rows2 = pg_num_rows($res2);
  echo "$res2 hat $rows2 Zeilen\n";  
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Der erste Aufruf von pg_get_result(): Resource id #3
Resource id #3 hat 3 Zeilen

Der zweite Aufruf von pg_get_result(): Resource id #4
Resource id #4 hat 1 Zeilen
]]>
    </screen>
   </example> 
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pg_query</function></member>
    <member><function>pg_cancel_query</function></member>
    <member><function>pg_get_result</function></member>
    <member><function>pg_connection_busy</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:"../../../../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
-->