PHP Conference Nagoya 2025

    db2_columns

    (PECL ibm_db2 >= 1.0.0)

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

    Опис

    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

    A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.

    qualifier

    A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass null or an empty string.

    schema

    The schema which contains the tables. To match all schemas, pass '%'.

    table_name

    The name of the table or view. To match all tables in the database, pass null or an empty string.

    column_name

    The name of the column. To match all columns in the table, pass null or an empty string.

    Значення, що повертаються

    Returns a statement resource with a result set containing rows describing the columns matching the specified parameters. The rows are composed of the following columns:

    Column name Description
    TABLE_CAT Name of the catalog. The value is NULL if this table does not have catalogs.
    TABLE_SCHEM Name of the schema.
    TABLE_NAME Name of the table or view.
    COLUMN_NAME Name of the column.
    DATA_TYPE The SQL data type for the column represented as an integer value.
    TYPE_NAME A string representing the data type for the column.
    COLUMN_SIZE An integer value representing the size of the column.
    BUFFER_LENGTH Maximum number of bytes necessary to store data from this column.
    DECIMAL_DIGITS The scale of the column, or null where scale is not applicable.
    NUM_PREC_RADIX An integer value of either 10 (representing an exact numeric data type), 2 (representing an approximate numeric data type), or null (representing a data type for which radix is not applicable).
    NULLABLE An integer value representing whether the column is nullable or not.
    REMARKS Description of the column.
    COLUMN_DEF Default value for the column.
    SQL_DATA_TYPE An integer value representing the size of the column.
    SQL_DATETIME_SUB Returns an integer value representing a datetime subtype code, or null for SQL data types to which this does not apply.
    CHAR_OCTET_LENGTH Maximum length in octets for a character data type column, which matches COLUMN_SIZE for single-byte character set data, or null for non-character data types.
    ORDINAL_POSITION The 1-indexed position of the column in the table.
    IS_NULLABLE A string value where 'YES' means that the column is nullable and 'NO' means that the column is not nullable.

    Прогляньте також

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋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
    To Top