Article
03/31/2012

sp_primarykeys (Transact-SQL)

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 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. L'argument table_server est du type sysname, sans valeur par défaut.
[ @table_name = ] 'table_name'
Nom de la base de données pour laquelle les informations de clé primaire sont demandées. L'argument table_nameest du type sysname, avec NULL comme valeur par défaut.
[ @table_schema = ] 'table_schema'
Schéma de la table. L'argument table_schema est de type sysname, avec NULL comme valeur par défaut. Dans l'environnement SQL Server 2008, 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. L'argument table_catalog est du type sysname, avec NULL comme valeur par défaut.

Valeurs des codes de retour

Aucune

Jeux de résultats

Nom de 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 l'autorisation SELECT sur le schéma.

Exemple

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

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