• Article

sp_tables_ex (Transact-SQL)

Retourne des informations de table sur les tables provenant du serveur lié spécifié.

Icône Lien de rubriqueConventions de la syntaxe Transact-SQL

Syntaxe

sp_tables_ex [ @table_server = ] 'table_server' 
     [ , [ @table_name = ] 'table_name' ] 
     [ , [ @table_schema = ] 'table_schema' ]
     [ , [ @table_catalog = ] 'table_catalog' ] 
     [ , [ @table_type = ] 'table_type' ] 
     [ , [@fUsePattern = ] 'fUsePattern' ]

Arguments

  • [ @table_server= ] 'table_server'
    Nom du serveur lié pour lequel sont retournées les informations de table. table_server est de type sysname, sans valeur par défaut.

  • [ , [ @table_name= ] 'table_name']
    Nom de la table dans laquelle sont retournées les informations de type de données. table_nameest du type sysname, avec NULL comme valeur par défaut.

  • [ @table_schema= ] 'table_schema']
    Schéma de la table. table_schemaest du type sysname, avec NULL comme valeur par défaut.

  • [ @table_catalog= ] 'table_catalog'
    Nom de la base de données qui contient le table_name spécifié. L'argument table_catalog est du type sysname, avec NULL comme valeur par défaut.

  • [ @table_type= ] 'table_type'
    Type de la table à retourner. L'argument table_type est du type sysname, avec NULL comme valeur par défaut, et il peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    ALIAS

    Nom d'un alias.

    GLOBAL TEMPORARY

    Nom d'une table temporaire disponible au niveau du système.

    LOCAL TEMPORARY

    Nom d'une table temporaire disponible uniquement au niveau du travail en cours.

    SYNONYM

    Nom d'un synonyme.

    SYSTEM TABLE

    Nom d'une table système.

    SYSTEM VIEW

    Nom d'une vue système.

    TABLE

    Nom d'une table utilisateur.

    VIEW

    Nom d'une vue.

  • [ @fUsePattern= ] 'fUsePattern'
    Détermine si les caractères _, %, [ et ] sont interprétés comme des caractères génériques. Les valeurs valides sont 0 (critères spéciaux désactivés) et 1 (critères spéciaux activés). fUsePattern est du type bit, avec 1 comme valeur par défaut.

Valeurs des codes de retour

Aucune

Ensemble de résultats

Nom de colonne

Type de données

Description

TABLE_CAT

sysname

Nom du qualificateur de la table. Certains produits SGDB gèrent une dénomination des tables en trois composantes (qualifier.owner.name). Dans SQL Server 2008, cette colonne représente le nom de la base de données. Dans certains produits, elle représente le nom du serveur de l'environnement de base de données de la table. Ce champ peut contenir la valeur NULL.

TABLE_SCHEM

sysname

Nom du propriétaire de la table. Dans SQL Server, cette colonne représente le nom de l'utilisateur de la base de données qui a créé la table. Ce champ retourne toujours une valeur.

TABLE_NAME

sysname

Nom de la table Ce champ retourne toujours une valeur.

TABLE_TYPE

varchar(32)

Table, table système ou vue.

REMARKS

varchar(254)

SQL Server ne retourne pas de valeur pour cette colonne.

Notes

La procédure stockée sp_tables_ex s'exécute en interrogeant l'ensemble des lignes TABLES de l'interface IDBSchemaRowset du fournisseur OLE DB correspondant à table_server. Les paramètres table_name, table_schema, table_catalog et column sont passés à cette interface afin de réduire le nombre de lignes retournées.

sp_tables_ex retourne un ensemble de résultats vide si le fournisseur OLE DB du serveur lié spécifié ne gère pas l'ensemble de lignes TABLES de l'interface IDBSchemaRowset.

Autorisations

Nécessite l'autorisation SELECT sur le schéma.

Exemple

L'exemple suivant retourne des informations sur les tables contenues dans le schéma HumanResources de la base de données AdventureWorks2008R2, sur le serveur lié LONDON2.

EXEC sp_tables_ex @table_server = 'LONDON2', 
@table_catalog = 'AdventureWorks2008R2', 
@table_schema = 'HumanResources', 
@table_type = 'TABLE';