PHP 8.4.0 RC4 available for testing

db2_columns

(PECL ibm_db2 >= 1.0.0)

db2_columns Возвращает результирующий набор, перечисляющий столбцы и связанные с ними метаданные для таблицы

Описание

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

Returns a result set listing the columns and associated metadata for a table.

Список параметров

connection

Ресурс соединения с базой данных IBM DB2, Cloudscape или Apache Derby.

qualifier

Квалификатор для баз DB2, работающих на серверах OS/390 или z/OS. В остальных случаях указывайте null или пустую строку.

schema

Схема, содержащая таблицы. Для выбора всех схем укажите '%'.

table_name

Имя таблицы или представления. Для выбора всех таблиц укажите null или пустую строку.

column_name

Имя столбца. Для выбора всех столбцов укажите null или пустую строку.

Возвращаемые значения

Возвращает ресурс оператора с результирующим набором, содержащим строки, описывающие заданные условиями столбцы. Строки содержат следующие поля:

Имя столбца Описание
TABLE_CAT Имя каталога. Если таблица не имеет каталогов, то это поле будет содержать NULL.
TABLE_SCHEM Имя схемы.
TABLE_NAME Имя таблицы или представления.
COLUMN_NAME Имя столбца.
DATA_TYPE Тип данных SQL в виде целого числа.
TYPE_NAME Текстовое представление типа данных.
COLUMN_SIZE Размер столбца в виде целого числа.
BUFFER_LENGTH Максимальное количество байт, необходимое для хранения данных из этого столбца.
DECIMAL_DIGITS Количество цифр после запятой, или null, если не применимо.
NUM_PREC_RADIX Целое число, равное 10 (если длина числа измеряется в десятичных цифрах), 2 (если длина измеряется в битах), или null (если не применимо).
NULLABLE Целое число, определяющее, может ли столбец принимать значение NULL.
REMARKS Описание столбца.
COLUMN_DEF Значение поля по умолчанию.
SQL_DATA_TYPE Целое число, определяющее длину записи.
SQL_DATETIME_SUB Возвращает целое число, описывающее подтип данных Datrtime или null, если не применимо.
CHAR_OCTET_LENGTH Максимальная длина в октетах для символьных типов данных. Совпадает с COLUMN_SIZE для однобайтовых символьных данных или null для несимвольных данных.
ORDINAL_POSITION Порядковый номер столбца в таблице. Начинаются с 1.
IS_NULLABLE Строка равная 'YES', если столбец может быть NULL и 'NO', если нет.

Смотрите также

  • db2_column_privileges() - Возвращает результирующий набор, перечисляющий столбцы и связанные с ним привилегии для таблицы
  • db2_foreign_keys() - Возвращает набор результатов, в котором перечислены внешние ключи таблицы
  • db2_primary_keys() - Возвращает набор результатов, содержащий первичные ключи таблицы
  • db2_procedure_columns() - Возвращает набор результатов со списком параметров хранимой процедуры
  • db2_procedures() - Возвращает набор результатов, в котором перечислены хранимые процедуры, зарегистрированные в базе данных
  • db2_special_columns() - Возвращает набор результатов, в котором перечислены столбцы с уникальным идентификатором строки таблицы
  • db2_statistics() - Возвращает набор результатов, содержащий индекс и статистику таблицы
  • db2_table_privileges() - Возвращает набор результатов, в котором перечислены таблицы и связанные с ними права доступа к базе данных
  • db2_tables() - Возвращает набор результатов, в котором перечислены таблицы и связанные метаданные в базе данных

Добавить

Примечания пользователей 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