sp_primarykeys (Transact-SQL)

Article
08/19/2013

Retourne les colonnes de clés primaires, une ligne par colonne clé, pour la table distante spécifiée.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_primarykeys [ @table_server = ] 'table_server' 
     [ , [ @table_name = ] 'table_name' ] 
     [ , [ @table_schema = ] 'table_schema' ] 
     [ , [ @table_catalog = ] 'table_catalog' ]

Arguments

[ @table_server = ] **'**table_server'
Nom du serveur lié à partir duquel sont retournées les informations de clé primaire. table_server est de type sysname et n'a pas de valeur par défaut.
[ @table_name = ] 'table_name'
Nom de la table pour laquelle les informations de clé primaire sont demandées. table_nameest de type sysname, avec NULL comme valeur par défaut.
[ @table_schema = ] 'table_schema'
Schéma de la table. table_schema est de type sysname, avec NULL comme valeur par défaut. Dans l'environnement SQL Server, ceci correspond au propriétaire de la table.
[ @table_catalog = ] 'table_catalog'
Nom du catalogue dans lequel réside l'argument table_name spécifié. Dans l'environnement SQL Server, cet argument correspond au nom de la base de données. table_catalog est de type sysname, avec NULL comme valeur par défaut.

Valeurs des codes de retour

Aucun

Jeux de résultats

Nom de la colonne	Type de données	Description
TABLE_CAT	sysname	Catalogue de la table
TABLE_SCHEM	sysname	Schéma de la table
TABLE_NAME	sysname	Nom de la table.
COLUMN_NAME	sysname	Nom de la colonne.
KEY_SEQ	int	Numéro d'ordre de la colonne dans une clé primaire multicolonne
PK_NAME	sysname	Identificateur de clé primaire. Retourne la valeur NULL s'il n'est pas applicable à la source de données.

Notes

sp_primarykeys est exécuté en interrogeant l'ensemble de lignes PRIMARY_KEYS 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 limiter le nombre de lignes renvoyées.

La procédure sp_primarykeys retourne un jeu de résultats vide si le fournisseur OLE DB du serveur lié spécifié ne prend pas en charge l'ensemble de lignes PRIMARY_KEYS de l'interface IDBSchemaRowset.

Autorisations

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

Exemples

L'exemple suivant retourne des colonnes de clé primaires du serveur LONDON1 pour la table HumanResources.JobCandidate dans la base de données AdventureWorks2012 .

EXEC sp_primarykeys @table_server = N'LONDON1', 
   @table_name = N'JobCandidate',
   @table_catalog = N'AdventureWorks2012', 
   @table_schema = N'HumanResources';