PHP 8.5.0 Alpha 1 available for testing

db2_columns

(PECL ibm_db2 >= 1.0.0)

db2_columns Devuelve un conjunto de resultados que lista las columnas y sus metadatos de una tabla

Descripción

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

Devuelve un conjunto de resultados que lista las columnas y sus metadatos de una tabla.

Parámetros

connection

Una conexión válida a una base de datos IBM DB2, Cloudscape o Apache Derby.

qualifier

Un calificador para las bases de datos DB2 que funcionan en los servidores OS/390 o z/OS. Para otras bases de datos, se debe pasar null o una cadena vacía.

schema

El esquema que contiene las tablas. Para coincidir con todos los esquemas, se debe pasar '%'.

table_name

El nombre de la tabla. Para obtener todas las tablas en la base de datos, se debe pasar null o una cadena vacía.

column_name

El nombre de la columna. Para obtener todas las columnas de la tabla, se debe pasar null o una cadena vacía.

Valores devueltos

Devuelve un recurso con el conjunto de resultados que contiene las filas que describen los privilegios de las columnas que coinciden con los parámetros especificados. Las filas están compuestas por las siguientes columnas:

Nombre de la columna Descripción
TABLE_CAT Nombre del catálogo. El valor es null si la tabla no posee catálogo.
TABLE_SCHEM Nombre del esquema.
TABLE_NAME Nombre de la tabla.
COLUMN_NAME Nombre de la columna.
DATA_TYPE El tipo de datos SQL para la columna, representado como un integer.
TYPE_NAME Una cadena que representa el tipo de datos para la columna.
COLUMN_SIZE Un integer que representa el tamaño de la columna.
BUFFER_LENGTH Número máximo de bytes necesarios para almacenar datos de esta columna.
DECIMAL_DIGITS La escala de la columna o null donde la escala no es aplicable.
NUM_PREC_RADIX Un integer que puede ser 10 (que representa un tipo de datos numérico exacto), 2 (que representa un tipo de datos numéricos aproximado) o null (que representa un tipo de datos para el cual la base no es aplicable).
NULLABLE Un integer que representa si la columna puede ser nula o no.
REMARKS Descripción de la columna.
COLUMN_DEF Valor por defecto de la columna.
SQL_DATA_TYPE Un integer que representa el tamaño de la columna.
SQL_DATETIME_SUB Devuelve un integer que representa un código de subtipo datetime o null si los tipos de datos SQL no aplican.
CHAR_OCTET_LENGTH Tamaño máximo en bytes para los tipos de datos de carácter de la columna, que coincide con COLUMN_SIZE para un solo byte de datos o null para un tipo de datos que no son caracteres.
ORDINAL_POSITION La posición de la columna comenzando desde 1 en la tabla.
IS_NULLABLE Una cadena cuyo valor es 'YES' significa que la columna es nula y 'NO' significa que la columna no puede ser nula.

Ver también

  • db2_column_privileges() - Devuelve un conjunto de resultados que lista las columnas y sus privilegios de una tabla
  • db2_foreign_keys() - Devuelve un conjunto de resultados que lista las claves externas de una tabla
  • db2_primary_keys() - Devuelve un conjunto de resultados que lista las claves de una tabla
  • db2_procedure_columns() - Devuelve un conjunto de resultados que lista los argumentos de procedimiento de registro
  • db2_procedures() - Devuelve un conjunto de resultados que lista las proceduras de registro almacenadas en la base de datos
  • db2_special_columns() - Devuelve un conjunto de resultados que lista los identificadores únicos de las filas de una tabla
  • db2_statistics() - Devuelve un conjunto de resultados que enumera los índices y estadísticas de una tabla
  • db2_table_privileges() - Devuelve un conjunto de resultados que lista las tablas y sus privilegios asociados en una base de datos
  • db2_tables() - Devuelve la lista de tablas y sus metadatos

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