SQLBrowseConnect
SQLBrowseConnect는 세 수준의 연결 정보로 분류될 수 있는 키워드를 사용합니다. 다음 표에서는 각 키워드에 대해 유효한 값 목록의 반환 여부와 키워드가 선택 사항인지 여부를 보여 줍니다.
수준 1
키워드 |
목록 반환 여부 |
선택 사항 여부 |
설명 |
|---|---|---|---|
DSN |
해당 없음 |
지원하지 않음 |
SQLDataSources에서 반환되는 데이터 원본의 이름입니다. DRIVER 키워드가 사용되는 경우에는 DSN 키워드를 사용할 수 없습니다. |
DRIVER |
N/A |
아니요 |
Microsoft_ SQL Server Native Client ODBC 드라이버 이름은 {SQL Server Native Client 11}입니다. DSN 키워드가 사용되는 경우에는 DRIVER 키워드를 사용할 수 없습니다. |
수준 2
키워드 |
목록 반환 여부 |
선택 사항 여부 |
설명 |
|---|---|---|---|
SERVER |
지원됨 |
지원하지 않음 |
데이터 원본이 있는 네트워크의 서버 이름입니다. "(로컬)"이란 용어를 서버로 입력할 수 있으며, 이 경우 네트워크로 연결되지 않은 버전인 경우에도 SQL Server의 로컬 복사본을 사용할 수 있습니다. |
UID |
지원하지 않음 |
지원됨 |
사용자 로그인 ID입니다. |
PWD |
지원하지 않음 |
예(사용자에 따라 달라짐) |
사용자가 지정한 암호입니다. |
APP |
지원하지 않음 |
지원됨 |
SQLBrowseConnect를 호출하는 응용 프로그램 이름입니다. |
WSID |
아니요 |
예 |
워크스테이션 ID입니다. 일반적으로 응용 프로그램이 실행되는 컴퓨터의 네트워크 이름입니다. |
수준 3
키워드 |
목록 반환 여부 |
선택 사항 여부 |
설명 |
|---|---|---|---|
DATABASE |
지원됨 |
지원됨 |
SQL Server 데이터베이스의 이름입니다. |
LANGUAGE |
지원됨 |
지원됨 |
SQL Server에서 사용하는 국가별 언어입니다. |
SQLBrowseConnect는 ODBC 데이터 원본 정의에 저장된 LANGUAGE 키워드와 DATABASE 값을 무시합니다. SQLBrowseConnect에 전달되는 연결 문자열에 지정된 데이터베이스 또는 언어가 잘못된 경우 SQLBrowseConnect에서 SQL_NEED_DATA 및 수준 3 연결 특성을 반환합니다.
SQLSetConnectAttr을 호출하여 설정되는 다음 특성은 SQLBrowseConnect에서 반환되는 결과 집합을 결정합니다.
특성 |
설명 |
|---|---|
SQL_COPT_SS_BROWSE_CONNECT |
SQL_MORE_INFO_YES로 설정된 경우 SQLBrowseConnect는 서버 속성의 확장 문자열을 반환합니다. SQLBrowseConnect에 의해 반환되는 확장 문자열의 예는 다음과 같습니다. 이 문자열에서 세미콜론은 서버에 대한 다양한 정보 부분을 구분합니다. 서로 다른 서버 인스턴스를 구분하려면 쉼표를 사용합니다. |
SQL_COPT_SS_BROWSE_SERVER |
서버 이름이 지정된 경우 SQLBrowseConnect는 지정된 서버에 대한 정보를 반환합니다. SQL_COPT_SS_BROWSE_SERVER가 NULL로 설정된 경우 SQLBrowseConnect는 도메인의 모든 서버에 대한 정보를 반환합니다.
|
SQL_COPT_SS_BROWSE_CACHE_DATA |
SQL_COPT_SS_BROWSE_CACHE_DATA 특성이 SQL_CACHE_DATA_YES로 설정되었을 때 버퍼 길이가 결과를 저장하기에 부족한 경우 데이터를 청크로 인출할 수 있습니다. 버퍼 길이는 SQLBrowseConnect.에 대한 BufferLength 인수에 지정되어 있습니다. 더 많은 데이터를 사용할 수 있을 때 SQL_NEED_DATA가 반환됩니다. 검색할 데이터가 더 없는 경우 SQL_SUCCESS가 반환됩니다. 기본값은 SQL_CACHE_DATA_NO입니다. |
고가용성 재해 복구를 위한 SQLBrowseConnect 지원
SQLBrowseConnect를 사용하여 AlwaysOn 가용성 그룹 클러스터에 연결하는 방법에 대한 자세한 내용은 고가용성 재해 복구를 위한 SQL Server Native Client 지원을 참조하십시오.
SPN(서비스 사용자 이름)에 대한 SQLBrowseConnect 지원
연결이 열릴 때 SQL Server Native Client는 SQL_COPT_SS_MUTUALLY_AUTHENTICATED 및 SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD를 연결을 여는 데 사용하는 인증 방법으로 설정합니다.
SPN에 대한 자세한 내용은 클라이언트 연결(ODBC)의 SPN(서비스 사용자 이름)을 참조하십시오.
참고 항목
개념
관련 자료
변경 내역
업데이트된 내용 |
|---|
SQL_COPT_SS_BROWSE_CACHE_DATA에 대한 설명을 포함시켰습니다. |