Compartilhar via


SQLPrimaryKeys

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

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 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 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 Parâmetros com valor de tabela (ODBC).

Consulte Também

Função SQLPrimaryKeys
ODBC API Implementation Details