MSdbms (Transact-SQL)

Syntaxe

sp_columns [ @table_name = ] object  [ , [ @table_owner = ] owner ] 
     [ , [ @table_qualifier = ] qualifier ] 
     [ , [ @column_name = ] column ] 
     [ , [ @ODBCVer = ] ODBCVer ]

Arguments

• [ @table_name=] object
  Nom de la table ou vue utilisée pour retourner les informations de catalogue. object_name est de type nvarchar(384), sans valeur par défaut. La recherche de correspondance avec des caractères génériques est prise en charge.

• [ @table_owner=] owner
  Nom du propriétaire de l'objet table ou vue utilisé pour renvoyer des informations de catalogue. owner est de type nvarchar(384), avec NULL comme valeur par défaut. La recherche de correspondance avec des caractères génériques est prise en charge. Si l'argument owner n'est pas spécifié, les règles définissant par défaut la visibilité des tables ou vues du SGBD sous-jacent s'appliquent.

  Si l'utilisateur actuel est propriétaire d'une table ou vue portant le nom spécifié, les colonnes de cette table sont retournées. Si l'argument owner n'est pas spécifié et que l'utilisateur actuel ne possède pas de table ou de vue contenant la valeur object spécifiée, la procédure sp_columns recherche une table ou vue contenant la valeur object spécifiée et appartenant au propriétaire de la base de données. S'il en existe une, les colonnes de cette table sont retournées.

• [ @table_qualifier=] qualifier
  Nom du qualificateur de la table ou de la vue. qualifier est de type sysname, avec NULL comme valeur par défaut. Divers produits SGDB prennent en charge les noms de table en trois parties (qualifier**.owner.**name). Dans SQL Server, 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.

• [ @column_name=] column
  Colonne unique utilisée lorsqu'une seule colonne d'informations de catalogue est demandée. column est de type nvarchar(384), avec NULL comme valeur par défaut. Si l'argument column n'est pas spécifié, toutes les colonnes sont retournées. Dans SQL Server, column représente le nom de la colonne tel qu'il figure dans la table syscolumns. La recherche de correspondance avec des caractères génériques est prise en charge. Pour assurer une interopérabilité maximale, le client de la passerelle ne doit utiliser que les modèles de comparaison standard de SQL-92 (caractères génériques % et _).

• [ @ODBCVer=] ODBCVer
  Version d'ODBC actuellement utilisée. ODBCVer est de type int, avec 2 comme valeur par défaut. Cela indique ODBC version 2. Les valeurs valides sont 2 ou 3. Pour connaître les différences de comportement entre les versions 2 et 3, consultez la spécification ODBC SQLColumns.

Valeurs du code de retour

Aucune

Ensembles de résultats

La procédure stockée de catalogue sp_columns est équivalente à SQLColumns dans ODBC. Les résultats renvoyés sont triés par TABLE_QUALIFIER, TABLE_OWNER et TABLE_NAME.

1 Pour plus d'informations, consultez la documentation de Microsoft ODBC.

Autorisations

Nécessite une autorisation SELECT sur le schéma.

Notes

sp_columns satisfait aux conditions requises pour l'utilisation d'identificateurs délimités. Pour plus d'informations, consultez Identificateurs délimités (Moteur de base de données).

Exemples

L'exemple suivant retourne les informations de colonne pour une table spécifique.

USE AdventureWorks
GO
EXEC sp_columns @table_name = N'Department',
   @table_owner = N'HumanResources';

Voir aussi

Référence