Partilhar via


sp_primarykeys (Transact-SQL)

Aplica-se a:SQL Server

Devolve as colunas de chave primárias, uma linha por coluna de chave, para a tabela remota especificada.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @table_server = ] N'table_server'

O nome do servidor ligado a partir do qual devolver a informação da chave primária. @table_server é sysname, sem padrão.

[ @table_name = ] N'table_name'

O nome da tabela para a qual fornecer a informação da chave primária. @table_name é sysname, com um padrão de NULL.

[ @table_schema = ] N'table_schema'

O esquema da tabela. @table_schema é sysname, com o padrão de NULL. No ambiente SQL Server, este valor corresponde ao proprietário da tabela.

[ @table_catalog = ] N'table_catalog'

O nome do catálogo onde reside a @table_name especificada. @table_catalog é sysname, com um padrão de NULL. No ambiente SQL Server, este valor corresponde ao nome da base de dados.

Valores de código de retorno

Nenhum.

Conjunto de resultados

Nome da coluna Tipo de dados Description
TABLE_CAT sysname Catálogo de mesas.
TABLE_SCHEM sysname Esquema de tabela.
TABLE_NAME sysname Nome da tabela.
COLUMN_NAME sysname Nome da coluna.
KEY_SEQ int Número de sequência da coluna numa chave primária multicolunar.
PK_NAME sysname Identificador de chave primária. Retorna NULL se não for aplicável à fonte de dados.

Observações

sp_primarykeys é executado consultando o PRIMARY_KEYS conjunto de linhas da IDBSchemaRowset interface do fornecedor OLE DB correspondente a @table_server. Os parâmetros são passados para esta interface para restringir as linhas devolvidas.

sp_primarykeys retorna um conjunto de resultados vazio se o fornecedor OLE DB do servidor ligado especificado não suportar o PRIMARY_KEYS conjunto de linhas da IDBSchemaRowset interface.

Permissions

Requer SELECT permissão no esquema.

Examples

O exemplo seguinte devolve colunas de chave primárias do LONDON1 servidor para a HumanResources.JobCandidate tabela na AdventureWorks2025 base de dados.

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