다음을 통해 공유


SQLBrowseConnect

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

SQLBrowseConnect 는 세 가지 수준의 연결 정보로 분류할 수 있는 키워드를 사용합니다. 각 키워드에 대해 다음 표는 유효한 값 목록이 반환되는지 여부와 키워드가 선택 사항인지 여부를 나타냅니다.

수준 1

키워드 목록이 반환 되나요? 선택 사항 여부 설명
DSN 해당 없음 아니요 SQLDataSources에서 반환된 데이터 원본의 이름입니다. DRIVER 키워드를 사용하는 경우 DSN 키워드를 사용할 수 없습니다.
DRIVER 해당 없음 아니요 SQL Server Native Client ODBC 드라이버 이름은 {SQL Server Native Client 11}입니다. DSN 키워드를 사용하는 경우 DRIVER 키워드를 사용할 수 없습니다.

수준 2

키워드 목록이 반환 되나요? 선택 사항 여부 설명
SERVER 아니요 데이터 원본이 있는 네트워크의 서버 이름입니다. "(local)"이라는 용어를 서버로 입력할 수 있습니다. 이 경우 SQL Server의 로컬 복사본을 네트워크로 연결되지 않은 버전인 경우에도 사용할 수 있습니다.
UID 사용자 로그인 ID입니다.
PWD 아니요 예(사용자에 따라 다름) 사용자가 지정한 암호입니다.
APP SQLBrowseConnect를 호출하는 애플리케이션의 이름입니다.
WSID 워크스테이션 ID입니다. 일반적으로 애플리케이션이 실행되는 컴퓨터의 네트워크 이름입니다.

수준 3

키워드 목록이 반환 되나요? 선택 사항 여부 설명
DATABASE SQL Server 데이터베이스의 이름입니다.
LANGUAGE SQL Server에서 사용하는 국가별 언어입니다.

SQLBrowseConnect 는 ODBC 데이터 원본 정의에 저장된 DATABASE 및 LANGUAGE 키워드의 값을 무시합니다. SQLBrowseConnect에 전달된 연결 문자열 지정된 데이터베이스 또는 언어가 잘못된 경우 SQLBrowseConnect는 SQL_NEED_DATA 및 수준 3 연결 특성을 반환합니다.

SQLSetConnectAttr를 호출하여 설정되는 다음 특성은 SQLBrowseConnect에서 반환된 결과 집합을 결정합니다.

특성 설명
SQL_COPT_SS_BROWSE_CONNECT SQL_MORE_INFO_YES 설정하면 SQLBrowseConnect 는 확장된 서버 속성 문자열을 반환합니다.

다음은 SQLBrowseConnect에서 반환된 확장 문자열의 예입니다.



ServerName\InstanceName;Clustered:No;Version:8.00.131



이 문자열에서 세미콜론은 서버에 대한 다양한 정보 부분을 구분합니다. 서로 다른 서버 인스턴스를 구분하려면 쉼표를 사용합니다.
SQL_COPT_SS_BROWSE_SERVER 서버 이름을 지정 하면 SQLBrowseConnect 는 지정된 서버에 대한 정보를 반환합니다. SQL_COPT_SS_BROWSE_SERVER NULL 로 설정된 경우 SQLBrowseConnect 는 도메인의 모든 서버에 대한 정보를 반환합니다.



네트워크 문제로 인해 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를 사용하여 Always On 가용성 그룹 클러스터에 연결하는 방법에 대한 자세한 내용은 고가용성 재해 복구에 대한 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에 대한 설명을 포함시켰습니다.

참고 항목

SQLBrowseConnect 함수
ODBC API 구현 정보