Manuel PHP
Précédent |  | Suivant

# odbc_tables

(3.0.17 - 3.0.18 only, PHP 4 >= 4.0.0)

odbc_tables -- Liste les tables d'une source.

## Description

``int odbc_tables` (odbc_setoption connection_id [, string qualifier [, string owner [, string name [, string types]]]])`

odbc_tables() liste toutes les tables de la source et retourne un identifiant de résultat ODBC, ou bien `FALSE` en cas d'erreur.

Le résultat contient les colonnes suivantes :

- TABLE_QUALIFIER

- TABLE_OWNER

- TABLE_NAME

- TABLE_TYPE

- REMARKS

Le résultat est ordonné grâce aux options TABLE_TYPE, TABLE_QUALIFIER, TABLE_OWNER et TABLE_NAME.

Les paramètres `owner` et `name` acceptent des masques de recherche ('%' pour remplacer zéro ou plus caractères, et '_' pour n'en remplacer qu'un seul).

Pour supporter les énumérations de qualificateurs propriétaires et types de table, la sémantique suivante pour les paramètres `qualifier`, `owner`, `name` et `table_type` sont disponibles :

- Si `qualifier` est un signe de pourcentage (%), et `owner` et `name` sont des chaînes vides, alors le résultat contient la liste des qualifiers valides pour la source. (toutes les colonnes hormis TABLE_QUALIFIER contiennent NULL).

- Si `owner` est un signe de pourcentage (%), et `qualifier` et `name` sont des chaînes vides, alors le résultat contient la liste des propriétaires de la source (toutes les colonnes hormis TABLE_OWNER contiennent NULL).

- Si `table_type` est un signe de pourcentage (%), et `qualifier`, `owner` et `name` sont des chaînes vides, alors le résultat contient la liste des types de tables de la source (toutes les colonnes hormis TABLE_TYPE contiennent NULL).

Si `table_type` n'est pas une chaîne vide, il doit contenir une liste de valeurs, séparées par des virgules, qui representent les types recherchés. Chaque valeur peut être insérée entre guillemets simples ('), ou sans guillemets. Par exemple "'TABLE','VIEW'" ou "TABLE, VIEW". Si la source de données ne supporte pas un type de table donné, odbc_tables() ne retournera aucun résultat pour ce type.

Voir aussi odbc_tableprivileges() pour connaître les droits associés.

Précédent | Sommaire | Suivant
odbc_setoption | Niveau supérieur | odbc_tableprivileges