PHP 8.4.0 RC4 available for testing

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

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