sp_tables_ex (Transact-SQL)

  • Article

S'applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @table_server = ] N’table_server'

Nom du serveur lié pour lequel retourner les informations de table. @table_server est sysname, sans valeur par défaut.

[ @table_name = ] N’table_name'

Nom de la table pour laquelle retourner les informations de type de données. @table_name est sysname, avec la valeur par défaut NULL.

[ @table_schema = ] N’table_schema'

Schéma de table. @table_schema est sysname, avec la valeur par défaut NULL.

[ @table_catalog = ] N’table_catalog'

Nom de la base de données dans laquelle réside le table_name spécifié. @table_catalog est sysname, avec la valeur par défaut NULL.

[ @table_type = ] N’table_type'

Type de la table à retourner. @table_type est sysname et peut avoir 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 bit, avec la valeur par défaut 1.

Valeurs des codes de retour

Aucune.

Jeu de résultats

Nom de la colonne Type de données Description
TABLE_CAT sysname Nom du qualificateur de la table. Différents produits SGBD prennent en charge le nommage en trois parties pour les tables (<qualifier>.<owner>.<name>). Dans SQL Server, cette colonne représente le nom de la base de données. Dans d’autres produits, il représente le nom du serveur de l’environnement de base de données de la table. Ce champ peut être 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

sp_tables_ex est exécuté en interrogeant l’ensemble de lignes TABLES de l’interface IDBSchemaRowset du fournisseur OLE DB correspondant à table_server. Les paramètres table_name, table_schema, table_catalog et de colonne sont passés à cette interface pour restreindre les lignes retournées.

sp_tables_ex retourne un jeu de résultats vide si le fournisseur OLE DB du serveur lié spécifié ne prend pas en charge l’ensemble TABLES de lignes de l’interface IDBSchemaRowset .

autorisations

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

Exemples

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

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

Contenu connexe