SQLGetConnectAttr

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Database 예Azure SQL Managed Instance 예Azure Synapse Analytics 예병렬 데이터 웨어하우스

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 함수
ODBC API 구현 세부 정보
SET QUOTED_IDENTIFIER(Transact-SQL)
SET ANSI_NULLS(Transact-SQL)
SET ANSI_PADDING(Transact-SQL)
SET ANSI_WARNINGS(Transact-SQL)