sp_primarykeys (Transact-SQL)

Article
12/22/2023

S’applique à :SQL Server

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

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 retourner les informations de clé primaire. table_server est sysname, sans valeur par défaut.

[ @table_name = ] 'table_name' Nom de la table pour laquelle fournir des informations de clé primaire. table_name est sysname, avec la valeur null par défaut.

[ @table_schema = ] 'table_schema' Schéma de table. table_schema est sysname, avec la valeur null par défaut. Dans l’environnement SQL Server, cela correspond au propriétaire de la table.

[ @table_catalog = ] 'table_catalog'Nom du catalogue dans lequel réside le table_name spécifié. Dans l’environnement SQL Server, cela correspond au nom de la base de données. table_catalog est sysname, avec une valeur par défaut null.

Codet 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 de séquence de la colonne dans une clé primaire multicolonne.
PK_NAME	sysname	Identificateur de clé primaire. Retourne 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 de colonne sont passés à cette interface pour restreindre les lignes retournées.

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.

Exemples

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

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

Voir aussi

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)