Partager via


sp_primarykeys (Transact-SQL)

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

Icône Lien de rubriqueConventions 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 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 retournés

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 multicolonnes

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 AdventureWorks.

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