Compartilhar 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 havendo ou não havendo 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

Outros recursos