<?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="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="para rdfs-comment">
   Ejecuta el comando en este servidor.
  </p>
  <p class="para">
   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>
    <p class="para">
        El nombre de la base de datos sobre la cual se ejecutará el comando.
    </p>
</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>
    <p class="para">
        El comando a ejecutar.
    </p>
</dd>


   
    <dt><code class="parameter">options</code></dt>
    <dd>
     <p class="para">
      <table class="doctable table">
       <caption><strong>options</strong></caption>
       
        <thead>
         <tr>
          <th>Option</th>
          <th>Type</th>
          <th>Description</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>
    <p class="para">
        Una preocupación de lectura a aplicar a la operación.
    </p>
    <p class="para">
        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.
    </p>
</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>
    <p class="para">
        Una sesión a asociar a la operación.
    </p>
</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>
    <p class="para">
        Una preocupación de escritura a aplicar a la operación.
    </p>
</td>
</tr>


        </tbody>
       
      </table>

     </p>
     
<div class="warning"><strong class="warning">Advertencia</strong>
<p class="para">
    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="para">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"><strong class="classname">MongoDB\Driver\InvalidArgumentException</strong></span> en caso de error durante el análisis de un argumento.</li><li>Lanza una excepción <span class="classname"><strong class="classname">MongoDB\Driver\ConnectionException</strong></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"><strong class="classname">MongoDB\Driver\AuthenticationException</strong></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>
  <p class="para">
   <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>

  </p>
 </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">Ver 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); ?>