odbc_tables

(PHP 4, PHP 5)

odbc_tables — Liste les tables d'une source

Description

resource odbc_tables ( resource $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 (%), et owner et name 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 (%), 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).

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.

Voir aussi

Fonctions ODBC
PHP Manual