sp_primarykeys (Transact-SQL)
Aplica-se a: SQL Server
Retorna as colunas de chave primária, uma linha por coluna de chave, da tabela remota especificada.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_primarykeys [ @table_server = ] 'table_server'
[ , [ @table_name = ] 'table_name' ]
[ , [ @table_schema = ] 'table_schema' ]
[ , [ @table_catalog = ] 'table_catalog' ]
Argumentos
[ @table_server = ] 'table_server'_
É o nome do servidor vinculado do qual retornar informações de chave primária. table_server é sysname, sem padrão.
[ @table_name = ] 'table_name'
É o nome da tabela para a qual fornecer informações de chave primária. table_name é sysname, com um padrão de NULL.
[ @table_schema = ] 'table_schema'
É o esquema da tabela. table_schema é sysname, com um padrão de NULL. No ambiente do SQL Server, isso corresponde ao proprietário da tabela.
[ @table_catalog = ] 'table_catalog'
É o nome do catálogo no qual o table_name especificado reside. No ambiente do SQL Server, isso corresponde ao nome do banco de dados. table_catalog é sysname, com um padrão de NULL.
Valores do código de retorno
Nenhum
Conjuntos de resultados
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
TABLE_CAT | sysname | Catálogo da tabela. |
TABLE_SCHEM | sysname | Esquema da tabela. |
TABLE_NAME | sysname | Nome da tabela. |
COLUMN_NAME | sysname | Nome da coluna. |
KEY_SEQ | int | Número de sequência da coluna em uma chave primária de várias colunas. |
PK_NAME | sysname | Identificador da chave primária. Retorna NULL se não for aplicável à fonte de dados. |
Comentários
sp_primarykeys é executado consultando o conjunto de linhas PRIMARY_KEYS da interface IDBSchemaRowset do provedor OLE DB correspondente a table_server. Os parâmetros table_name, table_schema, table_catalog e coluna são passados para essa interface para restringir as linhas retornadas.
sp_primarykeys retornará um conjunto de resultados vazio se o provedor OLE DB do servidor vinculado especificado não oferecer suporte ao conjunto de linhas PRIMARY_KEYS da interface IDBSchemaRowset.
Permissões
Requer a permissão SELECT no esquema.
Exemplos
O exemplo a seguir retorna as colunas da chave primária do servidor LONDON1
para a tabela HumanResources.JobCandidate
no banco de dados AdventureWorks2022
.
EXEC sp_primarykeys @table_server = N'LONDON1',
@table_name = N'JobCandidate',
@table_catalog = N'AdventureWorks2022',
@table_schema = N'HumanResources';
Confira também
Procedimentos armazenados de consultas distribuídas (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)
Procedimentos armazenados do sistema (Transact-SQL)