SQL Server Native Client OLE DB 공급자는 다음과 같이 OLE DB 초기화 및 권한 부여 속성을 해석합니다.
| 속성 ID | 설명 |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | SQL Server Native Client OLE DB 공급자는 인증 정보를 캐시하지 않습니다. SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | SQL Server Native Client OLE DB 공급자는 표준 MicrosoftSQL 서버 보안 메커니즘을 사용하여 암호를 숨깁니다. SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_AUTH_INTEGRATED | DBPROP_AUTH_INTEGRATED NULL 포인터, null 문자열 또는 'SSPI' VT_BSTR 값으로 설정된 경우 SQL Server Native Client OLE DB 공급자는 Windows 인증 모드를 사용하여 DBPROP_INIT_DATASOURCE 및 DBPROP_INIT_CATALOG 속성으로 지정된 SQL Server 데이터베이스에 대한 사용자 액세스 권한을 부여합니다. VT_EMPTY(기본값)로 설정된 경우 SQL Server 보안이 사용됩니다. SQL Server 로그인 및 암호는 DBPROP_AUTH_USERID 및 DBPROP_AUTH_PASSWORD 속성에 지정됩니다. |
| DBPROP_AUTH_MASK_PASSWORD | SQL Server Native Client OLE DB 공급자는 표준 SQL Server 보안 메커니즘을 사용하여 암호를 숨깁니다. SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_AUTH_PASSWORD | SQL Server 로그인에 할당된 암호입니다. 이 속성은 SQL Server 데이터베이스에 대한 액세스 권한을 부여하기 위해 SQL Server 인증을 선택할 때 사용됩니다. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | SQL Server Native Client OLE DB 공급자는 유지되는 경우 인증 정보를 암호화하지 않습니다. SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | SQL Server Native Client OLE DB 공급자는 요청된 경우 암호 이미지를 포함하여 인증 값을 유지합니다. 암호화가 제공되지 않습니다. |
| DBPROP_AUTH_USERID | SQL Server 로그인. 이 속성은 SQL Server 데이터베이스에 대한 액세스 권한을 부여하기 위해 SQL Server 인증을 선택할 때 사용됩니다. |
| DBPROP_INIT_ASYNCH | SQL Server Native Client OLE DB 공급자는 비동기 시작을 지원합니다. DBPROP_INIT_ASYNCH 속성에서 DBPROPVAL_ASYNCH_INITIALIZE 비트를 설정하면 IDBInitialize::Initialize 가 비차단 호출이 됩니다. 자세한 내용은 비동기 작업 수행을 참조하세요. |
| DBPROP_INIT_CATALOG | 연결할 기존 SQL Server 데이터베이스의 이름입니다. |
| DBPROP_INIT_DATASOURCE | MicrosoftSQL 서버 인스턴스를 실행하는 서버의 네트워크 이름입니다. 컴퓨터에서 실행되는 SQL Server 인스턴스가 여러 개 있는 경우 SQL Server의 특정 인스턴스에 연결하기 위해 DBPROP_INIT_DATASOURCE 값이 \\ServerName\InstanceName으로 지정됩니다. 이스케이프 시퀀스 \\는 백슬래시 자체에 사용됩니다. |
| DBPROP_INIT_GENERALTIMEOUT | 데이터 원본 초기화 및 명령 실행 이외의 요청 전 시간(초)을 나타냅니다. 값이 0이면 시간 제한이 없음을 나타냅니다. 네트워크 연결 또는 분산 또는 거래 시나리오에서 작업하는 공급자는 이 속성을 지원하여 장기 실행 요청이 발생할 경우 참여 구성 요소에 시간 초과를 권고할 수 있습니다. 데이터 원본 초기화 및 명령 실행에 대한 제한 시간은 각각 DBPROP_INIT_TIMEOUT 및 DBPROP_COMMANDTIMEOUT 의해 제어됩니다. DBPROP_INIT_GENERALTIMEOUT 읽기 전용이며 설정하려고 하면 DBPROPSTATUS_NOTSETTABLE dwstatus 오류가 반환됩니다. |
| DBPROP_INIT_HWND | 호출 애플리케이션의 Windows 핸들입니다. 초기화 속성을 묻는 메시지가 표시될 때 표시되는 초기화 대화 상자에 유효한 창 핸들이 필요합니다. |
| DBPROP_INIT_IMPERSONATION_LEVEL | SQL Server Native Client OLE DB 공급자는 가장 수준 조정을 지원하지 않습니다. SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_INIT_LCID | SQL Server Native Client OLE DB 공급자는 로캘 ID의 유효성을 검사하고 로캘 ID가 지원되지 않거나 클라이언트에 설치되지 않은 경우 오류를 반환합니다. |
| DBPROP_INIT_LOCATION | SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_INIT_MODE (데이터베이스 초기화 모드) | SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_INIT_PROMPT | SQL Server Native Client OLE DB 공급자는 데이터 원본 초기화를 위한 모든 프롬프트 모드를 지원합니다. SQL Server Native Client OLE DB 공급자는 DBPROMPT_NOPROMPT 속성의 기본 설정으로 사용합니다. |
| DBPROP_INIT_PROTECTION_LEVEL | SQL Server Native Client OLE DB 공급자는 SQL Server 인스턴스에 대한 연결에 대한 보호 수준을 지원하지 않습니다. SQL Server Native Client OLE DB 공급자는 속성 값을 설정하려고 시도하면 DB_S_ERRORSOCCURRED 반환합니다. DBPROP 구조체의 dwStatus 멤버는 DBPROPSTATUS_NOTSUPPORTED 나타냅니다. |
| DBPROP_INIT_PROVIDERSTRING | 이 항목의 뒷부분에 있는 SQL Server Native Client OLE DB 공급자 문자열을 참조하세요. |
| DBPROP_INIT_TIMEOUT | SQL Server Native Client OLE DB 공급자는 지정된 시간(초) 내에 SQL Server 인스턴스에 대한 연결을 설정할 수 없는 경우 초기화 시 오류를 반환합니다. |
공급자별 속성 집합 DBPROPSET_SQLSERVERDBINIT SQL Server Native Client OLE DB 공급자는 이러한 추가 초기화 속성을 정의합니다.
| 속성 ID | 설명 |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | 형식: VT_BSTR R/W: 쓰기 기본값: VT_EMPTY 설명: 현재 또는 만료된 암호입니다. 자세한 내용은 프로그래밍 방식으로 암호 변경을 참조하세요. |
| SSPROP_INIT_APPNAME | 형식: VT_BSTR R/W: 읽기/쓰기 설명: 클라이언트 애플리케이션 이름입니다. |
| SSPROP_INIT_AUTOTRANSLATE | 형식: VT_BOOL R/W: 읽기/쓰기 기본값: VARIANT_TRUE 설명: OEM/ANSI 문자 변환. VARIANT_TRUE: SQL Server Native Client OLE DB 공급자는 클라이언트와 서버의 코드 페이지 간에 확장 문자를 일치시키는 문제를 최소화하기 위해 유니코드를 통해 변환하여 클라이언트와 서버 간에 전송된 ANSI 문자 문자열을 변환합니다. SQL Server문자, varchar 또는 텍스트 변수, 매개 변수 또는 열 인스턴스로 전송되는 클라이언트 DBTYPE_STR 데이터는 클라이언트 ANSI 코드 페이지(ACP)를 사용하여 문자에서 유니코드로 변환된 다음 서버의 ACP를 사용하여 유니코드에서 문자로 변환됩니다. 클라이언트 DBTYPE_STR 변수로 전송된 SQL Server 문자, varchar 또는 텍스트 데이터는 서버 ACP를 사용하여 문자에서 유니코드로 변환된 다음 클라이언트 ACP를 사용하여 유니코드에서 문자로 변환됩니다. 이러한 변환은 SQL Server Native Client OLE DB 공급자가 클라이언트에서 수행합니다. 이렇게 하려면 서버에서 사용되는 동일한 ACP를 클라이언트에서 사용할 수 있어야 합니다. 이러한 설정은 이러한 전송에 대해 발생하는 변환에 영향을 주지 않습니다. 유니코드 DBTYPE_WSTR 서버의 char, varchar 또는 텍스트 로 전송된 클라이언트 데이터입니다. 클라이언트의 유니코드 DBTYPE_WSTR 변수로 전송된 char, varchar 또는 텍스트 서버 데이터입니다. ANSI는 서버의 유니코드 nchar, nvarchar 또는 ntext로 전송된 클라이언트 데이터를 DBTYPE_STR. 클라이언트의 ANSI DBTYPE_STR 변수로 전송된 유니코드 문자, varchar 또는 텍스트 서버 데이터입니다. VARIANT_FALSE: SQL Server Native Client OLE DB 공급자는 문자 번역을 수행하지 않습니다. SQL Server Native Client OLE DB 공급자는 클라이언트 ANSI 문자 DBTYPE_STR 데이터를 서버의 char, varchar 또는 텍스트 변수, 매개 변수 또는 열로 변환하지 않습니다. 서버에서 보낸 문자, varchar 또는 텍스트 데이터에서 클라이언트의 변수를 DBTYPE_STR 변환이 수행되지 않습니다. 클라이언트와 SQL Server 인스턴스가 다른 ACL을 사용하는 경우 확장 문자를 잘못 해석할 수 있습니다. |
| SSPROP_INIT_CURRENTLANGUAGE | 형식: VT_BSTR R/W: 읽기/쓰기 설명: SQL Server 언어 이름입니다. 시스템 메시지 선택 및 서식 지정에 사용되는 언어를 식별합니다. SQL Server 인스턴스를 실행하는 컴퓨터에 언어를 설치해야 합니다. 그렇지 않으면 데이터 원본 초기화가 실패합니다. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | 형식: VT_UI2 R/W: 읽기/쓰기 기본값: 0 설명: SQL Server와 ADO(ActiveX Data Object) 애플리케이션 간의 데이터 형식 호환성을 사용하도록 설정합니다. 기본값 0을 사용하는 경우 데이터 형식 처리는 기본적으로 공급자가 사용하는 값으로 설정됩니다. 값 80을 사용하는 경우 데이터 형식 처리는 SQL Server 2000 데이터 형식만 사용합니다. 자세한 내용은 SQL Server Native Client에서 ADO 사용을 참조하세요. |
| SSPROP_INIT_ENCRYPT | 형식: VT_BOOL R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: 네트워크를 통해 데이터를 암호화하려면 SSPROP_INIT_ENCRYPT 속성이 VARIANT_TRUE 설정됩니다. 프로토콜 암호화 사용이 설정되면 SSPROP_INIT_ENCRYPT 설정에 관계없이 암호화가 항상 발생합니다. 꺼져 있고 SSPROP_INIT_ENCRYPT VARIANT_TRUE 설정되면 암호화가 발생합니다. 프로토콜 암호화 사용이 꺼져 있고 SSPROP_INIT_ENCRYPT VARIANT_FALSE 설정되면 암호화가 발생하지 않습니다. |
| SSPROP_INIT_FAILOVERPARTNER | 형식: VT_BSTR R/W: 읽기/쓰기 설명: 데이터베이스 미러링에 대한 장애 조치(failover) 파트너의 이름을 지정합니다. 초기화 속성이며 초기화 전에만 설정할 수 있습니다. 초기화 후 주 서버에서 반환된 장애 조치(failover) 파트너(있는 경우)를 반환합니다. 이렇게 하면 스마트 애플리케이션이 가장 최근에 결정된 백업 서버를 캐시할 수 있지만, 이러한 애플리케이션은 연결이 처음 설정되거나 풀이 풀된 경우 다시 설정될 때만 정보가 업데이트되고 장기 연결에 대한 최신 상태가 될 수 있다는 점에 유의해야 합니다. 연결을 만든 후 애플리케이션은 이 특성을 쿼리하여 장애 조치(failover) 파트너의 ID를 확인할 수 있습니다. 주 서버에 장애 조치(failover) 파트너가 없는 경우 이 속성은 빈 문자열을 반환합니다. 자세한 내용은 데이터베이스 미러링 사용을 참조하세요. |
| SSPROP_INIT_FILENAME | 형식: VT_BSTR R/W: 읽기/쓰기 설명: 연결 가능한 데이터베이스의 기본 파일 이름을 지정합니다. 이 데이터베이스는 연결되고 연결의 기본 데이터베이스가 됩니다. SSPROP_INIT_FILENAME 사용하려면 데이터베이스 이름을 초기화 속성 DBPROP_INIT_CATALOG 값으로 지정해야 합니다. 데이터베이스 이름이 없으면 SSPROP_INIT_FILENAME 지정된 기본 파일 이름을 찾고 해당 데이터베이스를 DBPROP_INIT_CATALOG 지정된 이름으로 연결합니다. 데이터베이스가 이전에 연결된 경우 SQL Server는 데이터베이스를 다시 연결하지 않습니다. |
| SSPROP_INIT_MARSCONNECTION | 형식: VT_BOOL R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: 연결에 MARS(다중 활성 결과 집합)를 사용할 수 있는지를 지정합니다. 데이터베이스에 연결하기 전에 이 옵션을 true로 설정해야 합니다. 자세한 내용은 MARS(Multiple Active Result Sets) 사용을 참조하세요. |
| SSPROP_INIT_NETWORKADDRESS | 형식: VT_BSTR R/W: 읽기/쓰기 설명: DBPROP_INIT_DATASOURCE 속성으로 지정된 SQL Server 인스턴스를 실행하는 서버의 네트워크 주소입니다. |
| SSPROP_INIT_NETWORKLIBRARY | 형식: VT_BSTR R/W: 읽기/쓰기 설명: SQL Server 인스턴스와 통신하는 데 사용되는 DLL(networklibrary)의 이름입니다. 이름에 경로 또는 .dll 파일 이름 확장명을 포함해서는 안 됩니다. SQL Server 클라이언트 구성 유틸리티를 사용하여 기본값을 사용자 지정할 수 있습니다. 메모: 이 속성에서는 TCP 및 명명된 파이프만 지원됩니다. 접두사로 이 속성을 사용하는 경우 속성이 내부적으로 접두사를 생성하는 데 사용되므로 오류가 발생하는 이중 접두사로 끝납니다. |
| SSPROP_INIT_PACKETSIZE | 형식: VT_I4 R/W: 읽기/쓰기 설명: 네트워크 패킷 크기(바이트)입니다. 패킷 크기 속성 값은 512에서 32,767 사이여야 합니다. 기본 SQL Server Native Client OLE DB 공급자 네트워크 패킷 크기는 4,096입니다. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | 형식: BOOL R/W: 쓰기 기본값: FALSE 설명: 서버 쪽 커서를 사용할 때 데이터베이스 업데이트 중에 사용됩니다. 이 속성은 클라이언트의 코드 페이지 대신 서버에서 가져온 데이터 정렬 정보를 사용하여 데이터에 태그를 지정합니다. 현재 이 속성은 대상 데이터의 데이터 정렬을 알고 올바르게 변환하기 때문에 분산 쿼리 프로세스에서만 사용됩니다. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | 형식: VT_BOOL R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: 서버 인증서 유효성 검사를 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 이 속성은 읽기/쓰기이지만 연결이 설정된 후 설정하려고 하면 오류가 발생합니다. 클라이언트가 인증서 유효성 검사를 요구하도록 구성된 경우 이 속성은 무시됩니다. 그러나 애플리케이션은 SSPROP_INIT_ENCRYPT 함께 사용하여 클라이언트가 암호화를 요구하지 않도록 구성되고 클라이언트에 인증서가 프로비전되지 않은 경우에도 서버에 대한 연결이 암호화되도록 보장할 수 있습니다. 클라이언트 애플리케이션은 연결이 열린 후 이 속성을 쿼리하여 사용 중인 실제 암호화 및 유효성 검사 설정을 확인할 수 있습니다. 메모: 인증서 유효성 검사 없이 암호화를 사용하면 패킷 스니핑에 대한 부분적인 보호가 제공되지만 중간자 공격으로부터 보호되지는 않습니다. 서버 인증서의 유효성을 검사하지 않고 서버로 전송된 로그인 및 데이터를 암호화할 수 있습니다. 자세한 내용은 유효성 검사 없이 암호화 사용을 참조하세요. |
| SSPROP_INIT_USEPROCFORPREP | 형식: VT_I4 R/W: 읽기/쓰기 기본값: SSPROPVAL_USEPROCFORPREP_ON 설명: SQL Server 저장 프로시저 사용. SQL Server 임시 저장 프로시저를 사용하여 ICommandPrepare 인터페이스를 지원하는 방법을 정의합니다. 이 속성은 SQL Server 6.5에 연결할 때만 의미가 있었습니다. 이 속성은 이후 버전에서 무시됩니다. SSPROPVAL_USEPROCFORPREP_OFF: 명령이 준비되면 임시 저장 프로시저가 만들어지지 않습니다. SSPROPVAL_USEPROCFORPREP_ON: 명령이 준비되면 임시 저장 프로시저가 만들어집니다. 임시 저장 프로시저는 세션이 해제될 때 삭제됩니다. SSPROPVAL_USEPROCFORPREP_ON_DROP: 명령이 준비되면 임시 저장 프로시저가 만들어집니다. 명령이 ICommandPrepare::Unprepare로 준비되지 않은 경우, ICommandText::SetCommandText를 사용하여 명령 개체에 대해 새 명령을 지정하거나 명령에 대한 모든 애플리케이션 참조가 해제될 때 프로시저가 삭제됩니다. |
| SSPROP_INIT_WSID | 형식: VT_BSTR R/W: 읽기/쓰기 설명: 워크스테이션을 식별하는 문자열입니다. |
공급자별 속성 집합 DBPROPSET_SQLSERVERDATASOURCEINFO SQL Server Native Client OLE DB 공급자는 추가 속성을 정의합니다. 자세한 내용은 데이터 원본 정보 속성을 참조하세요.
SQL Server Native Client OLE DB 공급자 문자열
SQL Server Native Client OLE DB 공급자는 공급자 문자열 속성 값에서 ODBC와 유사한 구문을 인식합니다. 공급자 문자열 속성은 OLE DB 데이터 원본에 대한 연결이 설정될 때 DBPROP_INIT_PROVIDERSTRING OLE DB 초기화 속성의 값으로 제공됩니다. 이 속성은 OLE DB 데이터 원본에 대한 연결을 구현하는 데 필요한 OLE DB 공급자별 연결 데이터를 지정합니다. 문자열 내에서 요소는 세미콜론을 사용하여 구분됩니다. 문자열의 마지막 요소는 세미콜론으로 종료해야 합니다. 각 요소는 키워드, 등호 문자 및 초기화 시 전달된 값으로 구성됩니다. 다음은 그 예입니다.
Server=MyServer;UID=MyUserName;
SQL Server Native Client OLE DB 공급자를 사용하면 소비자는 공급자 문자열 속성을 사용할 필요가 없습니다. 소비자는 OLE DB 또는 SQL Server Native Client OLE DB 공급자별 초기화 속성을 사용하여 공급자 문자열에 반영된 모든 초기화 속성을 설정할 수 있습니다.
SQL Server Native Client OLE DB 공급자에서 사용할 수 있는 키 워드 목록은 SQL Server Native Client에서 연결 문자열 키워드 사용을 참조하세요.