1
0
mirror of https://github.com/php/doc-de.git synced 2026-03-31 03:32:12 +02:00
Files
archived-doc-de/reference/pgsql/functions/pg-send-query.xml
Cornelia Boenigk 924379e828 syncing to en-version
git-svn-id: https://svn.php.net/repository/phpdoc/de/trunk@247192 c90b9560-bf6c-de11-be94-00142212c4b1
2007-11-27 21:26:22 +00:00

148 lines
4.2 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- EN-Revision: 1.15 Maintainer: conni Status: ready -->
<refentry xml:id='function.pg-send-query' xmlns="http://docbook.org/ns/docbook">
<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>
<para>
<function>pg_send_query</function> sendet eine oder mehrere asynchrone
Abfragen über die Verbindung <parameter>connection</parameter>. Im
Unterschied zu <function>pg_query</function> können hier mehrere
Abfragen auf einmal an PostgreSQL gesendet 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 Abfragen gelöscht werden.
</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 eine Abfrage gesendet wird, 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.
</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
-->