SQLBrowseConnect

아티클
01/10/2024

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

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

수준 1

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

수준 2

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

수준 3

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

SQLBrowse커넥트 ODBC 데이터 원본 정의에 저장된 DATABASE 및 LANGUAGE 키워드(keyword) 값을 무시합니다. SQLBrowse커넥트 전달된 연결 문자열 지정된 데이터베이스 또는 언어가 유효하지 않으면 SQLBrowse커넥트 SQL_NEED_DATA 및 수준 3 연결 특성을 반환합니다.

SQLSet커넥트Attr을 호출하여 설정되는 다음 특성은 SQLBrowse커넥트 반환된 결과 집합을 결정합니다.

attribute	설명
SQL_COPT_SS_BROWSE_CONNECT	SQL_MORE_INFO_YES 설정하면 SQLBrowse커넥트 서버 속성의 확장 문자열을 반환합니다. 다음은 SQLBrowse에서 반환된 확장 문자열의 예입니다커넥트. `ServerName\InstanceName;Clustered:No;Version:8.00.131` 이 문자열에서 세미콜론은 서버에 대한 다양한 정보 부분을 구분합니다. 서로 다른 서버 인스턴스를 구분하려면 쉼표를 사용합니다.
SQL_COPT_SS_BROWSE_SERVER	서버 이름을 지정하면 SQLBrowse커넥트 지정된 서버에 대한 정보를 반환합니다. SQL_COPT_SS_BROWSE_SERVER NULL로 설정된 경우 SQLBrowse커넥트 do기본의 모든 서버에 대한 정보를 반환합니다. 네트워크 문제로 인해 SQLBrowse커넥트는 모든 서버에서 적시에 응답을 받지 못할 수 있습니다. 따라서 반환되는 서버 목록은 각 요청에 따라 달라질 수 있습니다.
SQL_COPT_SS_BROWSE_CACHE_DATA	SQL_COPT_SS_BROWSE_CACHE_DATA 특성이 SQL_CACHE_DATA_YES로 설정되었을 때 버퍼 길이가 결과를 저장하기에 부족한 경우 데이터를 청크로 인출할 수 있습니다. 이 길이는 SQLBrowse커넥트 BufferLength 인수에 지정됩니다. 더 많은 데이터를 사용할 수 있을 때 SQL_NEED_DATA가 반환됩니다. 검색할 데이터가 더 이상 없으면 SQL_SUCCESS 반환됩니다. 기본값은 SQL_CACHE_DATA_NO.

SQLBrowse커넥트 고가용성 재해 복구 지원

SQLBrowse커넥트를 사용하여 Always On 가용성 그룹 클러스터에 연결하는 방법에 대한 자세한 내용은 고가용성 재해 복구에 대한 SQL Server Native Client 지원을 참조 하세요.

SQLBrowse커넥트 SPN(서비스 사용자 이름) 지원

연결이 열리면 SQL Server Native Client는 SQL_COPT_SS_MUTUALLY_AUTHENTICATED 설정하고 연결을 여는 데 사용되는 인증 방법으로 SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD.

SPN에 대한 자세한 내용은 ODBC(클라이언트 커넥트ions)의 SPN(서비스 사용자 이름)을 참조하세요.

변경 내용

업데이트된 내용
SQL_COPT_SS_BROWSE_CACHE_DATA에 대한 설명을 포함시켰습니다.

참고 항목

SQLBrowse커넥트 함수
ODBC API 구현 정보