Partilhar via


SQLPrimaryKeys

Uma tabela pode ter uma coluna ou colunas que pode(m) servir como identificador(es) de linha exclusivo(s), e tabelas criadas sem uma restrição PRIMARY KEY retornam um conjunto de resultados vazio para SQLPrimaryKeys. A função ODBC SQLSpecialColumns informa os candidatos de identificador de linha para tabelas sem chaves primárias.

SQLPrimaryKeys retorna SQL_SUCCESS se existir 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.

É possível executar SQLPrimaryKeys 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 ao relatório de informações de 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 do valor padrão SQL_SS_NAME_SCOPE_TABLE, SQLPrimaryKeys retornará informações sobre as colunas de chave primária dos 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 Parâmetros com valor de tabela (ODBC).

Consulte também

Conceitos

Detalhes de implementação da API ODBC

Outros recursos

Função SQLPrimaryKeys