sp_primarykeys (Transact-SQL)
Retorna as colunas de chave primária, uma linha por coluna da chave, da tabela remota especificada.
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 a partir do qual as informações de chave primária devem ser retornadas. table_server é sysname, sem padrão.[ @table_name = ] 'table_name'
É o nome da tabela para a qual as informações de chave primária devem ser fornecidas. table_nameé sysname, com um padrão NULL.[ @table_schema = ] 'table_schema'
É o esquema da tabela. table_schema é sysname, com um padrão NULL. No ambiente do SQL Server 2008, isso corresponde ao proprietário de tabela.[ @table_catalog = ] 'table_catalog'
É o nome do catálogo no qual o table_name especificado reside. No ambiente do SQL Server, isto corresponde ao nome do banco de dados. table_catalog é sysname, com um padrão NULL.
Valores de 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 seqüê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-se 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 column são passados para essa interface a fim de 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 AdventureWorks.
EXEC sp_primarykeys @table_server = N'LONDON1',
@table_name = N'JobCandidate',
@table_catalog = N'AdventureWorks',
@table_schema = N'HumanResources'
Consulte também