<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.mongodb-driver-server.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'mongodb-driver-server.executereadwritecommand.php',
    1 => 'MongoDB\\Driver\\Server::executeReadWriteCommand',
    2 => 'Ejecuta un comando de base de datos que lee y escribe en este servidor',
  ),
  'up' => 
  array (
    0 => 'class.mongodb-driver-server.php',
    1 => 'MongoDB\\Driver\\Server',
  ),
  'prev' => 
  array (
    0 => 'mongodb-driver-server.executereadcommand.php',
    1 => 'MongoDB\\Driver\\Server::executeReadCommand',
  ),
  'next' => 
  array (
    0 => 'mongodb-driver-server.executewritecommand.php',
    1 => 'MongoDB\\Driver\\Server::executeWriteCommand',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/mongodb/mongodb/driver/server/executereadwritecommand.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mongodb-driver-server.executereadwritecommand" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">MongoDB\Driver\Server::executeReadWriteCommand</h1>
  <p class="verinfo">(mongodb &gt;=1.4.0)</p><p class="refpurpose"><span class="refname">MongoDB\Driver\Server::executeReadWriteCommand</span> &mdash; <span class="dc-title">Ejecuta un comando de base de datos que lee y escribe en este servidor</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-mongodb-driver-server.executereadwritecommand-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">final</span> <span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><strong>MongoDB\Driver\Server::executeReadWriteCommand</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$db</code></span>, <span class="methodparam"><span class="type"><a href="class.mongodb-driver-command.php" class="type MongoDB\Driver\Command">MongoDB\Driver\Command</a></span> <code class="parameter">$command</code></span>, <span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$options</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><a href="class.mongodb-driver-cursor.php" class="type MongoDB\Driver\Cursor">MongoDB\Driver\Cursor</a></span></div>

  <p class="simpara">
   Ejecuta el comando en este servidor.
  </p>
  <p class="simpara">
   Este método aplicará una lógica específica a los comandos de lectura y escritura
   (por ejemplo <a href="https://www.mongodb.com/docs/manual/reference/command/aggregate/" class="link external">&raquo;&nbsp;aggregate</a>).
   Los valores por omisión para las opciones <code class="literal">&quot;readConcern&quot;</code> y
   <code class="literal">&quot;writeConcern&quot;</code> serán deducidos de una transacción activa (indicada por
   la opción <code class="literal">&quot;session&quot;</code>), seguida de la
   <a href="mongodb-driver-manager.construct.php#mongodb-driver-manager.construct-uri" class="link">URI de conexión</a>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-mongodb-driver-server.executereadwritecommand-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
   
    <dt><code class="parameter">db</code> (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)</dt>
    <dd>
     <span class="simpara">
      El nombre de la base de datos sobre la cual se ejecutará el comando.
     </span>
    </dd>
   

   
   
    <dt><code class="parameter">command</code> (<span class="classname"><a href="class.mongodb-driver-command.php" class="classname">MongoDB\Driver\Command</a></span>)</dt>
    <dd>
     <span class="simpara">
      El comando a ejecutar.
     </span>
    </dd>
   

   
    <dt><code class="parameter">options</code></dt>
    <dd>
     <p class="para">
      <table class="doctable table">
       <caption><strong>options</strong></caption>
       
        <thead>
         <tr>
          <th>Opción</th>
          <th>Tipo</th>
          <th>Descripción</th>
         </tr>

        </thead>

        <tbody class="tbody">
         
         <tr>
          <td>readConcern</td>
          <td><span class="classname"><a href="class.mongodb-driver-readconcern.php" class="classname">MongoDB\Driver\ReadConcern</a></span></td>
          <td>
           <span class="simpara">
            Una preocupación de lectura a aplicar a la operación.
           </span>
           <span class="simpara">
            Esta opción está disponible en MongoDB 3.2+ y se traducirá en una excepción en el
            momento de la ejecución si se especifica para una versión más antigua del
            servidor.
           </span>
          </td>
         </tr>


         
         <tr>
          <td>session</td>
          <td><span class="classname"><a href="class.mongodb-driver-session.php" class="classname">MongoDB\Driver\Session</a></span></td>
          <td>
           <span class="simpara">
            Una sesión a asociar a la operación.
           </span>
          </td>
         </tr>


         
         <tr>
          <td>writeConcern</td>
          <td><span class="classname"><a href="class.mongodb-driver-writeconcern.php" class="classname">MongoDB\Driver\WriteConcern</a></span></td>
          <td>
           <span class="simpara">
            Una preocupación de escritura a aplicar a la operación.
           </span>
          </td>
         </tr>


        </tbody>
       
      </table>

     </p>
     
     <div class="warning"><strong class="warning">Advertencia</strong>
      <p class="simpara">
       Si se utiliza una <code class="literal">&quot;session&quot;</code> que tiene una transacción en
       curso, no se puede especificar la opción <code class="literal">&quot;readConcern&quot;</code> o
       <code class="literal">&quot;writeConcern&quot;</code>. Intentar hacer esto lanzará una excepción
       <span class="classname"><a href="class.mongodb-driver-exception-invalidargumentexception.php" class="classname">MongoDB\Driver\Exception\InvalidArgumentException</a></span>
       . En su lugar, debe definir estas opciones cuando se crea
       la transacción con
       <span class="methodname"><a href="mongodb-driver-session.starttransaction.php" class="methodname">MongoDB\Driver\Session::startTransaction()</a></span>.
      </p>
     </div>

    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-mongodb-driver-server.executereadwritecommand-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">Retorna un <span class="classname"><a href="class.mongodb-driver-cursor.php" class="classname">MongoDB\Driver\Cursor</a></span> en caso de éxito.</p>
 </div>


 <div class="refsect1 errors" id="refsect1-mongodb-driver-server.executereadwritecommand-errors">
  <h3 class="title">Errores/Excepciones</h3>
  <ul class="simplelist">
   <li>Lanza una excepción <span class="classname"><a href="class.mongodb-driver-exception-invalidargumentexception.php" class="classname">MongoDB\Driver\Exception\InvalidArgumentException</a></span> si la opción <code class="literal">&quot;session&quot;</code> se utiliza con una transacción asociada en combinación con una opción <code class="literal">&quot;readConcern&quot;</code> o <code class="literal">&quot;writeConcern&quot;</code>.</li>
   <li>Lanza una excepción <span class="classname"><a href="class.mongodb-driver-exception-invalidargumentexception.php" class="classname">MongoDB\Driver\Exception\InvalidArgumentException</a></span> si la opción <code class="literal">&quot;session&quot;</code> se utiliza junto con una preocupación de escritura no reconocida.</li>
   <li>Lanza una excepción <span class="classname"><a href="class.mongodb-driver-exception-invalidargumentexception.php" class="classname">MongoDB\Driver\Exception\InvalidArgumentException</a></span> en caso de error durante el análisis de un argumento.</li><li>Lanza una excepción <span class="classname"><a href="class.mongodb-driver-exception-connectionexception.php" class="classname">MongoDB\Driver\Exception\ConnectionException</a></span> si la conexión al servidor falla por una razón distinta a un problema de identificación</li><li>Lanza una excepción <span class="classname"><a href="class.mongodb-driver-exception-authenticationexception.php" class="classname">MongoDB\Driver\Exception\AuthenticationException</a></span> si se requiere una identificación pero falla</li>
   <li>Lanza una <span class="classname"><a href="class.mongodb-driver-exception-runtimeexception.php" class="classname">MongoDB\Driver\Exception\RuntimeException</a></span> en caso de otros errores (por ejemplo: comando inválido).</li>
  </ul>
 </div>


 <div class="refsect1 changelog" id="refsect1-mongodb-driver-server.executereadwritecommand-changelog">
  <h3 class="title">Historial de cambios</h3>

   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Versión</th>
       <th>Descripción</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>PECL mongodb 1.4.4</td>
       <td>
        Una <span class="classname"><a href="class.mongodb-driver-exception-invalidargumentexception.php" class="classname">MongoDB\Driver\Exception\InvalidArgumentException</a></span>
        será lanzada si la opción <code class="literal">&quot;session&quot;</code> es utilizada en
        combinación con un writeConcern no reconocido.
       </td>
      </tr>

     </tbody>
    
   </table>


 </div>


 <div class="refsect1 notes" id="refsect1-mongodb-driver-server.executereadwritecommand-notes">
  <h3 class="title">Notas</h3>
  
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    Es responsabilidad del llamante asegurarse de que el servidor sea capaz de ejecutar la
    operación de escritura. Por ejemplo, la ejecución de una operación de escritura
    en un secundario (excluyendo su base de datos &quot;local&quot;) fallará.
   </span>
  </p></blockquote>

 </div>


 <div class="refsect1 seealso" id="refsect1-mongodb-driver-server.executereadwritecommand-seealso">
  <h3 class="title">Véase también</h3>
  <ul class="simplelist">
   <li><span class="classname"><a href="class.mongodb-driver-command.php" class="classname">MongoDB\Driver\Command</a></span></li>
   <li><span class="classname"><a href="class.mongodb-driver-cursor.php" class="classname">MongoDB\Driver\Cursor</a></span></li>
   <li><span class="function"><a href="mongodb-driver-server.executecommand.php" class="function" rel="rdfs-seeAlso">MongoDB\Driver\Server::executeCommand()</a> - Ejecuta un comando de base de datos en este servidor</span></li>
   <li><span class="function"><a href="mongodb-driver-server.executereadcommand.php" class="function" rel="rdfs-seeAlso">MongoDB\Driver\Server::executeReadCommand()</a> - Ejecuta un comando de base de datos que lee en este servidor</span></li>
   <li><span class="function"><a href="mongodb-driver-server.executewritecommand.php" class="function" rel="rdfs-seeAlso">MongoDB\Driver\Server::executeWriteCommand()</a> - Ejecuta un comando de base de datos que escribe en este servidor</span></li>
   <li><span class="function"><a href="mongodb-driver-manager.executereadwritecommand.php" class="function" rel="rdfs-seeAlso">MongoDB\Driver\Manager::executeReadWriteCommand()</a> - Ejecuta un comando de base de datos que lee y escribe</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>