Edit Report a Bug

    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() - Возвращает набор результатов, в котором перечислены таблицы и связанные метаданные в базе данных

    add a note 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
    add a note add a note
    To Top