적용 대상:
SQL 서버Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics분석 플랫폼 시스템(PDW)Microsoft Fabric의 SQL 데이터베이스
OLE DB Driver for SQL Server의 일부 API는 연결 문자열을 사용하여 연결 특성을 지정합니다. 연결 문자열은 키워드 및 관련 값의 목록으로, 각 키워드는 특정 연결 특성을 식별합니다.
참고
OLE DB Driver for SQL Server를 사용하면 연결 문자열의 모호성이 이전 버전과의 호환성을 유지할 수 있습니다(예를 들어 일부 키워드를 두 번 이상 지정할 수 있으며 위치 또는 우선 순위에 따라 충돌하는 키워드를 확인하여 허용될 수 있습니다). 이후 릴리스의 OLE DB Driver for SQL Server에서는 연결 문자열의 모호성을 허용하지 않을 수 있습니다. OLE DB Driver for SQL Server를 사용하도록 애플리케이션을 수정하는 경우 연결 문자열 모호성에 대한 종속성을 제거하는 것이 좋습니다.
다음 섹션에서는 OLE DB Driver for SQL Server를 데이터 공급자로 사용할 때 OLE DB Driver for SQL Server 및 ADO(ActiveX Data Objects)에서 사용할 수 있는 키워드에 대해 설명합니다.
OLE DB 드라이버 연결 문자열 키워드
OLE DB 애플리케이션에서는 데이터 원본 개체를 다음 두 가지 방법으로 초기화할 수 있습니다.
IDBInitialize::InitializeIDataInitialize::GetDataSource
첫 번째 경우 공급자 문자열을 사용하여 속성 집합의 DBPROP_INIT_PROVIDERSTRING 속성을 설정하여 연결 속성을 DBPROPSET_DBINIT 초기화할 수 있습니다. 두 번째 경우, 연결 속성을 초기화하기 위해 초기화 문자열을 IDataInitialize::GetDataSource 메서드에 전달할 수 있습니다. 두 방법 모두 동일한 OLE DB 연결 속성을 초기화하지만 서로 다른 키워드 집합을 사용합니다. 사용되는 IDataInitialize::GetDataSource 키워드 집합은 최소한 초기화 속성 그룹 내의 속성에 대한 설명입니다.
일부 기본값으로 관련 OLE DB 속성 집합을 소유하거나 명시적인 값으로 설정된 임의 공급자 문자열 설정, OLE DB 속성 값은 공급자 문자열에서 설정을 재정의합니다.
DBPROP_INIT_PROVIDERSTRING 값을 통해 설정된 부울 속성은 공급자 문자열의 값 yes 및 no로 설정됩니다. 사용자 지정 문자열에서 IDataInitialize::GetDataSource을 사용하여 초기화되는 부울 속성은 true과 false 값을 사용하여 설정됩니다.
IDataInitialize::GetDataSource을 사용하는 애플리케이션은 또한 IDBInitialize::Initialize에서 사용되는 키워드를 기본값이 없는 속성에 대해 사용할 수 있습니다. 애플리케이션이 초기화 문자열에서 IDataInitialize::GetDataSource 키워드와 IDBInitialize::Initialize 키워드를 모두 사용하는 경우 키워드 설정이 IDataInitialize::GetDataSource 사용됩니다. 애플리케이션이 IDataInitialize:GetDataSource 연결 문자열에서 IDBInitialize::Initialize 키워드를 사용하지 않는 것이 좋습니다. 이러한 동작은 이후 릴리스에서 유지되지 않을 수 있습니다.
참고
전달된 IDataInitialize::GetDataSource 연결 문자열은 속성으로 변환되고 을 통해 IDBProperties::SetProperties적용됩니다. 구성 요소 서비스에서 속성 설명을 IDBProperties::GetPropertyInfo찾은 경우 이 속성은 독립 실행형 속성으로 적용됩니다. 그렇지 않으면 DBPROP_PROVIDERSTRING 속성을 통해 적용됩니다. 예를 들어 연결 문자열 Data Source=server1;Server=server2Data Source 을 지정하는 경우 속성으로 설정되지만 Server 공급자 문자열로 이동합니다.
같은 공급자별 속성의 인스턴스를 여러 개 지정하면 첫 번째 속성의 첫 번째 값이 사용됩니다.
IDBInitialize::Initialize 사용
OLE DB 애플리케이션에서 사용하는 DBPROP_INIT_PROVIDERSTRINGIDBInitialize::Initialize 연결 문자열에는 다음과 같은 구문이 사용됩니다.
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
특성 값을 중괄호로 묶을 수도 있으며, 그렇게 하는 것이 좋습니다. 이 방법으로 특성 값에 영숫자가 아닌 문자가 있을 경우 발생할 수 있는 문제를 막을 수 있습니다. 값에서 첫 번째 닫는 중괄호는 값을 종료하는 문자로 간주되므로 값에 닫는 중괄호가 있어서는 안 됩니다.
연결 문자열 키워드에서 등호(=) 다음에 나오는 공백 문자는 값을 따옴표로 묶은 경우에도 리터럴로 해석됩니다.
다음 표에서는 .와 함께 DBPROP_INIT_PROVIDERSTRING사용할 수 있는 키워드에 대해 설명합니다.
| 키워드 | 초기화 속성 | Description |
|---|---|---|
Addr |
SSPROP_INIT_NETWORKADDRESS |
의 동의어입니다 Address. |
Address |
SSPROP_INIT_NETWORKADDRESS |
SQL Server 인스턴스를 실행하는 서버의 네트워크 주소입니다.
Address 는 일반적으로 서버의 네트워크 이름이지만 파이프, IP 주소 또는 TCP/IP 포트 및 소켓 주소와 같은 다른 이름일 수 있습니다.IP 주소를 지정하는 경우 SQL Server 구성 관리자에서 TCP/IP 또는 명명된 파이프 프로토콜이 설정되어 있는지 확인합니다. SQL Server용 OLE DB 드라이버를 사용할 때 Address의 값이 연결 문자열에 전달된 Server의 값보다 우선합니다.
Address=;는 Server 키워드에 지정된 서버에 연결되지만, Address= ;, Address=.;, Address=localhost;, Address=(local);는 모두 로컬 서버에 연결을 유발합니다.키워드의 전체 구문 Address 은 다음과 같습니다.[프로토콜:]Address[,port|\pipe\pipename] protocol은 tcp(TCP/IP), lpc(공유 메모리) 또는 np(명명된 파이프)일 수 있습니다. 프로토콜에 대한 자세한 내용은 클라이언트 프로토콜 구성을 참조하세요.프로토콜이나 키워드를 Network 지정하지 않으면 OLE DB Driver for SQL Server는 SQL Server Configuration Manager에 지정된 프로토콜 순서를 사용합니다.port는 지정한 서버에서 연결할 포트입니다. 기본적으로 SQL Server는 포트 1433를 사용합니다. |
APP |
SSPROP_INIT_APPNAME |
애플리케이션을 식별하는 문자열입니다. |
ApplicationIntent |
SSPROP_INIT_APPLICATIONINTENT |
서버에 연결할 때 애플리케이션 작업 유형을 선언합니다. 가능한 값은 ReadOnly 및 ReadWrite입니다.기본값은 ReadWrite입니다. OLE DB Driver for SQL Server의 Always On 가용성 그룹 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 고가용성, 재해 복구 지원을 참조하세요. |
AttachDBFileName |
SSPROP_INIT_FILENAME |
연결할 수 있는 데이터베이스의 전체 경로 이름을 포함한 주 파일의 이름입니다. 사용 AttachDBFileName하려면 공급자 문자열 Database 키워드를 사용하여 데이터베이스 이름도 지정해야 합니다. 데이터베이스가 이전에 연결된 경우 SQL Server에서는 이 데이터베이스를 다시 연결하지 않으며 연결된 데이터베이스를 연결 기본값으로 사용합니다. |
Authentication
1 |
SSPROP_AUTH_MODE |
사용되는 SQL 또는 Microsoft Entra 인증을 지정합니다. 유효한 값은 다음과 같습니다.
참고: 이 키워드는 ActiveDirectoryIntegrated SQL Server에 대한 Windows 인증에도 사용할 수 있습니다.
Integrated Security(또는 Trusted_Connection) 인증 키워드를 대체합니다. 키워드 또는 해당 속성을 사용하는 Integrated SecurityTrusted_Connection애플리케이션은 새로운 암호화 및 인증서 검증 동작을 가능하게 하기 위해 Authentication 키워드(또는 해당 속성)의 ActiveDirectoryIntegrated 값을 설정해야 합니다.참고: SQL Server 인증을 사용하는 애플리케이션은 Authentication을 가능하게 하기 위해 SqlPassword 키워드(또는 해당 속성)의 값을 설정해야 합니다. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
의 동의어입니다 AutoTranslate. |
AutoTranslate |
SSPROP_INIT_AUTOTRANSLATE |
OEM/ANSI 문자 변환을 구성합니다. 인식되는 값은 yes 및 no입니다. |
ConnectRetryCount |
SSPROP_INIT_CONNECT_RETRY_COUNT |
연결이 끊어진 경우 다시 연결 시도 횟수를 제어합니다. 유효한 값은 0에서 255 사이입니다. 기본값은 1입니다. 값이 0인 경우, 다시 연결하려는 시도가 이루어지지 않습니다. 자세한 내용은 OLE DB 드라이버의 유휴 연결 복원력을 참조하세요. |
ConnectRetryInterval |
SSPROP_INIT_CONNECT_RETRY_INTERVAL |
연결이 끊어진 경우 연결하려고 다시 시도하는 간격(초)을 지정합니다. 유효한 값은 1에서 60 사이입니다. 기본값은 10입니다. 자세한 내용은 OLE DB 드라이버의 유휴 연결 복원력을 참조하세요. |
Database |
DBPROP_INIT_CATALOG |
데이터베이스 이름입니다. |
DataTypeCompatibility |
SSPROP_INIT_DATATYPECOMPATIBILITY |
사용할 데이터 형식 처리 모드를 지정합니다. 인식되는 값은 0(공급자 데이터 형식) 및 80(SQL Server 2000(8.x) 데이터 형식)입니다. |
Encrypt
1 |
SSPROP_INIT_ENCRYPT |
데이터를 네트워크를 통해 보내기 전에 암호화해야 하는지 여부를 지정합니다. 가능한 값은 Optional, Mandatory 및 Strict입니다. 기본값은 Mandatory입니다. 버전 18.x.x의 경우 MSOLEDBSQL 주 버전 차이를 참조하세요. |
FailoverPartner |
SSPROP_INIT_FAILOVERPARTNER |
데이터베이스 미러링에 사용되는 장애 조치(failover) 서버의 이름입니다. |
FailoverPartnerSPN |
SSPROP_INIT_FAILOVERPARTNERSPN |
장애 조치(failover) 파트너의 SPN입니다. 기본값은 빈 문자열입니다. 빈 문자열을 지정하면 OLE DB Driver for SQL Server는 공급자가 생성한 기본 SPN을 사용합니다. |
HostNameInCertificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
SQL Server TLS/SSL 인증서의 유효성을 검사할 때 사용할 호스트 이름입니다. 키워드가 HostNameInCertificate 설정되지 않은 경우 드라이버는 연결 URL의 Server 키워드 값을 호스트 이름으로 사용하여 SQL Server TLS/SSL 인증서의 유효성을 검사합니다.참고: 서버 인증서를 신뢰할 수 있는 경우 이 속성은 무시됩니다. Encrypt이 Strict로 설정되면, 인증서는 항상 검증됩니다. |
Language |
SSPROP_INIT_CURRENTLANGUAGE |
SQL Server 언어입니다. |
MarsConn |
SSPROP_INIT_MARSCONNECTION |
서버가 SQL Server 2005(9.x) 이상 버전인 경우 연결에서 MARS(Multiple Active Result Sets)를 설정하거나 해제합니다. 가능한 값은 yes 및 no입니다. 기본값은 no입니다. |
MultiSubnetFailover |
SSPROP_INIT_MULTISUBNETFAILOVER |
SQL Server 가용성 그룹 또는 SQL Server 장애 조치(failover) 클러스터 인스턴스의 가용성 그룹 수신기에 연결할 때는 항상 MultiSubnetFailover=Yes을 지정합니다.
MultiSubnetFailover=Yes 는 (현재) 활성 서버에 대한 빠른 검색 및 연결을 제공하도록 SQL Server용 OLE DB 드라이버를 구성합니다. 가능한 값은 Yes 및 No입니다. 기본값은 No입니다. 다음은 그 예입니다.MultiSubnetFailover=YesOLE DB Driver for SQL Server의 Always On 가용성 그룹 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 고가용성, 재해 복구 지원을 참조하세요. |
Net |
SSPROP_INIT_NETWORKLIBRARY |
의 동의어입니다 Network. |
Network |
SSPROP_INIT_NETWORKLIBRARY |
조직의 SQL Server 인스턴스에 연결하는 데 사용하는 네트워크 라이브러리입니다. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
의 동의어입니다 Network. |
PacketSize |
SSPROP_INIT_PACKETSIZE |
TDS(Tabular Data Stream) 패킷 크기입니다. 기본값은 0 서버에서 실제 값을 결정합니다. |
PersistSensitive |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
yes 및 no 문자열을 값으로 허용합니다.
no를 사용할 경우 중요한 인증 정보를 데이터 원본 개체에 유지할 수 없습니다. |
PWD |
DBPROP_AUTH_PASSWORD |
SQL Server 로그인 암호입니다. |
Server |
DBPROP_INIT_DATASOURCE |
SQL Server 인스턴스의 이름입니다. 이 값은 네트워크의 서버 이름(IP 주소)이거나 SQL Server 구성 관리자 별칭이어야 합니다. 지정하지 않으면 로컬 컴퓨터의 기본 인스턴스에 연결합니다. Address 키워드가 Server 키워드를 무시합니다.다음 옵션 중 하나를 지정하여 로컬 서버에서 기본 인스턴스에 연결할 수 있습니다. Server=;Server=.;Server=(local);Server=(local);Server=(localhost);Server=(localdb)\<instancename>;LocalDB 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 LocalDB 지원을 참조하세요. SQL Server의 명명된 인스턴스를 지정하려면 다음을 추가합니다 \<InstanceName>.서버를 지정하지 않으면 로컬 컴퓨터의 기본 인스턴스에 연결합니다. IP 주소를 지정하는 경우 SQL Server 구성 관리자에서 TCP/IP 또는 명명된 파이프 프로토콜이 설정되어 있는지 확인합니다. 키워드의 전체 구문 Server 은 다음과 같습니다.[프로토콜:]서버[,포트] protocol은 tcp(TCP/IP), lpc(공유 메모리) 또는 np(명명된 파이프)일 수 있습니다.다음 예시는 명명된 파이프를 지정합니다. np:\\.\pipe\MSSQL$MYINST01\sql\query위 줄은 명명된 파이프 프로토콜( np), 로컬 머신의 명명된 파이프(\\.\pipe), SQL Server 인스턴스 이름(MSSQL$MYINST01) 및 명명된 파이프의 기본 이름(sql/query)을 지정합니다.프로토콜이나 키워드를 Network 지정하지 않으면 OLE DB Driver for SQL Server는 SQL Server Configuration Manager에 지정된 프로토콜 순서를 사용합니다.port는 지정한 서버에서 연결할 포트입니다. 기본적으로 SQL Server는 포트 1433를 사용합니다.OLE DB Driver for SQL Server를 사용할 때 연결 문자열에 전달된 Server 값의 시작 부분에서 공백이 무시됩니다. |
ServerCertificate |
SSPROP_INIT_SERVER_CERTIFICATE |
SQL Server TLS/SSL 인증서와 일치시킬 인증서 파일의 경로를 지정합니다. 이 옵션은 Strict 암호화를 사용하도록 설정한 경우에만 사용할 수 있습니다. 허용되는 인증서 형식은 PEM, DER 및 CER입니다. 지정된 경우 제공된 인증서가 정확히 일치하는지 확인하여 SQL Server 인증서가 확인됩니다. |
ServerSPN |
SSPROP_INIT_SERVERSPN |
서버의 SPN입니다. 기본값은 빈 문자열입니다. 빈 문자열을 지정하면 OLE DB Driver for SQL Server는 공급자가 생성한 기본 SPN을 사용합니다. |
Timeout |
DBPROP_INIT_TIMEOUT |
데이터 원본 초기화가 완료될 때까지 기다릴 시간(초)입니다. |
TransparentNetworkIPResolution |
SSPROP_INIT_TNIR |
호스트 이름의 첫 번째 확인된 IP가 응답하지 않고 호스트 이름과 연결된 여러 IP가 있는 경우 연결 시퀀스에 영향을 미칩니다. TNIR은 MultiSubnetFailover와 상호 작용하여 다른 연결 시퀀스를 제공합니다. 가능한 값은 Yes 및 No입니다. 기본값은 Yes입니다. 자세한 내용은 투명 네트워크 IP 확인 사용을 참조하세요. |
Trusted_Connection |
DBPROP_AUTH_INTEGRATED |
yes인 경우 이 옵션은 OLE DB Driver for SQL Server에게 Windows 인증을 사용하여 로그인의 유효성을 검사하도록 지시합니다. 그렇지 않으면 OLE DB Driver for SQL Server에서 SQL Server 사용자 이름과 암호를 사용하여 로그인의 유효성을 검사하므로 UID 및 PWD 키워드를 지정해야 합니다. |
TrustServerCertificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
yes 및 no 문자열을 값으로 허용합니다. 기본값은 no이며, 서버 인증서의 유효성을 검사합니다. |
UID |
DBPROP_AUTH_USERID |
SQL Server 로그인 이름입니다. |
UseFMTONLY |
SSPROP_INIT_USEFMTONLY |
SQL Server 2012(11.x) 이상에 연결할 때 메타데이터를 검색하는 방법을 제어합니다. 가능한 값은 yes 및 no입니다. 기본값은 no입니다.기본적으로 OLE DB Driver for SQL Server는 sp_describe_first_result_set 및 sp_describe_undeclared_parameters 저장 프로시저를 사용하여 메타데이터를 검색합니다. 이러한 저장 프로시저에는 몇 가지 제한 사항이 있습니다(예: 임시 테이블에서 실행할 경우 실패함). UseFMTONLY을yesSET FMTONLY로 설정하면, 드라이버가 대신 메타데이터 검색에 이를 사용하도록 지시합니다. |
UseProcForPrepare |
SSPROP_INIT_USEPROCFORPREP |
이 키워드는 더 이상 사용되지 않으며 OLE DB Driver for SQL Server는 이 설정을 무시합니다. |
WSID |
SSPROP_INIT_WSID |
워크스테이션 식별자입니다. |
1 보안을 개선하기 위해 인증 또는 액세스 토큰 초기화 속성 또는 해당 연결 문자열 키워드를 사용할 때 암호화 및 인증서 유효성 검사 동작이 수정됩니다. 자세한 내용은 암호화 및 인증서 유효성 검사를 참조하세요.
IDataInitialize::GetDataSource 사용
OLE DB 애플리케이션에서 사용하는 IDataInitialize::GetDataSource 연결 문자열에는 다음 구문이 사용됩니다.
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
속성 사용은 해당 범위에 허용되는 구문을 따라야 합니다. 예를 들어 WSID는 중괄호({}) 따옴표 문자를 사용하고 Application Name는 작은따옴표(') 또는 큰따옴표(") 문자를 사용합니다. 문자열 속성만 따옴표로 묶을 수 있습니다. 정수 또는 열거형 속성을 따옴표로 묶으면 Connection String doesn't conform to OLE DB specification 오류가 발생합니다.
특성 값을 작은따옴표나 큰따옴표로 묶을 수 있으며, 그렇게 하는 것이 좋습니다. 이 방법으로 값에 영숫자가 아닌 문자가 있을 경우 발생할 수 있는 문제를 막을 수 있습니다. 큰따옴표로 묶은 경우 따옴표로 묶어 사용한 문자도 값에 표시할 수 있습니다.
연결 문자열 키워드에서 등호(=) 다음에 나오는 공백 문자는 값을 따옴표로 묶은 경우에도 리터럴로 해석됩니다.
연결 문자열에 다음 표에 나열된 속성이 두 개 이상 있으면 마지막 속성의 값이 사용됩니다.
다음 표에서는 다음과 함께 IDataInitialize::GetDataSource사용할 수 있는 키워드에 대해 설명합니다.
| 키워드 | 초기화 속성 | Description |
|---|---|---|
Access Token
1 |
SSPROP_AUTH_ACCESS_TOKEN |
Microsoft Entra ID에 인증하는 데 사용되는 액세스 토큰입니다. 참고: 이 키워드 및 UID, PWD, Trusted_Connection, Authentication 연결 문자열 키워드 또는 해당 속성/키워드를 동시에 지정하는 것은 오류입니다. |
Application Name |
SSPROP_INIT_APPNAME |
애플리케이션을 식별하는 문자열입니다. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
서버에 연결할 때 애플리케이션 작업 유형을 선언합니다. 가능한 값은 ReadOnly 및 ReadWrite입니다.기본값은 ReadWrite입니다. OLE DB Driver for SQL Server의 Always On 가용성 그룹 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 고가용성, 재해 복구 지원을 참조하세요. |
Authentication
1 |
SSPROP_AUTH_MODE |
사용되는 SQL 또는 Microsoft Entra 인증을 지정합니다. 유효한 값은 다음과 같습니다.
참고: 이 키워드는 ActiveDirectoryIntegrated SQL Server에 대한 Windows 인증에도 사용할 수 있습니다.
Integrated Security(또는 Trusted_Connection) 인증 키워드를 대체합니다. 키워드 또는 해당 속성을 사용하는 Integrated SecurityTrusted_Connection애플리케이션은 새로운 암호화 및 인증서 검증 동작을 가능하게 하기 위해 Authentication 키워드(또는 해당 속성)의 ActiveDirectoryIntegrated 값을 설정해야 합니다.참고: SQL Server 인증을 사용하는 애플리케이션은 Authentication을 가능하게 하기 위해 SqlPassword 키워드(또는 해당 속성)의 값을 설정해야 합니다. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
OEM/ANSI 문자 변환을 구성합니다. 인식되는 값은 true 및 false입니다. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
데이터 원본 초기화가 완료될 때까지 기다릴 시간(초)입니다. |
Connect Retry Count |
SSPROP_INIT_CONNECT_RETRY_COUNT |
연결이 끊어진 경우 다시 연결 시도 횟수를 제어합니다. 유효한 값은 0에서 255 사이입니다. 기본값은 1입니다.
0 값은 다시 연결을 시도하지 않게 합니다. 자세한 내용은 OLE DB 드라이버의 유휴 연결 복원력을 참조하세요. |
Connect Retry Interval |
SSPROP_INIT_CONNECT_RETRY_INTERVAL |
연결이 끊어진 경우 연결하려고 다시 시도하는 간격(초)을 지정합니다. 유효한 값은 1에서 60 사이입니다. 기본값은 10입니다. 자세한 내용은 OLE DB 드라이버의 유휴 연결 복원력을 참조하세요. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
SQL Server 언어 이름입니다. |
Data Source |
DBPROP_INIT_DATASOURCE |
조직의 SQL Server 인스턴스 이름입니다. 지정하지 않으면 로컬 컴퓨터의 기본 인스턴스에 연결합니다. 유효한 주소 구문에 대한 자세한 내용은 이 문서에서 키워드에 Server 대한 설명을 참조하세요. |
DataTypeCompatibility |
SSPROP_INIT_DATATYPECOMPATIBILITY |
사용할 데이터 형식 처리 모드를 지정합니다. 인식되는 값은 0(공급자 데이터 형식) 및 80(SQL Server 2000(8.x) 데이터 형식)입니다. |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
데이터베이스 미러링에 사용되는 장애 조치(failover) 서버의 이름입니다. |
Failover Partner SPN |
SSPROP_INIT_FAILOVERPARTNERSPN |
장애 조치(failover) 파트너의 SPN입니다. 기본값은 빈 문자열입니다. 빈 문자열을 지정하면 OLE DB Driver for SQL Server는 공급자가 생성한 기본 SPN을 사용합니다. |
Host Name In Certificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
SQL Server TLS/SSL 인증서의 유효성을 검사할 때 사용할 호스트 이름입니다. 키워드가 Host Name In Certificate 설정되지 않은 경우 드라이버는 연결 URL의 Data Source 키워드 값을 호스트 이름으로 사용하여 SQL Server TLS/SSL 인증서의 유효성을 검사합니다.참고: 서버 인증서를 신뢰할 수 있는 경우 이 속성은 무시됩니다. Use Encryption for Data이 Strict로 설정되면 인증서는 항상 유효성 검사를 받게 됩니다. |
Initial Catalog |
DBPROP_INIT_CATALOG |
데이터베이스 이름입니다. |
Initial File Name |
SSPROP_INIT_FILENAME |
연결할 수 있는 데이터베이스의 전체 경로 이름을 포함한 주 파일의 이름입니다. 사용 AttachDBFileName하려면 공급자 문자열 DATABASE 키워드를 사용하여 데이터베이스 이름도 지정해야 합니다. 데이터베이스가 이전에 연결된 경우 SQL Server에서는 이 데이터베이스를 다시 연결하지 않으며 연결된 데이터베이스를 연결 기본값으로 사용합니다. |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Windows 인증에 대해 SSPI 값을 허용합니다. |
MARS Connection |
SSPROP_INIT_MARSCONNECTION |
연결에서 MARS(Multiple Active Result Sets)를 설정하거나 해제합니다. 인식되는 값은 true 및 false입니다. 기본값은 false입니다. |
MultiSubnetFailover |
SSPROP_INIT_MULTISUBNETFAILOVER |
SQL Server 가용성 그룹 또는 SQL Server 장애 조치(failover) 클러스터 인스턴스의 가용성 그룹 수신기에 연결할 때는 항상 MultiSubnetFailover=True을 지정합니다.
MultiSubnetFailover=True 는 (현재) 활성 서버에 대한 빠른 검색 및 연결을 제공하도록 SQL Server용 OLE DB 드라이버를 구성합니다. 가능한 값은 True 및 False입니다. 기본값은 False입니다. 다음은 그 예입니다.MultiSubnetFailover=TrueOLE DB Driver for SQL Server의 Always On 가용성 그룹 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 고가용성, 재해 복구 지원을 참조하세요. |
Network Address |
SSPROP_INIT_NETWORKADDRESS |
조직의 SQL Server 인스턴스 네트워크 주소입니다. 유효한 주소 구문에 대한 자세한 내용은 이 문서에서 키워드에 Address 대한 설명을 참조하세요. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
조직의 SQL Server 인스턴스에 연결하는 데 사용하는 네트워크 라이브러리입니다. |
Packet Size |
SSPROP_INIT_PACKETSIZE |
TDS(Tabular Data Stream) 패킷 크기입니다. 기본값은 0 서버에서 실제 값을 결정합니다. |
Password |
DBPROP_AUTH_PASSWORD |
SQL Server 로그인 암호입니다. |
Persist Security Info |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
true 및 false 문자열을 값으로 허용합니다.
false인 경우 중요한 인증 정보를 데이터 원본 개체에 유지할 수 없습니다. |
Provider |
OLE DB Driver for SQL Server의 경우 값은 MSOLEDBSQL19 또는 MSOLEDBSQL입니다. |
|
Server Certificate |
SSPROP_INIT_SERVER_CERTIFICATE |
SQL Server TLS/SSL 인증서와 일치시킬 인증서 파일의 경로를 지정합니다. 이 옵션은 Strict 암호화를 사용하도록 설정한 경우에만 사용할 수 있습니다. 허용되는 인증서 형식은 PEM, DER 및 CER입니다. 지정된 경우 제공된 인증서가 정확히 일치하는지 확인하여 SQL Server 인증서가 확인됩니다. |
Server SPN |
SSPROP_INIT_SERVERSPN |
서버의 SPN입니다. 기본값은 빈 문자열입니다. 빈 문자열을 지정하면 OLE DB Driver for SQL Server는 공급자가 생성한 기본 SPN을 사용합니다. |
TransparentNetworkIPResolution |
SSPROP_INIT_TNIR |
호스트 이름의 첫 번째 확인된 IP가 응답하지 않고 호스트 이름과 연결된 여러 IP가 있는 경우 연결 시퀀스에 영향을 미칩니다. TNIR은 MultiSubnetFailover와 상호 작용하여 다른 연결 시퀀스를 제공합니다. 가능한 값은 True 및 False입니다. 기본값은 True입니다. 자세한 내용은 투명 네트워크 IP 확인 사용을 참조하세요. |
Trust Server Certificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
true 및 false 문자열을 값으로 허용합니다. 기본값은 false이며, 서버 인증서의 유효성을 검사합니다. |
Use Encryption for Data
1 |
SSPROP_INIT_ENCRYPT |
데이터를 네트워크를 통해 보내기 전에 암호화해야 하는지 여부를 지정합니다. 가능한 값은 Optional, Mandatory 및 Strict입니다. 기본값은 Mandatory입니다. 버전 18.x.x의 경우 MSOLEDBSQL 주 버전 차이를 참조하세요. |
Use FMTONLY |
SSPROP_INIT_USEFMTONLY |
SQL Server 2012(11.x) 이상에 연결할 때 메타데이터를 검색하는 방법을 제어합니다. 가능한 값은 true 및 false입니다. 기본값은 false입니다.기본적으로 OLE DB Driver for SQL Server는 sp_describe_first_result_set 및 sp_describe_undeclared_parameters 저장 프로시저를 사용하여 메타데이터를 검색합니다. 이러한 저장 프로시저에는 몇 가지 제한 사항이 있습니다(예: 임시 테이블에서 실행할 경우 실패함). Use FMTONLY을trueSET FMTONLY로 설정하면, 드라이버가 대신 메타데이터 검색에 이를 사용하도록 지시합니다. |
User ID |
DBPROP_AUTH_USERID |
SQL Server 로그인 이름입니다. |
Workstation ID |
SSPROP_INIT_WSID |
워크스테이션 식별자입니다. |
1 보안을 개선하기 위해 인증/액세스 토큰 초기화 속성 또는 해당 연결 문자열 키워드를 사용할 때 암호화 및 인증서 유효성 검사 동작이 수정됩니다. 자세한 내용은 암호화 및 인증서 유효성 검사를 참조하세요.
참고
연결 문자열에서 Old Password 속성이 SSPROP_AUTH_OLD_PASSWORD을 설정하며, 이는 공급자 문자열 속성으로는 사용할 수 없는 현재(만료되었을 수 있음) 암호입니다.
ADO(ActiveX Data Objects) 연결 문자열 키워드
ADO 애플리케이션은 ConnectionString 개체의 속성을 설정하거나 ADODBConnection 개체의 Open 메서드에 매개변수로 연결 문자열을 ADODBConnection 제공합니다.
ADO 애플리케이션은 OLE DB IDBInitialize::Initialize 메서드에서 사용하는 키워드를 사용할 수도 있지만 기본값이 없는 속성에만 사용할 수 있습니다. 애플리케이션에서 ADO 키워드와 초기화 문자열의 IDBInitialize::Initialize 키워드를 모두 사용하는 경우 ADO 키워드 설정이 사용됩니다. 애플리케이션에서 ADO 연결 문자열 키워드만 사용하는 것이 좋습니다.
ADO에서 사용하는 연결 문자열의 구문은 다음과 같습니다.
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
특성 값을 큰따옴표로 묶을 수도 있으며, 그렇게 하는 것이 좋습니다. 이 방법으로 값에 영숫자가 아닌 문자가 있을 경우 발생할 수 있는 문제를 막을 수 있습니다. 특성 값에는 큰따옴표가 있으면 안 됩니다.
다음 표에서는 ADO 연결 문자열과 함께 사용할 수 있는 키워드에 대해 설명합니다.
| 키워드 | 초기화 속성 | Description |
|---|---|---|
Access Token
1 |
SSPROP_AUTH_ACCESS_TOKEN |
Microsoft Entra ID에 인증하는 데 사용되는 액세스 토큰입니다. 참고: 이 키워드와 UID, PWD, Trusted_Connection, 또는 Authentication 연결 문자열 키워드나 그에 대응하는 속성/키워드를 지정하는 것은 오류입니다. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
서버에 연결할 때 애플리케이션 작업 유형을 선언합니다. 가능한 값은 ReadOnly 및 ReadWrite입니다.기본값은 ReadWrite입니다. OLE DB Driver for SQL Server의 Always On 가용성 그룹 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 고가용성, 재해 복구 지원을 참조하세요. |
Application Name |
SSPROP_INIT_APPNAME |
애플리케이션을 식별하는 문자열입니다. |
Authentication
1 |
SSPROP_AUTH_MODE |
사용되는 SQL 또는 Microsoft Entra 인증을 지정합니다. 유효한 값은 다음과 같습니다.
참고: 이 키워드는 ActiveDirectoryIntegrated SQL Server에 대한 Windows 인증에도 사용할 수 있습니다.
Integrated Security(또는 Trusted_Connection) 인증 키워드를 대체합니다. 키워드 또는 해당 속성을 사용하는 Integrated SecurityTrusted_Connection애플리케이션은 새로운 암호화 및 인증서 검증 동작을 가능하게 하기 위해 Authentication 키워드(또는 해당 속성)의 ActiveDirectoryIntegrated 값을 설정해야 합니다.참고: SQL Server 인증을 사용하는 애플리케이션은 Authentication을 가능하게 하기 위해 SqlPassword 키워드(또는 해당 속성)의 값을 설정해야 합니다. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
OEM/ANSI 문자 변환을 구성합니다. 인식되는 값은 true 및 false입니다. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
데이터 원본 초기화가 완료될 때까지 기다릴 시간(초)입니다. |
Connect Retry Count |
SSPROP_INIT_CONNECT_RETRY_COUNT |
연결이 끊어진 경우 다시 연결 시도 횟수를 제어합니다. 유효한 값은 0에서 255 사이입니다. 기본값은 1입니다. 값이 0인 경우, 다시 연결하려는 시도가 이루어지지 않습니다. 자세한 내용은 OLE DB 드라이버의 유휴 연결 복원력을 참조하세요. |
Connect Retry Interval |
SSPROP_INIT_CONNECT_RETRY_INTERVAL |
연결이 끊어진 경우 연결하려고 다시 시도하는 간격(초)을 지정합니다. 유효한 값은 1에서 60 사이입니다. 기본값은 10입니다. 자세한 내용은 OLE DB 드라이버의 유휴 연결 복원력을 참조하세요. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
SQL Server 언어 이름입니다. |
Data Source |
DBPROP_INIT_DATASOURCE |
조직의 SQL Server 인스턴스 이름입니다. 지정하지 않으면 로컬 컴퓨터의 기본 인스턴스에 연결합니다. 유효한 주소 구문에 대한 자세한 내용은 이 문서에서 키워드에 Server 대한 설명을 참조하세요. |
DataTypeCompatibility |
SSPROP_INIT_DATATYPECOMPATIBILITY |
사용할 데이터 형식 처리 모드를 지정합니다. 인식되는 값은 0(공급자 데이터 형식) 및 80(SQL Server 2000(8.x) 데이터 형식)입니다. |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
데이터베이스 미러링에 사용되는 장애 조치(failover) 서버의 이름입니다. |
Failover Partner SPN |
SSPROP_INIT_FAILOVERPARTNERSPN |
장애 조치(failover) 파트너의 SPN입니다. 기본값은 빈 문자열입니다. 빈 문자열을 지정하면 OLE DB Driver for SQL Server는 공급자가 생성한 기본 SPN을 사용합니다. |
Host Name In Certificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
SQL Server TLS/SSL 인증서의 유효성을 검사할 때 사용할 호스트 이름입니다. 키워드가 Host Name In Certificate 설정되지 않은 경우 드라이버는 연결 URL의 Data Source 키워드 값을 호스트 이름으로 사용하여 SQL Server TLS/SSL 인증서의 유효성을 검사합니다.참고: 서버 인증서를 신뢰할 수 있는 경우 이 속성은 무시됩니다. Use Encryption for Data이 Strict로 설정되면, 인증서는 항상 검증됩니다. |
Initial Catalog |
DBPROP_INIT_CATALOG |
데이터베이스 이름입니다. |
Initial File Name |
SSPROP_INIT_FILENAME |
연결할 수 있는 데이터베이스의 전체 경로 이름을 포함한 주 파일의 이름입니다. 사용 AttachDBFileName하려면 공급자 문자열 DATABASE 키워드를 사용하여 데이터베이스 이름도 지정해야 합니다. 데이터베이스가 이전에 연결된 경우 SQL Server에서는 이 데이터베이스를 다시 연결하지 않으며 연결된 데이터베이스를 연결 기본값으로 사용합니다. |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Windows 인증에 대해 SSPI 값을 허용합니다. |
MARS Connection |
SSPROP_INIT_MARSCONNECTION |
서버가 SQL Server 2005(9.x) 이상 버전인 경우 연결에서 MARS(Multiple Active Result Sets)를 설정하거나 해제합니다. 인식되는 값은 true 및 false입니다. 기본값은 false입니다. |
MultiSubnetFailover |
SSPROP_INIT_MULTISUBNETFAILOVER |
SQL Server 가용성 그룹 또는 SQL Server 장애 조치(failover) 클러스터 인스턴스의 가용성 그룹 수신기에 연결할 때는 항상 MultiSubnetFailover=True을 지정합니다.
MultiSubnetFailover=True 는 (현재) 활성 서버에 대한 빠른 검색 및 연결을 제공하도록 SQL Server용 OLE DB 드라이버를 구성합니다. 가능한 값은 True 및 False입니다. 기본값은 False입니다. 다음은 그 예입니다.MultiSubnetFailover=TrueOLE DB Driver for SQL Server의 Always On 가용성 그룹 지원에 대한 자세한 내용은 OLE DB Driver for SQL Server의 고가용성, 재해 복구 지원을 참조하세요. |
Network Address |
SSPROP_INIT_NETWORKADDRESS |
조직의 SQL Server 인스턴스 네트워크 주소입니다. 유효한 주소 구문에 대한 자세한 내용은 이 문서에서 키워드에 Address 대한 설명을 참조하세요. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
조직의 SQL Server 인스턴스에 연결하는 데 사용하는 네트워크 라이브러리입니다. |
Packet Size |
SSPROP_INIT_PACKETSIZE |
TDS(Tabular Data Stream) 패킷 크기입니다. 기본값은 0 서버에서 실제 값을 결정합니다. |
Password |
DBPROP_AUTH_PASSWORD |
SQL Server 로그인 암호입니다. |
Persist Security Info |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
true 및 false 문자열을 값으로 허용합니다.
false인 경우 중요한 인증 정보를 데이터 원본 개체에 유지할 수 없습니다. |
Provider |
OLE DB Driver for SQL Server의 경우 값은 MSOLEDBSQL19 또는 MSOLEDBSQL입니다. |
|
Server Certificate |
SSPROP_INIT_SERVER_CERTIFICATE |
SQL Server TLS/SSL 인증서와 일치시킬 인증서 파일의 경로를 지정합니다. 이 옵션은 Strict 암호화를 사용하도록 설정한 경우에만 사용할 수 있습니다. 허용되는 인증서 형식은 PEM, DER 및 CER입니다. 지정된 경우 제공된 인증서가 정확히 일치하는지 확인하여 SQL Server 인증서가 확인됩니다. |
Server SPN |
SSPROP_INIT_SERVERSPN |
서버의 SPN입니다. 기본값은 빈 문자열입니다. 빈 문자열을 지정하면 OLE DB Driver for SQL Server는 공급자가 생성한 기본 SPN을 사용합니다. |
TransparentNetworkIPResolution |
SSPROP_INIT_TNIR |
호스트 이름의 첫 번째 확인된 IP가 응답하지 않고 호스트 이름과 연결된 여러 IP가 있는 경우 연결 시퀀스에 영향을 미칩니다. TNIR은 MultiSubnetFailover와 상호 작용하여 다른 연결 시퀀스를 제공합니다. 가능한 값은 True 및 False입니다. 기본값은 True입니다. 자세한 내용은 투명 네트워크 IP 확인 사용을 참조하세요. |
Trust Server Certificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
true 및 false 문자열을 값으로 허용합니다. 기본값은 false이며, 서버 인증서의 유효성을 검사합니다. |
Use Encryption for Data
1 |
SSPROP_INIT_ENCRYPT |
데이터를 네트워크를 통해 보내기 전에 암호화해야 하는지 여부를 지정합니다. 가능한 값은 Optional, Mandatory 및 Strict입니다. 기본값은 Mandatory입니다. 버전 18.x.x의 경우 MSOLEDBSQL 주 버전 차이를 참조하세요. |
Use FMTONLY |
SSPROP_INIT_USEFMTONLY |
SQL Server 2012(11.x) 이상에 연결할 때 메타데이터를 검색하는 방법을 제어합니다. 가능한 값은 true 및 false입니다. 기본값은 false입니다.기본적으로 OLE DB Driver for SQL Server는 sp_describe_first_result_set 및 sp_describe_undeclared_parameters 저장 프로시저를 사용하여 메타데이터를 검색합니다. 이러한 저장 프로시저에는 몇 가지 제한 사항이 있습니다(예: 임시 테이블에서 실행할 경우 실패함). Use FMTONLY을trueSET FMTONLY로 설정하면, 드라이버가 대신 메타데이터 검색에 이를 사용하도록 지시합니다. |
User ID |
DBPROP_AUTH_USERID |
SQL Server 로그인 이름입니다. |
Workstation ID |
SSPROP_INIT_WSID |
워크스테이션 식별자입니다. |
1 보안을 개선하기 위해 인증/액세스 토큰 초기화 속성 또는 해당 연결 문자열 키워드를 사용할 때 암호화 및 인증서 유효성 검사 동작이 수정됩니다. 자세한 내용은 암호화 및 인증서 유효성 검사를 참조하세요.
참고
연결 문자열에서 공급자 문자열 속성을 통해 사용할 수 없는 현재(만료되었을 수 있음) 암호인 "이전 암호" 속성이 설정 SSPROP_AUTH_OLD_PASSWORD됩니다.