sp_primarykeys (Transact-SQL)

Article
12/15/2008

Retourne les colonnes clé 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. L'argument table_server est du type sysname, sans valeur par défaut.

[ @table_name =] 'table_name'

Nom de la table à laquelle doivent être fournies les informations de clé primaire. 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 du type sysname, avec NULL comme valeur par défaut. Dans l'environnement SQL Server 2005, 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, correspond au nom de la base de données. L'argument table_catalog est du type sysname, avec NULL comme valeur par défaut.

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 multicolonnes
PK_NAME	sysname	Identificateur de clé primaire. Retourne la valeur NULL s'il n'est pas applicable à la source de données.

Notes

La procédure sp_primarykeys est exécutée 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 réduire le nombre de lignes retourné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.

Valeurs des codes retournés

Aucune

Exemple

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

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

Voir aussi

Référence

Procédures stockées de requêtes distribuées (Transact-SQL)
sp_catalogs (Transact-SQL)
sp_column_privileges (Transact-SQL)
sp_foreignkeys (Transact-SQL)
sp_indexes (Transact-SQL)
sp_linkedservers (Transact-SQL)
sp_tables_ex (Transact-SQL)
sp_table_privileges (Transact-SQL)
Procédures stockées système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005

Partager via