SQLBrowseConnect
SQLBrowseConnect 는 세 가지 수준의 연결 정보로 분류할 수 있는 키워드를 사용합니다. 다음 표에서는 각 키워드에 대해 유효한 값 목록의 반환 여부와 키워드가 선택 사항인지 여부를 보여 줍니다.
수준 1
| 키워드 | 목록 반환 여부 | 선택 사항 여부 | Description |
|---|---|---|---|
| DSN | 해당 없음 | 아니요 | SQLDataSources에서 반환된 데이터 원본의 이름입니다. DRIVER 키워드가 사용되는 경우에는 DSN 키워드를 사용할 수 없습니다. |
| DRIVER | 해당 없음 | 아니요 | Microsoft?? SQL Server Native Client ODBC 드라이버 이름은 {SQL Server Native Client 11}입니다. DSN 키워드가 사용되는 경우에는 DRIVER 키워드를 사용할 수 없습니다. |
수준 2
| 키워드 | 목록 반환 여부 | 선택 사항 여부 | Description |
|---|---|---|---|
| SERVER | Yes | 아니요 | 데이터 원본이 있는 네트워크의 서버 이름입니다. "(local)"라는 용어는 서버로 입력할 수 있습니다. 이 경우 네트워크로 연결되지 않은 버전인 경우에도 SQL Server 로컬 복사본을 사용할 수 있습니다. |
| UID | 아니요 | 예 | 사용자 로그인 ID입니다. |
| PWD | 아니요 | 예(사용자에 따라 달라짐) | 사용자가 지정한 암호입니다. |
| APP | 아니요 | 예 | SQLBrowseConnect를 호출하는 애플리케이션의 이름입니다. |
| WSID | 아니요 | 예 | 워크스테이션 ID입니다. 일반적으로 애플리케이션이 실행되는 컴퓨터의 네트워크 이름입니다. |
Level 3
| 키워드 | 목록 반환 여부 | 선택 사항 여부 | 설명 |
|---|---|---|---|
| DATABASE | Yes | 예 | SQL Server 데이터베이스의 이름입니다. |
| LANGUAGE | Yes | 예 | SQL Server 사용하는 국가별 언어입니다. |
SQLBrowseConnect 는 ODBC 데이터 원본 정의에 저장된 DATABASE 및 LANGUAGE 키워드의 값을 무시합니다. SQLBrowseConnect에 전달된 연결 문자열에 지정된 데이터베이스 또는 언어가 잘못된 경우 SQLBrowseConnect는 SQL_NEED_DATA 및 수준 3 연결 특성을 반환합니다.
SQLSetConnectAttr를 호출하여 설정된 다음 특성은 SQLBrowseConnect에서 반환된 결과 집합을 결정합니다.
| attribute | Description |
|---|---|
| SQL_COPT_SS_BROWSE_CONNECT | SQL_MORE_INFO_YES 설정된 경우 SQLBrowseConnect 는 확장된 서버 속성 문자열을 반환합니다. 다음은 SQLBrowseConnect:ServerName\InstanceName에서 반환된 확장 문자열의 예입니다. Clustered:No; 버전: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로 설정되었을 때 버퍼 길이가 결과를 저장하기에 부족한 경우 데이터를 청크로 인출할 수 있습니다. 이 길이는 BUFFERLength 인수에서 SQLBrowseConnect에 지정됩니다. 더 많은 데이터를 사용할 수 있을 때 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에 대한 설명을 포함시켰습니다. |