PHP Conference Nagoya 2025

    db2_columns

    (PECL ibm_db2 >= 1.0.0)

    db2_columns — Retourne un jeu de résultats listant les colonnes et ses métadonnées d'une table

    Description

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

    Retourne un jeu de résultats listant les colonnes et ses métadonnées d'une table.

    Liste de paramètres

    connection

    Une connexion valide à une base de données IBM DB2, Cloudscape ou Apache Derby.

    qualifier

    Un qualificatif pour les bases de données DB2 qui fonctionnent sur les serveurs OS/390 ou z/OS. Pour les autres bases de données, passez null ou une chaîne vide.

    schema

    Le schéma qui contient les tables. Pour concorder avec tous les schémas, passez '%'.

    table_name

    Le nom de la table. Pour obtenir toutes les tables dans la base de données, passez null ou une chaîne vide.

    column_name

    Le nom de la colonne. Pour obtenir toutes les colonnes de la table, passez null ou une chaîne vide.

    Valeurs de retour

    Retourne une ressource avec le jeu de résultats contenant les lignes qui décrivent les privilèges des colonnes concordant avec les paramètres spécifiés. Les lignes sont composées des colonnes suivantes :

    Nom de la colonne Description
    TABLE_CAT Nom du catalogue. La valeur est null si la table ne possède pas de catalogue.
    TABLE_SCHEM Nom du schéma.
    TABLE_NAME Nom de la table.
    COLUMN_NAME Nom de la colonne.
    DATA_TYPE Le type de données SQL pour la colonne, représenté comme un entier.
    TYPE_NAME Une chaîne représentant le type de données pour la colonne.
    COLUMN_SIZE Un entier représentant la grandeur de la colonne.
    BUFFER_LENGTH Nombre d'octets maximaux nécessaires pour enregistrer des données de cette colonne.
    DECIMAL_DIGITS L'échelle de la colonne ou null où l'échelle n'est pas applicable.
    NUM_PREC_RADIX Un entier pouvant être 10 (représentant un type de données numérique exact), 2 (représentant un type de données numériques approximé) ou null (représentant un type de données pour lequel la base n'est pas applicable).
    NULLABLE Un entier représentant si la colonne peut être nulle ou pas.
    REMARKS Description de la colonne.
    COLUMN_DEF Valeur par défaut de la colonne.
    SQL_DATA_TYPE Un entier représentant la grandeur de la colonne.
    SQL_DATETIME_SUB Retourne un entier représentant un code de sous-type datetime ou null si les types de données SQL n'appliquent pas.
    CHAR_OCTET_LENGTH Grandeur maximale en octets pour les types de données d'un caractère de la colonne, qui concorde avec COLUMN_SIZE pour un seul octet de données ou null pour un type de données qui n'est pas des caractères.
    ORDINAL_POSITION La position de la colonne commençant à 1 dans la table.
    IS_NULLABLE Une chaîne dont la valeur est 'YES' signifie que la colonne est nulle et 'NO' signifie que la colonne ne peut être nulle.

    Voir aussi

    • db2_column_privileges() - Retourne un jeu de résultats listant les colonnes et ses privilèges d'une table
    • db2_foreign_keys() - Retourne un jeu de résultats listant les clés étrangères d'une table
    • db2_primary_keys() - Retourne un jeu de résultats listant les clés d'une table
    • db2_procedure_columns() - Retourne un jeu de résultats listant les paramètres de procédure d'enregistrement
    • db2_procedures() - Retourne un jeu de résultats listant les procédures d'enregistrement enregistrées dans la base de données
    • db2_special_columns() - Retourne un jeu de résultats listant les identifiants uniques des lignes d'une table
    • db2_statistics() - Retourne un jeu de résultats listant les index et statistiques d'une table
    • db2_table_privileges() - Retourne un jeu de résultats listant les tables et leurs privilèges qui leur sont associées d'une base de données
    • db2_tables() - Retourne la liste des tables et leurs métadonnées

    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