SQLGetConnectAttr
SQL Server Native Client ODBC 드라이버는 드라이버별 연결 특성을 정의합니다. 일부 특성은 에서 사용할 수 SQLGetConnectAttr
있으며 함수는 현재 설정을 보고하는 데 사용됩니다. 이러한 특성에 대해 보고되는 값은 연결을 설정하거나 SQLSetConnectAttr을 사용하여 특성을 설정할 때까지 보장되지 않습니다.
이 항목에서는 읽기 전용 특성을 나열합니다. 다른 SQL Server Native Client ODBC 드라이버 관련 연결 특성에 대한 자세한 내용은 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 특성은 클라이언트 연결 ID를 검색하며, 이 ID를 사용하여 다음을 찾을 수 있습니다.
설정할 경우 XEvents 로그의 진단 정보
연결 링 버퍼의 연결 오류 정보
설정할 경우 데이터 액세스 추적 로그의 진단 정보
자세한 내용은 확장 이벤트 로그에서 진단 정보 액세스를 참조하세요.
값 | Description |
---|---|
SQL_ERROR | 연결하지 못했습니다. |
SQL_SUCCESS | 연결이 성공했습니다. 출력 버퍼에서 클라이언트 연결 ID를 찾습니다. |
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 특성은 사용자 데이터 포인터를 검색합니다. 사용자 데이터는 클라이언트 소유의 메모리에 저장되고 연결별로 기록됩니다. 사용자 데이터 포인터가 설정되지 않은 경우 NULL 포인터인 SQL_UD_NOTSET가 반환됩니다.
값 | Description |
---|---|
SQL_UD_NOTSET | 사용자 데이터 포인터가 설정되어 있지 않습니다. |
다른 모든 값 | 사용자 데이터에 대한 포인터입니다. |
SPN(서비스 사용자 이름)에 대한 SQLGetConnectAttr 지원
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가 설정되지 않은 경우 기본값(빈 문자열)이 반환됩니다.
SPN에 대한 자세한 내용은 ODBC(클라이언트 연결)의 SPN(서비스 사용자 이름)을 참조하세요.
참고 항목
SQLGetConnectAttr 함수(SQLGetConnectAttr Function)
ODBC API 구현 정보
SET QUOTED_IDENTIFIER(Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING(Transact-SQL)
SET ANSI_WARNINGS(Transact-SQL)