array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.db2-statistics.php', 1 => 'db2_statistics', 2 => 'Retorna um conjunto de resultados listando o índice e as estatísticas de uma tabela', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Funções de IBM DB2', ), 'prev' => array ( 0 => 'function.db2-special-columns.php', 1 => 'db2_special_columns', ), 'next' => array ( 0 => 'function.db2-stmt-error.php', 1 => 'db2_stmt_error', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ibm_db2/functions/db2-statistics.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

db2_statistics

(PECL ibm_db2 >= 1.0.0)

db2_statistics — Retorna um conjunto de resultados listando o índice e as estatísticas de uma tabela

Descrição

db2_statistics(
    resource $connection,
    ?string $qualifier,
    ?string $schema,
    string $table_name,
    bool $unique
): resource

Retorna um conjunto de resultados listando o índice e as estatísticas de uma tabela.

Parâmetros

connection
Uma conexão válida com um banco de dados IBM DB2, Cloudscape ou Apache Derby.
qualifier
Um qualificador para bancos de dados DB2 em execução em servidores OS/390 ou z/OS. Para outros bancos de dados, passe null ou uma string vazia.
schema
O esquema que contém a tabela de destino. Se este parâmetro for null, as estatísticas e índices são retornados para o esquema do usuário atual.
table_name
O nome da tabela.
unique
Quando unique é true, as informações para todos os índices na tabela são retornadas. Caso contrário, apenas as informações para índices exclusivos na tabela são retornadas.

Valor Retornado

Retorna um recurso de instrução com um conjunto de resultados contendo linhas descrevendo as estatísticas e índices para as tabelas base que correspondem aos parâmetros especificados. As linhas são compostas das seguintes colunas:
Nome da coluna Descrição
TABLE_CAT O catálogo que contém a tabela. O valor é null se esta tabela não tiver catálogos.
TABLE_SCHEM Nome do esquema que contém a tabela.
TABLE_NAME Nome da tabela.
NON_UNIQUE

Um valor inteiro que representa se o índice proíbe valores únicos ou se a linha representa estatísticas na própria tabela:
Valor de retorno Tipo de parâmetro
0 (SQL_FALSE) O índice permite valores duplicados.
1 (SQL_TRUE) Os valores do índice devem ser exclusivos.
null Esta linha contém informações estatísticas da própria tabela.

INDEX_QUALIFIER Um valor de string representando o qualificador que teria que ser anexado a INDEX_NAME para qualificar completamente o índice.
INDEX_NAME Uma string que representa o nome do índice.
TYPE

Um valor inteiro que representa o tipo de informação contida nesta linha do conjunto de resultados:
Valor de retorno Tipo de parâmetro
0 (SQL_TABLE_STAT) A linha contém estatísticas sobre a própria tabela.
1 (SQL_INDEX_CLUSTERED) A linha contém informações sobre um índice clusterizado.
2 (SQL_INDEX_HASH) A linha contém informações sobre um índice com hash.
3 (SQL_INDEX_OTHER) A linha contém informações sobre um tipo de índice que não é agrupado nem hash.

ORDINAL_POSITION A posição indexada em 1 da coluna no índice. null se a linha contiver informações estatísticas sobre a própria tabela.
COLUMN_NAME O nome da coluna no índice. null se a linha contiver informações estatísticas sobre a própria tabela.
ASC_OR_DESC A se a coluna estiver classificada em ordem crescente, D se a coluna estiver classificada em ordem decrescente, null se a linha contiver informações estatísticas sobre a tabela em si.
CARDINALITY Se a linha contiver informações sobre um índice, esta coluna conterá um valor inteiro representando o número de valores exclusivos no índice. Se a linha contiver informações sobre a tabela em si, esta coluna conterá um valor inteiro representando o número de linhas na tabela.
PAGES Se a linha contiver informações sobre um índice, esta coluna conterá um valor inteiro representando o número de páginas usadas para armazenar o índice. Se a linha contiver informações sobre a tabela em si, esta coluna conterá um valor inteiro representando o número de páginas usadas para armazenar a tabela.
FILTER_CONDITION Sempre retorna null.

Veja Também