<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.ibm-db2.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'function.db2-columns.php',
    1 => 'db2_columns',
    2 => 'Retorna um conjunto de resultados listando as colunas e metadados associados para uma tabela',
  ),
  'up' => 
  array (
    0 => 'ref.ibm-db2.php',
    1 => 'Fun&ccedil;&otilde;es de IBM DB2',
  ),
  'prev' => 
  array (
    0 => 'function.db2-column-privileges.php',
    1 => 'db2_column_privileges',
  ),
  'next' => 
  array (
    0 => 'function.db2-commit.php',
    1 => 'db2_commit',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/ibm_db2/functions/db2-columns.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.db2-columns" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">db2_columns</h1>
  <p class="verinfo">(PECL ibm_db2 &gt;= 1.0.0)</p><p class="refpurpose"><span class="refname">db2_columns</span> &mdash; <span class="dc-title">
   Retorna um conjunto de resultados listando as colunas e metadados associados para uma tabela
  </span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.db2-columns-description">
  <h3 class="title">Descrição</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>db2_columns</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$connection</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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.string.php" class="type string">string</a></span></span> <code class="parameter">$qualifier</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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.string.php" class="type string">string</a></span></span> <code class="parameter">$schema</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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.string.php" class="type string">string</a></span></span> <code class="parameter">$table_name</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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.string.php" class="type string">string</a></span></span> <code class="parameter">$column_name</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span><br>): <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span></div>


  <p class="simpara">
   Retorna um conjunto de resultados listando as colunas e metadados associados para uma
   tabela.
  </p>

 </div>

 <div class="refsect1 parameters" id="refsect1-function.db2-columns-parameters">
  <h3 class="title">Parâmetros</h3>
  <dl>
   
    <dt><code class="parameter">connection</code></dt>
    <dd>
     <span class="simpara">
      Uma conexão válida com um banco de dados IBM DB2, Cloudscape ou Apache Derby.
     </span>
    </dd>
   
   
   <dt><code class="parameter">qualifier</code></dt>
    <dd>
     <span class="simpara">
      Um qualificador para bancos de dados DB2 em execução em servidores OS/390 ou z/OS. Para
      outros bancos de dados, passe <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> ou uma string vazia.
     </span>
    </dd>
   
   
    <dt><code class="parameter">schema</code></dt>
    <dd>
     <span class="simpara">
      O esquema que contém as tabelas. Para corresponder a todos os esquemas, passe
      <code class="literal">&#039;%&#039;</code>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">table_name</code></dt>
    <dd>
     <span class="simpara">
      O nome da tabela ou view. Para corresponder a todas as tabelas no banco de dados,
      passe <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> ou uma string vazia.
     </span>
    </dd>
   
   
    <dt><code class="parameter">column_name</code></dt>
    <dd>
     <span class="simpara">
      O nome da coluna. Para corresponder a todas as colunas na tabela, passe <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>
      ou uma string vazia.
     </span>
    </dd>
   
  </dl>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.db2-columns-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="para">
   Retorna um recurso de instrução com um conjunto de resultados contendo linhas descrevendo
   as colunas que correspondem aos parâmetros especificados. As linhas são compostas
   pelas seguintes colunas:
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Nome da coluna</th>
       <th>Descrição</th>
      </tr>

     </thead>

     <tbody class="tbody">
       <tr>
        <td>TABLE_CAT</td>
        <td>Nome do catálogo. O valor é NULL se esta tabela não
         tiver catálogos.</td>
       </tr>

       <tr>
        <td>TABLE_SCHEM</td>
        <td>Nome do esquema.</td>
       </tr>

       <tr>
        <td>TABLE_NAME</td>
        <td>Nome da tabela ou visualização.</td>
       </tr>

       <tr>
        <td>COLUMN_NAME</td>
        <td>Nome da coluna.</td>
       </tr>

       <tr>
        <td>DATA_TYPE</td>
        <td>O tipo de dados SQL para a coluna representada como um valor inteiro.</td>
       </tr>

       <tr>
        <td>TYPE_NAME</td>
        <td>Uma string que representa o tipo de dados da coluna.</td>
       </tr>

       <tr>
        <td>COLUMN_SIZE</td>
        <td>Um valor inteiro que representa o tamanho da coluna.</td>
       </tr>

       <tr>
        <td>BUFFER_LENGTH</td>
        <td>
         Número máximo de bytes necessários para armazenar dados desta coluna.
        </td>
       </tr>

       <tr>
        <td>DECIMAL_DIGITS</td>
        <td>
         A escala da coluna, ou <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> onde a escala não é aplicável.
        </td>
       </tr>

       <tr>
        <td>NUM_PREC_RADIX</td>
        <td>
         Um valor inteiro de <code class="literal">10</code> (representando
         um tipo de dado numérico exato), <code class="literal">2</code> (representando
         um tipo de dado numérico aproximado) ou <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> (representando um tipo de dado para
         o qual radix não é aplicável).
        </td>
       </tr>

       <tr>
        <td>NULLABLE</td>
        <td>Um valor inteiro que representa se a coluna é anulável ou
         não.</td>
       </tr>

       <tr>
        <td>REMARKS</td>
        <td>Descrição da coluna.</td>
       </tr>

       <tr>
        <td>COLUMN_DEF</td>
        <td>Valor padrão para a coluna.</td>
       </tr>

       <tr>
        <td>SQL_DATA_TYPE</td>
        <td>Um valor inteiro que representa o tamanho da coluna.</td>
       </tr>

       <tr>
        <td>SQL_DATETIME_SUB</td>
        <td>
         Retorna um valor inteiro que representa um código de subtipo de data e hora,
         ou <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> para tipos de dados SQL aos quais isso não se aplica.
        </td>
       </tr>

       <tr>
        <td>CHAR_OCTET_LENGTH</td>
        <td>
         Comprimento máximo em octetos para uma coluna de tipo de dados de caractere, que
         corresponde a COLUMN_SIZE para dados de conjunto de caracteres de byte único ou <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> para
         tipos de dados não caracteres.
        </td>
       </tr>

       <tr>
        <td>ORDINAL_POSITION</td>
        <td>A posição, indexada a partir de 1, da coluna na tabela.</td>
       </tr>

       <tr>
        <td>IS_NULLABLE</td>
        <td>
         Uma string onde &#039;YES&#039; significa que a coluna é anulável e
         &#039;NO&#039; significa que a coluna não é anulável.
       </td>
       </tr>

     </tbody>
    
   </table>


  </p>
 </div>


 

 <div class="refsect1 seealso" id="refsect1-function.db2-columns-seealso">
  <h3 class="title">Veja Também</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.db2-column-privileges.php" class="function" rel="rdfs-seeAlso">db2_column_privileges()</a> - Retorna um conjunto de resultados listando as colunas e privil&eacute;gios associados para uma tabela</span></li>
   <li><span class="function"><a href="function.db2-foreign-keys.php" class="function" rel="rdfs-seeAlso">db2_foreign_keys()</a> - Retorna um conjunto de resultados listando as chaves estrangeiras para uma tabela</span></li>
   <li><span class="function"><a href="function.db2-primary-keys.php" class="function" rel="rdfs-seeAlso">db2_primary_keys()</a> - Retorna um conjunto de resultados listando as chaves prim&aacute;rias para uma tabela</span></li>
   <li><span class="function"><a href="function.db2-procedure-columns.php" class="function" rel="rdfs-seeAlso">db2_procedure_columns()</a> - Retorna um conjunto de resultados listando os par&acirc;metros do procedimento armazenado</span></li>
   <li><span class="function"><a href="function.db2-procedures.php" class="function" rel="rdfs-seeAlso">db2_procedures()</a> - Retorna um conjunto de resultados listando os procedimentos armazenados registrados em um banco de dados</span></li>
   <li><span class="function"><a href="function.db2-special-columns.php" class="function" rel="rdfs-seeAlso">db2_special_columns()</a> - Retorna um conjunto de resultados listando as colunas de identificador de linha exclusivo para uma tabela</span></li>
   <li><span class="function"><a href="function.db2-statistics.php" class="function" rel="rdfs-seeAlso">db2_statistics()</a> - Retorna um conjunto de resultados listando o &iacute;ndice e as estat&iacute;sticas de uma tabela</span></li>
   <li><span class="function"><a href="function.db2-table-privileges.php" class="function" rel="rdfs-seeAlso">db2_table_privileges()</a> - Retorna um conjunto de resultados listando as tabelas e privil&eacute;gios associados em um banco de dados</span></li>
   <li><span class="function"><a href="function.db2-tables.php" class="function" rel="rdfs-seeAlso">db2_tables()</a> - Retorna um conjunto de resultados listando as tabelas e metadados associados em um banco de dados</span></li>
  </ul>
 </div>


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