Compartilhar via


SQLPrimaryKeys

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

SQLPrimaryKeys retorna SQL_SUCCESS se existem ou não valores para 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 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 Parâmetros com valor de tabela (ODBC).

Consulte Também

Função SQLPrimaryKeys
ODBC API Implementation Details