db2_columns

(PECL ibm_db2 >= 1.0.0)

db2_columns — Devuelve los campos de una tabla y sus metadatos asociados.

Descripción

db2_columns(
    resource $connection,
    string $qualifier = ?,
    string $schema = ?,
    string $table-name = ?,
    string $column-name = ?
): resource

Devuelve los campos de una tabla y sus metadatos asociados.

Parámetros

connection: Una conexión a IBM DB2, Cloudscape, o Apache Derby.
qualifier: Un calificador para bases de datos DB2 que se ejecutan en servidores OS/390 o z/OS. Para otras bases de datos, use null o una cadena vacía.
schema: El esquema que contiene la tabla indicada. Para buscar en todos los esquemas, use '%'.
table-name: El nombre de la tabla o vista. Para consultar todas las tablas en la base de datos, use null o una cadena vacía.
column-name: El nombre del campo. Para consultar todos los campos en la tabla, use null o una cadena vacía.

Valores devueltos

Devuelve información de los campos especificados a través de los parámetros de la función. Los registros contienen las siguientes columnas:

Nombre del campo	Descripción
TABLE_CAT	Nombre del catálogo. Puede ser `null` si la tabla no contiene un catálogo.
TABLE_SCHEM	Nombre del esquema.
TABLE_NAME	Nombre de la tabla o vista.
COLUMN_NAME	Nombre del campo.
DATA_TYPE	El tipo de dato SQL como un entero.
TYPE_NAME	El nombre del tipo de dato como cadena de texto.
COLUMN_SIZE	El tamaño del campo como un entero.
BUFFER_LENGTH	El tamaño en bytes que se requieren como máximo para almacenar datos desde este campo.
DECIMAL_DIGITS	La escala de este campo, o `null` si no es aplicable.
NUM_PREC_RADIX	Un entero que puede ser `10` (para un tipo de dato exacto), `2` (para un tipo de dato aproximado), o `null` (para un tipo de dato donde la precisión no es aplicable).
NULLABLE	Indica si este campo puede guardar valores `null`.
REMARKS	Descripción del campo.
COLUMN_DEF	Valor por defecto.
SQL_DATA_TYPE	El tamaño del campo como un entero.
SQL_DATETIME_SUB	Devuelve el código del subtipo de fecha y hora, o `null` para tipos de datos donde no es aplicable.
CHAR_OCTET_LENGTH	Tamaño máximo en octetos para el tipo de datos de carácter, que coincida con COLUMN_SIZE para conjuntos de caracteres de un sólo byte, o `null` para tipos de datos distintos.
ORDINAL_POSITION	La posición del campo en la tabla (contando desde 1).
IS_NULLABLE	Una cadena de texto que contiene 'YES' si puede guardar valores nulos y 'NO' cuando no permita valores nulos.

Ver también

db2_column_privileges() - Obtiene la lista de columnas y permisos asociados a una tabla
db2_foreign_keys() - Devolver un resultado que contenga las llaves foraneas de una tabla
db2_primary_keys() - Devolver un resultado con las llaves primarias de una tabla
db2_procedure_columns() - Devolver un resultado con los parámetros de los procedimientos almacenados
db2_procedures() - Devolver un resultado con los procedimientos almacenados registrados en la base de datos
db2_special_columns() - Returns a result set listing the unique row identifier columns for a table
db2_statistics() - Returns a result set listing the index and statistics for a table
db2_table_privileges() - Returns a result set listing the tables and associated privileges in a database
db2_tables() - Returns a result set listing the tables and associated metadata in a database

add a note

User Contributed Notes 3 notes

down

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!

down

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.

down

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

add a note