odbc_tables
(PHP 4, PHP 5)
odbc_tables — Liste les tables d'une source
Description
$connection_id
[, string $qualifier
[, string $owner
[, string $name
[, string $types
]]]] )Liste les tables d'une source.
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
est disponible :
-
Si
qualifier
est un signe de pourcentage (%), etowner
etname
sont des chaînes vides, alors le résultat contient la liste des qualifiés valides pour la source (toutes les colonnes hormis TABLE_QUALIFIER contiennent NULL). -
Si
owner
est un signe de pourcentage (%), etqualifier
etname
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 (%), etqualifier
,owner
etname
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).
Liste de paramètres
-
connection_id
-
L'identifiant de connexion ODBC, voir la documentation de la fonction odbc_connect() pour plus de détails.
-
qualifier
-
Le qualifieur.
-
owner
-
Le propriétaire. Accepte des masques de recherche ('%' pour remplacer zéro ou plus caractères, et '_' pour n'en remplacer qu'un seul).
-
name
-
Le nom. Accepte des masques de recherche ('%' pour remplacer zéro ou plus caractères, et '_' pour n'en remplacer qu'un seul).
-
types
-
Si
table_type
n'est pas une chaîne vide, il doit contenir une liste de valeurs, séparées par des virgules, qui représentent 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.
Valeurs de retour
Retourne un identifiant de résultat ODBC contenant les informations
ou FALSE
si une erreur survient.
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.