Поделиться через


SQLPrimaryKeys

Применимо к:SQL ServerAzure SQL DatabaseAzure Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Таблица может иметь столбец или столбцы, которые могут служить уникальными идентификаторами строк, и таблицы, созданные без ограничения PRIMARY KEY, возвращают пустой результирующий набор в SQLPrimaryKeys. Функция ODBC SQLSpecialColumns сообщает кандидаты на идентификаторы строк для таблиц без первичных ключей.

SQLPrimaryKeys возвращает SQL_SUCCESS, существуют ли значения для параметров CatalogName, SchemaName или TableName . ФункцияSQLFetch возвращает значение SQL_NO_DATA, если в этих параметрах заданы недопустимые значения.

SQLPrimaryKeys можно выполнять на статичном серверном курсоре. Попытка выполнить SQLPrimaryKeys на обновляемом курсоре (динамическом или наборе ключей) вернет SQL_SUCCESS_WITH_INFO, указывая, что тип курсора был изменен.

Драйвер ODBC для собственного клиента SQL Server поддерживает отчеты о таблицах на связанных серверах, принимая двух частей имя параметра CatalogName : Linked_Server_Name.Catalog_Name.

Функция SQLPrimaryKeys и возвращающие табличные значения параметры

Если атрибут инструкции SQL_SOPT_SS_NAME_SCOPE имеет значение SQL_SS_NAME_SCOPE_TABLE_TYPE, а не значение по умолчанию SQL_SS_NAME_SCOPE_TABLE, SQLPrimaryKeys вернет сведения о столбцах первичного ключа типов таблиц. Дополнительные сведения о SQL_SOPT_SS_NAME_SCOPE см. в разделе SQLSetStmtAttr.

Дополнительные сведения о табличном значении параметров см. в разделе "Параметры с табличным значением" (ODBC).

См. также

Функция SQLPrimaryKeys
Подробные сведения о реализации API-интерфейсов ODBC