SQLPrimaryKeys

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse Analytics

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

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

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

O driver ODBC SQL Server Native Client suporta informações de reporte para tabelas em servidores ligados, aceitando um nome em duas partes para o parâmetro CatalogName: Linked_Server_Name.Catalog_Name.

SQLPrimaryKeys e Parâmetros Table-Valued

Se o atributo da instrução SQL_SOPT_SS_NAME_SCOPE tiver o valor SQL_SS_NAME_SCOPE_TABLE_TYPE, em vez do seu valor padrão de SQL_SS_NAME_SCOPE_TABLE, SQLPrimaryKeys devolverá informação sobre as colunas principais de chave dos tipos de tabela. Para mais informações sobre SQL_SOPT_SS_NAME_SCOPE, veja SQLSetStmtAttr.

Para mais informações sobre parâmetros com valores de tabela, veja Table-Valued Parâmetros (ODBC).