SQLGetConnectAttr

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

Драйвер ODBC для собственного клиента SQL Server определяет атрибуты подключения для конкретного драйвера. Некоторые из этих атрибутов доступны для функции SQLGetConnectAttr, а сама функция используется для определения их текущих значений. Нельзя быть уверенным в правильности значений этих атрибутов, сообщаемых функцией, до тех пор, пока не будет установлено соединение или атрибут не будет задан при помощи функции SQLSetConnectAttr.

В этом разделе приведены атрибуты режима только для чтения. Сведения о других атрибутах подключения odBC собственного клиента SQL Server см. в разделе SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Атрибут SQL_COPT_SS_CONNECTION_DEAD сообщает серверу данные о состоянии соединения. Для определения текущего состояния соединения драйвер запрашивает сеть.

Заметка

Стандартный атрибут соединения ODBC SQL_ATTR_CONNECTION_DEAD возвращает последнее по времени состояние соединения. Может оказаться так, что это состояние соединения будет отличаться от текущего.

значение	Description
SQL_CD_TRUE	Соединение с сервером потеряно.
SQL_CD_FALSE	Соединение открыто и доступно для обработки инструкций.

SQL_COPT_SS_CLIENT_CONNECTION_ID

Атрибут SQL_COPT_SS_CLIENT_CONNECTION_ID извлекает идентификатор соединения клиента, по которому затем производится поиск и обнаружение следующих данных.

• Диагностические сведения в журнале XEvents, если он включен.

• Сведения об ошибке соединения в кольцевом буфере соединения.

• Диагностические сведения в журналах отслеживания доступа к данным, если они включены.

Дополнительные сведения см. в разделе "Доступ к диагностическим сведениям" в журнале расширенных событий.

значение	Description
SQL_ERROR	Ошибка соединения.
SQL_SUCCESS	Подключение выполнено успешно. Идентификатор соединения клиента будет находиться в выходном буфере.

SQL_COPT_SS_PERF_DATA

Атрибут SQL_COPT_SS_PERF_DATA возвращает указатель на структуру SQLPERF, содержащую текущую статистику производительности драйвера. Если ведение журнала производительности не включено, функцияSQLGetConnectAttr возвращает значение NULL. Драйвер не обновляет статистику в структуре SQLPERF динамически. Каждый раз, когда возникает необходимость обновить статистику производительности, вызывайте функцию SQLGetConnectAttr .

значение	Description
NULL	Ведение журнала производительности не включено.
Любое другое значение	Указатель на структуру SQLPERF.

SQL_COPT_SS_PERF_QUERY

Если запись в журнал данных о длительных запросах включена, то атрибут SQL_COPT_SS_PERF_QUERY возвращает значение TRUE. Если запись в журнал данных о запросах неактивна, этот атрибут возвращает значение FALSE.

SQL_COPT_SS_USER_DATA

Атрибут SQL_COPT_SS_USER_DATA извлекает указатель на данные пользователя. Пользовательские данные хранятся в принадлежащей клиенту памяти и записываются отдельно для каждого соединения. Если указатель на данные пользователя на задан, что соответствует значению SQL_UD_NOTSET, то возвращается указатель NULL.

значение	Description
SQL_UD_NOTSET	Указатель на данные пользователя не задан.
Любое другое значение	Указатель на данные пользователя.

Поддержка функции SQLGetConnectAttr для имен участников-служб (SPN)

SQLGetConnectAttr можно использовать для запроса значения новых атрибутов подключения SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption также можно использовать для запроса этих значений.)

Атрибут SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD доступен только для открытых соединений, в которых используется проверка подлинности Windows.

Если атрибут SQL_COPT_SS_SERVER_SPN или SQL_COPT_SS_FAILOVER_PARTNER еще не задан, возвращается значение по умолчанию (пустая строка).

Дополнительные сведения о именах субъектов-служб см. в разделе "Имена субъектов-служб" в клиентских подключениях (ODBC).

См. также

Функция SQLGetConnectAttr
Подробные сведения о реализации API-интерфейсов ODBC
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)