Compartilhar via


SQLPrimaryKeys

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Uma tabela pode ter uma coluna ou colunas que podem servir como identificadores de linha exclusivos, e as tabelas criadas sem uma restrição PRIMARY KEY retornam um conjunto de resultados vazio para SQLPrimaryKeys. A função ODBC SQLSpecialColumns relata candidatos a identificadores de linha para tabelas sem chaves primárias.

SQLPrimaryKeys retorna SQL_SUCCESS se existem ou não valores para os parâmetros CatalogName, SchemaName ou TableName . SQLFetch retorna SQL_NO_DATA quando são usados valores inválidos nesses parâmetros.

SQLPrimaryKeys pode ser executado em um cursor de servidor estático. Uma tentativa de executar SQLPrimaryKeys em um cursor atualizável (dinâmico ou conjunto de chaves) retornará SQL_SUCCESS_WITH_INFO indicando que o tipo de cursor foi alterado.

O driver ODBC do SQL Server Native Client dá suporte a informações de relatório para tabelas em servidores vinculados, aceitando um nome de duas partes para o parâmetro CatalogName : Linked_Server_Name.Catalog_Name.

SQLPrimaryKeys e parâmetros com valor de tabela

Se o atributo de instrução SQL_SOPT_SS_NAME_SCOPE tiver o valor SQL_SS_NAME_SCOPE_TABLE_TYPE, em vez de seu valor padrão de SQL_SS_NAME_SCOPE_TABLE, SQLPrimaryKeys retornará informações sobre colunas de chave primária de tipos de tabela. Para obter mais informações sobre SQL_SOPT_SS_NAME_SCOPE, consulte SQLSetStmtAttr.

Para obter mais informações sobre parâmetros com valor de tabela, consulte ODBC (Parâmetros com valor de tabela).

Confira também

Função SQLPrimaryKeys
Detalhes da implementação da API do ODBC