db2_columns

(PECL ibm_db2 >= 1.0.0)

db2_columns Retorna um conjunto de resultados listando as colunas e metadados associados para uma tabela

Descrição

db2_columns(
    resource $connection,
    ?string $qualifier = null,
    ?string $schema = null,
    ?string $table_name = null,
    ?string $column_name = null
): resource

Retorna um conjunto de resultados listando as colunas e metadados associados para 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 as tabelas. Para corresponder a todos os esquemas, passe '%'.

table_name

O nome da tabela ou view. Para corresponder a todas as tabelas no banco de dados, passe null ou uma string vazia.

column_name

O nome da coluna. Para corresponder a todas as colunas na tabela, passe null ou uma string vazia.

Valor Retornado

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:

Nome da coluna Descrição
TABLE_CAT Nome do catálogo. O valor é NULL se esta tabela não tiver catálogos.
TABLE_SCHEM Nome do esquema.
TABLE_NAME Nome da tabela ou visualização.
COLUMN_NAME Nome da coluna.
DATA_TYPE O tipo de dados SQL para a coluna representada como um valor inteiro.
TYPE_NAME Uma string que representa o tipo de dados da coluna.
COLUMN_SIZE Um valor inteiro que representa o tamanho da coluna.
BUFFER_LENGTH Número máximo de bytes necessários para armazenar dados desta coluna.
DECIMAL_DIGITS A escala da coluna, ou null onde a escala não é aplicável.
NUM_PREC_RADIX Um valor inteiro de 10 (representando um tipo de dado numérico exato), 2 (representando um tipo de dado numérico aproximado) ou null (representando um tipo de dado para o qual radix não é aplicável).
NULLABLE Um valor inteiro que representa se a coluna é anulável ou não.
REMARKS Descrição da coluna.
COLUMN_DEF Valor padrão para a coluna.
SQL_DATA_TYPE Um valor inteiro que representa o tamanho da coluna.
SQL_DATETIME_SUB Retorna um valor inteiro que representa um código de subtipo de data e hora, ou null para tipos de dados SQL aos quais isso não se aplica.
CHAR_OCTET_LENGTH 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 null para tipos de dados não caracteres.
ORDINAL_POSITION A posição, indexada a partir de 1, da coluna na tabela.
IS_NULLABLE Uma string onde 'YES' significa que a coluna é anulável e 'NO' significa que a coluna não é anulável.

Veja Também

  • db2_column_privileges() - Retorna um conjunto de resultados listando as colunas e privilégios associados para uma tabela
  • db2_foreign_keys() - Retorna um conjunto de resultados listando as chaves estrangeiras para uma tabela
  • db2_primary_keys() - Retorna um conjunto de resultados listando as chaves primárias para uma tabela
  • db2_procedure_columns() - Retorna um conjunto de resultados listando os parâmetros do procedimento armazenado
  • db2_procedures() - Retorna um conjunto de resultados listando os procedimentos armazenados registrados em um banco de dados
  • db2_special_columns() - Retorna um conjunto de resultados listando as colunas de identificador de linha exclusivo para uma tabela
  • db2_statistics() - Retorna um conjunto de resultados listando o índice e as estatísticas de uma tabela
  • db2_table_privileges() - Retorna um conjunto de resultados listando as tabelas e privilégios associados em um banco de dados
  • db2_tables() - Retorna um conjunto de resultados listando as tabelas e metadados associados em um banco de dados

adicione uma nota

Notas Enviadas por Usuários (em inglês) 3 notes

up
0
Anonymous
10 years ago
As with previous message, passing null as the last param with db2_columns results in nothing being returned. Passing '%' instead works. The documentation really needs to be updated to correct this error as it's very misleading and was reported as wrong 8 years ago!
up
0
david dot rekowski at gmx dot de
16 years ago
must be
db2_columns($conn, '', '%', $table, '%');

Don't forget that table names are UPPERCASE. That gave me quite some headache.
up
0
lada(at)hoidekr.net
18 years ago
This is not true!
column-name
The name of the column. To match all columns in the table, pass NULL or an empty string.

You should pass '%' to match all columns
To Top