<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.mysqlnd.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'mysqlnd.stats.php',
    1 => 'Estat&iacute;sticas',
    2 => 'Estat&iacute;sticas',
  ),
  'up' => 
  array (
    0 => 'book.mysqlnd.php',
    1 => 'Mysqlnd',
  ),
  'prev' => 
  array (
    0 => 'mysqlnd.persist.php',
    1 => 'Conex&otilde;es Persistentes',
  ),
  'next' => 
  array (
    0 => 'mysqlnd.notes.php',
    1 => 'Notas',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/mysqlnd/stats.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mysqlnd.stats" class="chapter">
 <h1 class="title">Estatísticas</h1>


 <p class="para">
  O Driver Nativo MySQL contém suporte para coleta de estatísticas sobre a
  comunicação entre o cliente e o servidor. As estatísticas
  recolhidas são de dois tipos principais:
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">Estatísticas de cliente</span>
   </li>
   <li class="listitem">
    <span class="simpara">Estatísticas de conexão</span>
   </li>
  </ul>
 </p>
 <p class="para">
  Ao usar a extensão <a href="book.mysqli.php" class="link">mysqli</a>, essas
  estatísticas poderão ser obtidas através de duas chamadas de API:
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara"><span class="function"><a href="function.mysqli-get-client-stats.php" class="function">mysqli_get_client_stats()</a></span></span>
   </li>
   <li class="listitem">
   <span class="simpara"><span class="function"><a href="mysqli.get-connection-stats.php" class="function">mysqli_get_connection_stats()</a></span></span>
   </li>
  </ul>
 </p>

 <blockquote class="note"><p><strong class="note">Nota</strong>: 
  <span class="simpara">
   As estatísticas são agregadas entre todas as extensões que utilizam o Driver Nativo
   MySQL.
   Por exemplo, se a extensão <a href="book.mysqli.php" class="link">mysqli</a>
   e o driver PDO MySQL estiverem ambos configurados para usar MySQLnd,
   as chamadas de função de <a href="book.mysqli.php" class="link">mysqli</a> e
   chamadas de métodos do PDO afetarão as estatísticas.
  </span>
  <span class="simpara">
   Não há como saber o quanto uma determinada chamada de API de qualquer extensão
   que tenha sido compilada contra o Driver Nativo MySQL tenha impactado uma determinada
   estatística.
  </span>
 </p></blockquote>

 <div id="mysqlnd.stats.retrieve" class="section">
  <h2 class="title">Obtendo estatísticas</h2>

  <p class="simpara">
   Estatísticas do cliente podem ser obtidas chamando a função
   <span class="function"><a href="function.mysqli-get-client-stats.php" class="function">mysqli_get_client_stats()</a></span>
  </p>

  <p class="simpara">
   Estatísticas de conexão podem ser obtidas chamando a função
   <span class="function"><a href="mysqli.get-connection-stats.php" class="function">mysqli_get_connection_stats()</a></span>.
  </p>

  <p class="simpara">
   Ambas as funções retornam um array associativo,
   onde o nome da estatística é a chave para o dado estatístico
   correspondente.
  </p>
 </div>

 <div id="mysqlnd.stats.statistics" class="section">
  <h2 class="title">Estatísticas do Driver Nativo MySQL</h2>
  <p class="simpara">
   A maior parte das estatíticas são associadas a uma conexão mas algumas são associadas
   ao processo, e neste caso isto será mencionado no texto.
   
  </p>
  <p class="simpara">
   As seguintes estatísticas são produzidas pelo Driver Nativo MySQL:
  </p>

  <dl>
   <strong class="title">Estatísticas Relacionadas à Rede</strong>

   
    <dt id="mysqlnd.stats.statistics.bytes-sent"><code class="literal">bytes_sent</code></dt>
    <dd>
     <span class="simpara">
      Número de bytes enviados do PHP para o servidor MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received"><code class="literal">bytes_received</code></dt>
    <dd>
     <span class="simpara">
      Número de bytes recebidos do servidor MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-sent"><code class="literal">packets_sent</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes enviados pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received"><code class="literal">packets_received</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.protocol-overhead-in"><code class="literal">protocol_overhead_in</code></dt>
    <dd>
     <span class="simpara">
      Sobrecarga do protocolo Cliente Servidor do MySQL em bytes para o tráfego de entrada.
      Atualmente apenas o Cabeçalho do Pacote (4 bytes) é considerado como sobrecarga.
      <code class="code">protocol_overhead_in = packets_received * 4</code>
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.protocol-overhead-out"><code class="literal">protocol_overhead_out</code></dt>
    <dd>
     <span class="simpara">
      Sobrecarga do protocolo Cliente Servidor do MySQL em bytes para o tráfego de saída.
      Atualmente apenas o Cabeçalho do Pacote (4 bytes) é considerado como sobrecarga.
      <code class="code">protocol_overhead_out = packets_received * 4</code>
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-ok-packet"><code class="literal">bytes_received_ok_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes de pacotes OK recebidos pelo protocolo Cliente Servidor do MySQL.
      Pacotes OK podem conter uma mensagem de status.
      O comprimento da mensagem de status pode variar e portanto o tamanho de um
      pacote OK não é fixo.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-ok"><code class="literal">packets_received_ok</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes OK recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-eof-packet"><code class="literal">bytes_received_eof_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes de pacotes EOF recebidos pelo protocolo Cliente Servidor do MySQL.
      EOF pode variar em tamanho dependendo da versão do servidor.
      Além disso, EOF pode transportar uma mensagem de erro.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-eof"><code class="literal">packets_received_eof</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes EOF recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
     <span class="simpara">
      Como acontece com outras estatísticas de pacotes, o número de pacotes será
      incrementado mesmo se o PHP não receber o pacote esperado mas,
      por exemplo, receber uma mensagem de erro.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-rset-header-packet"><code class="literal">bytes_received_rset_header_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes dos pacotes de cabeçalho do conjunto de resultados
      recebido pelo protocolo Cliente Servidor do MySQL.
      O tamanho dos pacotes varia dependendo da carga
      (<code class="literal">LOAD LOCAL INFILE</code>, <code class="literal">INSERT</code>,
      <code class="literal">UPDATE</code>, <code class="literal">SELECT</code>, mensagem de erro).
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-rset-header"><code class="literal">packets_received_rset_header</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes de cabeçalho de conjunto de resultados recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-rset-field-meta-packet"><code class="literal">bytes_received_rset_field_meta_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes de pacotes de metadados (informação de campo) de conjunto de resultados
      recebidos pelo protocolo Cliente Servidor do MySQL.
      É evidente que o tamanho varia com os campos no conjunto de resultados.
      O pacotes também pode transportar um pacote de erro ou de EOF em caso de
      COM_LIST_FIELDS.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-rset-field-meta"><code class="literal">packets_received_rset_field_meta</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotesde metadados (informação de campo) de conjunto de resultados
      recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-rset-row-packet"><code class="literal">bytes_received_rset_row_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes dos pacotes de dados de registros do conjunto de resultados
      recebidos pelo protocolo Cliente Servidor do MySQL.
      O pacote também pode transportar uma mensagem de erro ou de EOF.
      Pode-se computar o número de pacotes de erro e de EOF subtraindo-se
      <code class="literal">rows_fetched_from_server_normal</code>
      e <code class="literal">rows_fetched_from_server_ps</code>
      de <code class="literal">bytes_received_rset_row_packet</code>.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-rset-row"><code class="literal">packets_received_rset_row</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes de dados de registros do conjunto de resultados recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-prepare-response-packet"><code class="literal">bytes_received_prepare_response_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes dos pacotes de Inicialização OK para Instruções Preparadas (pacotes de
      inicialização de instrução preparada) recebidos pelo protocolo Cliente Servidor do MySQL.
      O pacote também pode transportar um erro.
      O tamanho do pacote depende da versão MySQL.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-prepare-response"><code class="literal">packets_received_prepare_response</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes de inicialização de instruções preparadas recebidos
      pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-change-user-packet"><code class="literal">bytes_received_change_user_packet</code></dt>
    <dd>
     <span class="simpara">
      Tamanho total em bytes de pacotes COM_CHANGE_USER recebidos pelo protocolo Cliente Servidor do MySQL.
      O pacote também pode transportar um erro ou um EOF.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       O tamanho total em bytes inclui o tamanho do pacote de cabeçalho.
       (4 bytes, consulte sobre sobrecarga do protocolo)
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-received-change-user"><code class="literal">packets_received_change_user</code></dt>
    <dd>
     <span class="simpara">
      Número de pacotes COM_CHANGE_USER recebidos pelo protocolo Cliente Servidor do MySQL.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.packets-sent-command"><code class="literal">packets_sent_command</code></dt>
    <dd>
     <span class="simpara">
      Número de comandos do protocolo Cliente Servidor do MySQL enviados pelo PHP ao MySQL.
     </span>
     <span class="simpara">
      Não há como saber quais foram os comandos específicos e quantos deles
      foram enviados.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-real-data_normal"><code class="literal">bytes_received_real_data_normal</code></dt>
    <dd>
     <span class="simpara">
      Número de bytes dos dados reais buscados pelo cliente PHP vindos do
      <code class="literal">mysqlnd</code> usando o protocolo de texto.
     </span>
     <span class="simpara">
      Este é o tamanho dos dados reais contidos nos conjuntos de resultados que não
      se originaram de instruções preparadas e que foram buscados pelo cliente PHP.
     </span>
     <span class="simpara">
      Observe que embora um conjunto de resultados completo possa ter sido puxado do MySQL
      pelo <code class="literal">mysqlnd</code>, esta estatística apenas conta dados reais
      puxados a partir do <code class="literal">mysqlnd</code> pelo cliente PHP.
     </span>
     <p class="para">
      A seguir é apresentado um exemplo de sequência de código que irá incrementar o valor:
      <div class="example-contents">
<div class="cdata"><pre>
$mysqli = new mysqli();
$res = $mysqli-&gt;query(&quot;SELECT &#039;abc&#039;&quot;);
$res-&gt;fetch_assoc();
$res-&gt;close();
</pre></div>
      </div>

      Cada operação de busca irá incrementar o valor.
     </p>
     <p class="para">
      Entretanto, a estatística não será incrementada se o conjunto de resultados estiver sujeito
      a buffer no lado do cliente mas não for buscado, como no exemplo a seguir:
      <div class="example-contents">
<div class="cdata"><pre>
$mysqli = new mysqli();
$res = $mysqli-&gt;query(&quot;SELECT &#039;abc&#039;&quot;);
$res-&gt;close();
</pre></div>
      </div>

     </p>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bytes-received-real-data-ps"><code class="literal">bytes_received_real_data_ps</code></dt>
    <dd>
     <span class="simpara">
      Número de bytes dos dados reais buscados pelo cliente PHP vindos do
      <code class="literal">mysqlnd</code> usando o protocolo de instruções preparadas.
     </span>
     <span class="simpara">
      Este é o tamanho dos dados reais contidos nos conjuntos de resultados que
      se originaram de instruções preparadas e que foram buscados pelo cliente PHP.
     </span>
     <span class="simpara">
      O valor não será incrementado se o conjunto de resultados não for subsequentemente lido pelo cliente PHP.
     </span>
     <span class="simpara">
      Observe que embora um conjunto de resultados completo possa ter sido puxado do MySQL
      pelo <code class="literal">mysqlnd</code>, esta estatística apenas conta dados reais
      puxados a partir do <code class="literal">mysqlnd</code> pelo cliente PHP.
     </span>
     <span class="simpara">
      Consulte também <code class="literal">bytes_received_real_data_normal</code>.
     </span>
    </dd>
   
  </dl>

  <dl>
   <strong class="title">Estatísticas Relacionadas ao Conjunto de Resultados</strong>

   
    <dt id="mysqlnd.stats.statistics.result-set-queries"><code class="literal">result_set_queries</code></dt>
    <dd>
     <span class="simpara">
      Número de consultas que geraram um conjunto de resultados.
      Exemplos de consultas que geram um conjunto de resultados:
      <code class="literal">SELECT</code>, <code class="literal">SHOW</code>.
     </span>
     <span class="simpara">
      A estatística não será incrementada se ocorrer um erro ao ler
      o pacote de cabeçalho do conjunto de resultados.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Esta estatística pode ser usada como uma medição indireta do número de
       consultas que o PHP enviou ao MySQL.
       Isto pode ajudar a identificar um cliente que causa uma carga alta no banco de dados.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.non-result-set-queries"><code class="literal">non_result_set_queries</code></dt>
    <dd>
     <span class="simpara">
      Número de consultas que não geraram um conjunto de resultados.
      Exemplos de consultas que não geram um conjunto de resultados:
      <code class="literal">INSERT</code>, <code class="literal">UPDATE</code>, <code class="literal">LOAD DATA</code>.
     </span>
     <span class="simpara">
      A estatística não será incrementada se ocorrer um erro ao ler
      o pacote de cabeçalho do conjunto de resultados.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Esta estatística pode ser usada como uma medição indireta do número de
       consultas que o PHP enviou ao MySQL.
       Isto pode ajudar a identificar um cliente que causa uma carga alta no banco de dados.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.no-index-used"><code class="literal">no_index_used</code></dt>
    <dd>
     <span class="simpara">
      Número de consultas que geraram um conjunto de resultados mas não usaram um índice.
      (Consulte também a opção de início do mysqld <code class="literal">--log-queries-not-using-indexes</code>).
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Essas consultas podem ser reportadas através de uma exceção com
       <code class="code">mysqli_report(MYSQLI_REPORT_INDEX);</code>.
       É possível reportá-las também através de um alerta com
       <code class="code">mysqli_report(MYSQLI_REPORT_INDEX ^ MYSQLI_REPORT_STRICT);</code>.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.bad-index-used"><code class="literal">bad_index_used</code></dt>
    <dd>
     <span class="simpara">
      Número de consultas que geraram um conjunto de resultados e não usaram um índice bom.
      (Consulte também a opção de início do mysqld <code class="literal">--log-slow-queries</code>).
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Essas consultas podem ser reportadas através de uma exceção com
       <code class="code">mysqli_report(MYSQLI_REPORT_INDEX);</code>.
       É possível reportá-las também através de um alerta com
       <code class="code">mysqli_report(MYSQLI_REPORT_INDEX ^ MYSQLI_REPORT_STRICT);</code>.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.slow-queries"><code class="literal">slow_queries</code></dt>
    <dd>
     <span class="simpara">
      Instruções SQL que levaram mais de <code class="literal">long_query_time</code>
      segundos para execução e requereram que pelo menos
      <code class="literal">min_examined_row_limit</code> registros fossem examinados.
     </span>
     <div class="caution"><strong class="caution">Cuidado</strong>
      <p class="simpara">
       Não reportada através de <span class="function"><a href="function.mysqli-report.php" class="function">mysqli_report()</a></span>.
      </p>
     </div>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.buffered-sets"><code class="literal">buffered_sets</code></dt>
    <dd>
     <span class="simpara">
      Número de conjuntos de resultados em buffer retornados por consultas
      normais (isto é, não por via de instrução preparada).
     </span>
     <p class="para">
      Exemplos de chamadas API que armazenarão conjuntos de resultados em buffer no cliente:
      <span class="simplelist"><span class="function"><a href="mysqli.query.php" class="function">mysqli_query()</a></span>, <span class="function"><a href="mysqli.store-result.php" class="function">mysqli_store_result()</a></span>, <span class="function"><a href="mysqli-stmt.get-result.php" class="function">mysqli_stmt_get_result()</a></span></span>
     </p>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.unbuffered-sets"><code class="literal">unbuffered_sets</code></dt>
    <dd>
     <span class="simpara">
      Número de conjuntos de resultados sem buffer retornados por consultas
      normais (isto é, não por via de instrução preparada).
     </span>
     <p class="para">
      Exemplos de chamadas API que não armazenarão conjuntos de resultados em buffer no cliente:
      <span class="simplelist"><span class="function"><a href="mysqli.use-result.php" class="function">mysqli_use_result()</a></span></span>
     </p>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.ps-buffered-sets"><code class="literal">ps_buffered_sets</code></dt>
    <dd>
     <span class="simpara">
      Número de conjuntos de resultados em buffer retornados por instruções preparadas.
     </span>
     <p class="para">
      Exemplos de chamadas API que armazenarão conjuntos de resultados em buffer no cliente:
      <span class="simplelist"><span class="function"><a href="mysqli-stmt.store-result.php" class="function">mysqli_stmt_store_result()</a></span></span>
     </p>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.ps-unbuffered-sets"><code class="literal">ps_unbuffered_sets</code></dt>
    <dd>
     <span class="simpara">
      Número de conjuntos de resultados sem buffer retornados por instruções preparadas.
     </span>
     <span class="simpara">
      Por padrão, instruções preparadas não são armazenadas em buffer,
      portanto a maioria das instruções preparadas será considerada nesta estatísitica.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.flushed-normal-sets"><code class="literal">flushed_normal_sets</code></dt>
    <dd>
     <span class="simpara">
      Número de conjuntos de resultados retornados por consultas
      normais (isto é, não por via de instrução preparada)
      com dados não lidos que foram silenciosamente descarregados.
     </span>

     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Os descarregamento ocorre somente com conjuntos de resultados sem buffer.
      </span>
      <span class="simpara">
       Conjuntos de resultados sem buffer devem ser buscados integralmente antes que uma nova consulta possa
       ser executada na conexão, caso contrário o MySQL lançará um erro.
       Se a aplicação não buscar todos os registros de um conjunto de resultados sem buffer,
       o mysqlnd não busca implicitamente o conjunto de resultados para limpar a linha de dados.
      </span>
      <span class="simpara">
       Consulta também <code class="literal">rows_skipped_normal</code>, <code class="literal">rows_skipped_ps</code>.
      </span>
      <p class="para">
       Algumas causas possíveis para um descarregamento implícito:
       <ul class="itemizedlist">
        <li class="listitem">
         <span class="simpara">
          Aplicação cliente com falhas
         </span>
        </li>
        <li class="listitem">
         <span class="simpara">
          Cliente parou de ler depois de ter encontrado o que estava procurando
          mas fez o MySQL calcular mais registros que o necessário
         </span>
        </li>
        <li class="listitem">
         <span class="simpara">
          Aplicação cliente parou inesperadamente
         </span>
        </li>
       </ul>
      </p>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.flushed-ps-sets"><code class="literal">flushed_ps_sets</code></dt>
    <dd>
     <span class="simpara">
      Número de conjuntos de resultados de instruções preparadas
      com dados não lidos que foram silenciosamente descarregados.
     </span>

     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Os descarregamento ocorre somente com conjuntos de resultados sem buffer.
      </span>
      <span class="simpara">
       Conjuntos de resultados sem buffer devem ser buscados integralmente antes que uma nova consulta possa
       ser executada na conexão, caso contrário o MySQL lançará um erro.
       Se a aplicação não buscar todos os registros de um conjunto de resultados sem buffer,
       o mysqlnd não busca implicitamente o conjunto de resultados para limpar a linha de dados.
      </span>
      <span class="simpara">
       Consulta também <code class="literal">rows_skipped_normal</code>, <code class="literal">rows_skipped_ps</code>.
      </span>
      <p class="para">
       Algumas causas possíveis para um descarregamento implícito:
       <ul class="itemizedlist">
        <li class="listitem">
         <span class="simpara">
          Aplicação cliente com falhas
         </span>
        </li>
        <li class="listitem">
         <span class="simpara">
          Cliente parou de ler depois de ter encontrado o que estava procurando
          mas fez o MySQL calcular mais registros que o necessário
         </span>
        </li>
        <li class="listitem">
         <span class="simpara">
          Aplicação cliente parou inesperadamente
         </span>
        </li>
       </ul>
      </p>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.ps-prepared-never-executed"><code class="literal">ps_prepared_never_executed</code></dt>
    <dd>
     <span class="simpara">
      Número de intruções preparadas mas nunca executadas.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.ps-prepared-once-executed"><code class="literal">ps_prepared_once_executed</code></dt>
    <dd>
     <span class="simpara">
      Número de intruções preparadas executadas apenas uma vez.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-fetched-from-server-normal"><code class="literal">rows_fetched_from_server_normal</code></dt>
    <dt><code class="literal">rows_fetched_from_server_ps</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros do conjunto de resultados buscados do servidor.
      Isto inclui os registros que não foram lidos pelo cliente mas
      foram buscados implicitamente devido a conjuntos de resultados sem buffer descarregados.
     </span>
     <span class="simpara">
      Consulte também <code class="literal">packets_received_rset_row</code>.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-buffered-from-server-normal"><code class="literal">rows_buffered_from_client_normal</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros em buffer originários de uma consulta normal.
     </span>
     <span class="simpara">
      Este é o número de registros que foram buscados do MySQL e armazenados em buffer no cliente.
     </span>
     <p class="para">
      Exemplos de consultas que irão armazenar resultados em buffer:
      <ul class="simplelist">
       <li><span class="function"><a href="mysqli.query.php" class="function">mysqli_query()</a></span></li>
       <li><span class="function"><a href="mysqli.store-result.php" class="function">mysqli_store_result()</a></span></li>
      </ul>
     </p>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-buffered-from-client-ps"><code class="literal">rows_buffered_from_client_ps</code></dt>
    <dd>
     <span class="simpara">
      O mesmo que <code class="literal">rows_buffered_from_client_normal</code>,
      porém para instruções preparadas.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-fetched-from-client-normal-buffered"><code class="literal">rows_fetched_from_client_normal_buffered</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros buscados pelo cliente a partir de um conjunto de resultados em buffer
      criado por uma consulta normal.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-fetched-from-client-ps-buffered"><code class="literal">rows_fetched_from_client_ps_buffered</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros buscados pelo cliente a partir de um conjunto de resultados em buffer
      criado por uma instrução preparada.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-fetched-from-client-normal-unbuffered"><code class="literal">rows_fetched_from_client_normal_unbuffered</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros buscados pelo cliente a partir de um conjunto de resultados sem buffer
      criado por uma consulta normal.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-fetched-from-client-ps-unbuffered"><code class="literal">rows_fetched_from_client_ps_unbuffered</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros buscados pelo cliente a partir de um conjunto de resultados sem buffer
      criado por uma instrução preparada.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.rows-fetched-from-client-ps-cursor"><code class="literal">rows_fetched_from_client_ps_cursor</code></dt>
    <dd>
     <span class="simpara">
      Número total de registros buscados pelo cliente a partir de um cursor criado por uma
      instrução preparada.
     </span>
    </dd>
   

   
   
    <dt id="mysqlnd.stats.statistics.rows-skipped-normal"><code class="literal">rows_skipped_normal</code></dt>
    <dt><code class="literal">rows_skipped_ps</code></dt>
    <dd>
     <span class="simpara">
      Reservada para uso futuro (atualmente não suportada).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.copy-on-write"><code class="literal">copy_on_write_saved</code></dt>
    <dt><code class="literal">copy_on_write_performed</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
     <span class="simpara">
      Com o mysqlnd, variáveis retornadas pelas extensões apontam para os
      buffers de resultados da rede interna do mysqlnd.
      Se os dados não foram modificados, os dados buscados são mantidos apenas uma vez na memória.
      Entretanto, qualquer modificação nos dados irá requerer que o mysqlnd realize
      uma operação de cópia-na-escrita.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.free-result"><code class="literal">explicit_free_result</code></dt>
    <dt><code class="literal">implicit_free_result</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de conexão e de processo.
     </span>
     <span class="simpara">
      Número total de conjuntos de resultados liberados.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-null"><code class="literal">proto_text_fetched_null</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_NULL</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-null"><code class="literal">proto_binary_fetched_null</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_NULL</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-bit"><code class="literal">proto_text_fetched_bit</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_BIT</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-bit"><code class="literal">proto_binary_fetched_bit</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_BIT</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-tinyint"><code class="literal">proto_text_fetched_tinyint</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_TINY</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-tinyint"><code class="literal">proto_binary_fetched_tinyint</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_TINY</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-short"><code class="literal">proto_text_fetched_short</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_SHORT</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-short"><code class="literal">proto_binary_fetched_short</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_SHORT</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-int24"><code class="literal">proto_text_fetched_int24</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_INT24</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-int24"><code class="literal">proto_binary_fetched_int24</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_INT24</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-int"><code class="literal">proto_text_fetched_int</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_LONG</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-int"><code class="literal">proto_binary_fetched_int</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_LONG</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-bigint"><code class="literal">proto_text_fetched_bigint</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_LONGLONG</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-bigint"><code class="literal">proto_binary_fetched_bigint</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_LONGLONG</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-decimal"><code class="literal">proto_text_fetched_decimal</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_DECIMAL</code> ou <code class="literal">MYSQL_TYPE_NEWDECIMAL</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-decimal"><code class="literal">proto_binary_fetched_decimal</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_DECIMAL</code> ou <code class="literal">MYSQL_TYPE_NEWDECIMAL</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-float"><code class="literal">proto_text_fetched_float</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_FLOAT</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-float"><code class="literal">proto_binary_fetched_float</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_FLOAT</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-double"><code class="literal">proto_text_fetched_double</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_DOUBLE</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-double"><code class="literal">proto_binary_fetched_double</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_DOUBLE</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-date"><code class="literal">proto_text_fetched_date</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_DATE</code> ou <code class="literal">MYSQL_TYPE_NEWDATE</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-date"><code class="literal">proto_binary_fetched_date</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_DATE</code> ou <code class="literal">MYSQL_TYPE_NEWDATE</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-year"><code class="literal">proto_text_fetched_year</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_YEAR</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-year"><code class="literal">proto_binary_fetched_year</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_YEAR</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-time"><code class="literal">proto_text_fetched_time</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_TIME</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-time"><code class="literal">proto_binary_fetched_time</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_TIME</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-datetime"><code class="literal">proto_text_fetched_datetime</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_DATETIME</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-datetime"><code class="literal">proto_binary_fetched_datetime</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_DATETIME</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-timestamp"><code class="literal">proto_text_fetched_timestamp</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_TIMESTAMP</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-timestamp"><code class="literal">proto_binary_fetched_timestamp</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_TIMESTAMP</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-string"><code class="literal">proto_text_fetched_string</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_STRING</code>, <code class="literal">MYSQL_TYPE_VARSTRING</code> ou <code class="literal">MYSQL_TYPE_VARCHAR</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-string"><code class="literal">proto_binary_fetched_string</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_STRING</code>, <code class="literal">MYSQL_TYPE_VARSTRING</code> ou <code class="literal">MYSQL_TYPE_VARCHAR</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-blob"><code class="literal">proto_text_fetched_blob</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_TINY_BLOB</code>,
      <code class="literal">MYSQL_TYPE_MEDIUM_BLOB</code>,
      <code class="literal">MYSQL_TYPE_LONG_BLOB</code>
      ou <code class="literal">MYSQL_TYPE_BLOB</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-blob"><code class="literal">proto_binary_fetched_blob</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_TINY_BLOB</code>,
      <code class="literal">MYSQL_TYPE_MEDIUM_BLOB</code>,
      <code class="literal">MYSQL_TYPE_LONG_BLOB</code>
      ou <code class="literal">MYSQL_TYPE_BLOB</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-enum"><code class="literal">proto_text_fetched_enum</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_ENUM</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-enum"><code class="literal">proto_binary_fetched_enum</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_ENUM</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-set"><code class="literal">proto_text_fetched_set</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_SET</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-set"><code class="literal">proto_binary_fetched_set</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_SET</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-geometry"><code class="literal">proto_text_fetched_geometry</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_GEOMETRY</code>
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-geometry"><code class="literal">proto_binary_fetched_geometry</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas do tipo
      <code class="literal">MYSQL_TYPE_GEOMETRY</code>
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-text-fetched-other"><code class="literal">proto_text_fetched_other</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_<span class="replaceable">*</span></code>
      não listadas previamente e
      buscadas por uma consulta normal (protocolo de texto MySQL).
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Em teoria, deveria ser sempre <code class="literal">0</code>.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.proto-binary-fetched-other"><code class="literal">proto_binary_fetched_other</code></dt>
    <dd>
     <span class="simpara">
      Número total de colunas dos tipos
      <code class="literal">MYSQL_TYPE_<span class="replaceable">*</span></code>
      não listadas previamente e
      buscadas por uma instrução preparada (protocolo binário MySQL).
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Em teoria, deveria ser sempre <code class="literal">0</code>.
      </span>
     </p></blockquote>
    </dd>
   

  </dl>

  <dl>
   <strong class="title">Estatísticas Relacionadas a Conexões</strong>

   
    <dt id="mysqlnd.stats.statistics.connect-success"><code class="literal">connect_success</code></dt>
    <dd>
     <span class="simpara">
      Número total de tentativas bem sucedidas de conexões.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       <code class="literal">connect_success</code> contém a soma de tentativas bem sucedidas
       de conexões persistentes e não persistentes.
       Portanto, o número de tentativas bem sucedidas de conexões não persistentes
       é <code class="literal">connect_success - pconnect_success</code>.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.pconnect-success"><code class="literal">pconnect_success</code></dt>
    <dd>
     <span class="simpara">
      Número total de tentativas bem sucedidas de conexões persistentes.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.connect-failure"><code class="literal">connect_failure</code></dt>
    <dd>
     <span class="simpara">
      Número total de tentativas falhadas de conexões.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.reconnect"><code class="literal">reconnect</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.active-connections"><code class="literal">active_connections</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
     <span class="simpara">
      Número total de conexões ativas, persistentes e não persistentes.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Número total de conexões ativas não persistentes é
       <code class="literal">active_connections - active_persistent_connections</code>.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.active-persistent-connections"><code class="literal">active_persistent_connections</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
     <span class="simpara">
      Número total de conexões ativas persistentes.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.explicit-close"><code class="literal">explicit_close</code></dt>
    <dd>
     <span class="simpara">
      Número total de conexões fechadas explicitamente.
     </span>
     <div class="example" id="example-1">
      <p><strong>Exemplo #1 Exemplos de trechos de código que causam um fechamento explícito</strong></p>
      <ul class="itemizedlist">
       <li class="listitem">
        <div class="example-contents">
<div class="cdata"><pre>
$link = new mysqli(/* ... */);
$link-&gt;close(/* ... */);
</pre></div>
        </div>

       </li>
       <li class="listitem">
        <div class="example-contents">
<div class="cdata"><pre>
$link = new mysqli(/* ... */);
$link-&gt;connect(/* ... */);
</pre></div>
        </div>

       </li>
      </ul>
     </div>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.implicit-close"><code class="literal">implicit_close</code></dt>
    <dd>
     <span class="simpara">
      Número total de conexões fechadas implicitamente.
     </span>
     <div class="example" id="example-2">
      <p><strong>Exemplo #2 Exemplos de trechos de código que causam um fechamento implícito</strong></p>
      <ul class="itemizedlist">
       <li class="listitem">
        <div class="example-contents">
<div class="cdata"><pre>
$link = new mysqli(/* ... */);
$link-&gt;real_connect(/* ... */);
</pre></div>
        </div>

       </li>
       <li class="listitem">
        <div class="example-contents">
         <code class="code">unset($link)</code>
        </div>

       </li>
       <li class="listitem">
        <span class="simpara">
         Conexão persistente: conexão em fila foi criada com
         real_connect e podem haver opções desconhecidas definidas - fecha
         implicitamente para evitar o retorno de uma conexão com opções desconhecidas
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         Conexão persistente: ping/change_user falha e a extensão mysqli
         fecha a conexão
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         Fim de execução de script: fecha conexões que não foram
         fechadas pelo usuário
        </span>
       </li>
      </ul>
     </div>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.disconnect-close"><code class="literal">disconnect_close</code></dt>
    <dd>
     <span class="simpara">
      Falhas de conexão indicadas pela chamada API C
      <code class="literal">mysql_real_connect</code> durante uma tentativa de se
      estabalecer uma conexão.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.in-middle-of-command-close"><code class="literal">in_middle_of_command_close</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
     <span class="simpara">
      Uma conexão foi fechada no meio de uma execução de comando
      (conjuntos de resultados não buscados, após enviar uma consulta e
      antes de receber uma resposta, durante a busca de dados, enquanto
      dados são transferidos com LOAD DATA).
     </span>
     <div class="warning"><strong class="warning">Aviso</strong>
      <p class="simpara">
       A menos que consultas assíncronas sejam usadas,
       isto só deve acontecer se a aplicação PHP terminar inesperadamente
       e o PHP fechar a conexão automaticamente.
      </p>
     </div>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.init-command-executed-count"><code class="literal">init_command_executed_count</code></dt>
    <dd>
     <span class="simpara">
      Número total de execuções do comando init.
      Por exemplo: <code class="code">mysqli_options(MYSQLI_INIT_COMMAND , $value)</code>.
     </span>
     <span class="simpara">
      O número total de execuções bem sucedidas é
      <code class="literal">init_command_executed_count - init_command_failed_count</code>.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.init-command-failed-count"><code class="literal">init_command_failed_count</code></dt>
    <dd>
     <span class="simpara">
      Número total de comandos init falhados.
     </span>
    </dd>
   
  </dl>

  <dl>
   <strong class="title">Estatísticas Relacionadas aos Comandos <code class="literal">COM_*</code></strong>

   
    <dt id="mysqlnd.stats.statistics.com"><code class="literal">com_quit</code></dt>
    <dt><code class="literal">com_init_db</code></dt>
    <dt><code class="literal">com_query</code></dt>
    <dt><code class="literal">com_field_list</code></dt>
    <dt><code class="literal">com_create_db</code></dt>
    <dt><code class="literal">com_drop_db</code></dt>
    <dt><code class="literal">com_refresh</code></dt>
    <dt><code class="literal">com_shutdown</code></dt>
    <dt><code class="literal">com_statistics</code></dt>
    <dt><code class="literal">com_process_info</code></dt>
    <dt><code class="literal">com_connect</code></dt>
    <dt><code class="literal">com_process_kill</code></dt>
    <dt><code class="literal">com_debug</code></dt>
    <dt><code class="literal">com_ping</code></dt>
    <dt><code class="literal">com_time</code></dt>
    <dt><code class="literal">com_delayed_insert</code></dt>
    <dt><code class="literal">com_change_user</code></dt>
    <dt><code class="literal">com_binlog_dump</code></dt>
    <dt><code class="literal">com_table_dump</code></dt>
    <dt><code class="literal">com_connect_out</code></dt>
    <dt><code class="literal">com_register_slave</code></dt>
    <dt><code class="literal">com_stmt_prepare</code></dt>
    <dt><code class="literal">com_stmt_execute</code></dt>
    <dt><code class="literal">com_stmt_send_long_data</code></dt>
    <dt><code class="literal">com_stmt_close</code></dt>
    <dt><code class="literal">com_stmt_reset</code></dt>
    <dt><code class="literal">com_stmt_set_option</code></dt>
    <dt><code class="literal">com_stmt_fetch</code></dt>
    <dt><code class="literal">com_daemon</code></dt>
    <dd>
     <span class="simpara">
      Número total de tentativas de envio de um certo comando <code class="literal">COM_*</code>
      do PHP para o MySQL.
     </span>
     <span class="simpara">
      As estatísticas são incrementadas após verificação da linha de dados e imediatamente
      antes do envio do pacote correspondente do protocolo Cliente Servidor do MySQL.
     </span>
     <div class="caution"><strong class="caution">Cuidado</strong>
      <p class="simpara">
       Se o MySQLnd falhar ao enviar o pacote pela rede, a estatística não será decrementada.
       Em caso de falha, o MySQLnd emite um alerta do PHP
       <q class="quote">Error while sending %s packet. PID=%d.</q>
      </p>
     </div>

     <div class="example" id="example-3">
      <p><strong>Exemplo #3 Exemplos de uso</strong></p>
      <ul class="itemizedlist">
       <li class="listitem">
        <span class="simpara">
         Verificar se o PHP envia certos comandos ao MySQL, por exemplo,
         verificar se o cliente envia <code class="literal">COM_PROCESS_KILL</code>
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         Calcular o número médio de execuções de instruções preparadas
         comparando <code class="literal">COM_EXECUTE</code> com
         <code class="literal">COM_PREPARE</code>
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         Verificar se o PHP executou alguma instrução SQL não preparada
         observando se <code class="literal">COM_QUERY</code> é igual a zero
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         Identificar scripts PHP que executam um número excessivo de instruções
         SQL, verificando <code class="literal">COM_QUERY</code> e
         <code class="literal">COM_EXECUTE</code>
        </span>
       </li>
      </ul>
     </div>
    </dd>
   
  </dl>

  <dl>
   <strong class="title">Estatísticas Miscelâneas</strong>

   
    <dt id="mysqlnd.stats.statistics.stmt-close"><code class="literal">explicit_stmt_close</code></dt>
    <dt><code class="literal">implicit_stmt_close</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
     <span class="simpara">
      Número total de instruções preparadas fechadas.
     </span>
     <blockquote class="note"><p><strong class="note">Nota</strong>: 
      <span class="simpara">
       Uma instrução preparada é sempre fechada explicitamente. O único momento em que ela é fechaada implicitamente é quando sua preparação falha.
      </span>
     </p></blockquote>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.memory-management"><code class="literal">mem_emalloc_count</code></dt>
    <dt><code class="literal">mem_emalloc_ammount</code></dt>
    <dt><code class="literal">mem_ecalloc_count</code></dt>
    <dt><code class="literal">mem_ecalloc_ammount</code></dt>
    <dt><code class="literal">mem_realloc_count</code></dt>
    <dt><code class="literal">mem_realloc_ammount</code></dt>
    <dt><code class="literal">mem_efree_count</code></dt>
    <dt><code class="literal">mem_malloc_count</code></dt>
    <dt><code class="literal">mem_malloc_ammount</code></dt>
    <dt><code class="literal">mem_calloc_count</code></dt>
    <dt><code class="literal">mem_calloc_ammount</code></dt>
    <dt><code class="literal">mem_ealloc_count</code></dt>
    <dt><code class="literal">mem_ealloc_ammount</code></dt>
    <dt><code class="literal">mem_free_count</code></dt>
    <dd>
     <span class="simpara">
      Esta é uma estatística cujo escopo está no nível de processo.
     </span>
     <span class="simpara">
      Chamadas de gerenciamento de memória.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.command-buffer-too-small"><code class="literal">command_buffer_too_small</code></dt>
    
    <dd>
     <span class="simpara">
      Número de extensões de buffer de comandos de rede ao enviar comandos do
      PHP para o MySQL.
     </span>
     <span class="simpara">
      MySQLnd aloca um buffer interno de comando/rede de
      <a href="mysqlnd.config.php#ini.mysqlnd.net-cmd-buffer-size" class="link">mysqlnd.net_cmd_buffer_size</a>
      bytes para cada conexão.
     </span>
     <span class="simpara">
      Se um comando do protocolo Cliente Servidor do MySQL,
      por exemplo <code class="literal">COM_QUERY</code> (consulta normal),
      não couber no buffer,
      o MySQLnd aumentará o buffer para o tamanho necessário para envio do comando.
      Sempre que o buffer for estendido para uma conexão,
      <code class="literal">command_buffer_too_small</code> será incrementada em uma unidade.
     </span>
     <span class="simpara">
      Se o MySQLnd tiver que aumentar o buffer para além do seu tamanho inicial de
      <a href="mysqlnd.config.php#ini.mysqlnd.net-cmd-buffer-size" class="link">mysqlnd.net_cmd_buffer_size</a>
      bytes para quase todas as conexões,
      deve ser considerado aumento do tamanho padrão para evitar
      realocações.
     </span>
    </dd>
   

   
    <dt id="mysqlnd.stats.statistics.connection-reused"><code class="literal">connection_reused</code></dt>
    <dd>
     <span class="simpara">
      O número total de vezes em que uma conexão persistente foi reutilizada.
     </span>
    </dd>
   
  </dl>
 </div>
</div>
<?php manual_footer($setup); ?>