mysql-unbuffered-query.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: andresdzphp Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.mysql-unbuffered-query" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysql_unbuffered_query</refname>
  <refpurpose>Envía una consulta SQL a MySQL, sin recuperar ni almacenar en búfer las filas de resultados</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member>See: <link linkend="mysqlinfo.concepts.buffering">Consultas almacenadas y no almacenadas en buffer</link></member>
   </simplelist>
  </warning>
 </refsynopsisdiv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>mysql_unbuffered_query</methodname>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
   <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>mysql_unbuffered_query</function> envía la consulta SQL
   <parameter>query</parameter> a MySQL, sin recuperar ni almacenar automáticamente
   en búfer las filas de resultados, como
   <function>mysql_query</function> lo hace. Esto ahorra una considerable
   cantidad de memoria con las consultas SQL que producen conjuntos de resultados grandes,
   y se puede empezar a trabajar con el conjunto de resultados inmediatamente después de
   que la primera fila haya sido recuperada, ya que no es necesario esperar hasta que la
   consulta SQL completa haya sido ejecutada. Para usar
   <function>mysql_unbuffered_query</function> mientras están abiertas
   múltiples conexiones a la base de datos, se debe especificar el parámetro opcional
   <parameter>link_identifier</parameter> para identificar qué conexión
   se desea utilizar.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       La consulta SQL a ejecutar.
      </para>
      <para>
       Los datos dentro de la consulta deben estar <link
       linkend="function.mysql-real-escape-string">propiamente escapados</link>.
      </para>
     </listitem>
    </varlistentry>
    &mysql.linkid.description;
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Para sentencias SELECT, SHOW, DESCRIBE o EXPLAIN,
   <function>mysql_unbuffered_query</function>
   devuelve un <type>resource</type> en caso de éxito, o &false; en caso
   de error.
  </para>
  <para>
   Para otro tipo de sentencias SQL, UPDATE, DELETE, DROP, etc,
   <function>mysql_unbuffered_query</function> devuelve &true; en caso de éxito
   o &false; en caso de error.
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Los beneficios de <function>mysql_unbuffered_query</function> tienen
    un precio: no se puede usar <function>mysql_num_rows</function> ni
    <function>mysql_data_seek</function> en un conjunto de resultados devuelto por
    <function>mysql_unbuffered_query</function>, hasta que todas las filas sean recuperadas.
    También se tendrán que recuperar todas las filas de resultados de una consulta SQL no almacenada en búfer
    antes de poder enviar una nueva consulta SQL a MySQL, usando el mismo 
    <parameter>link_identifier</parameter>.
   </para>
  </note>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mysql_query</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
-->