SQL Server용 OLE DB 드라이버에서 연결 문자열 키워드 사용

  • 아티클

적용 대상:SQL ServerAzure SQL 데이터베이스Azure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)

OLE DB 드라이버 다운로드

OLE DB Driver for SQL Server의 일부 API는 연결 문자열을 사용하여 연결 특성을 지정합니다. 연결 문자열은 키워드 및 관련 값의 목록으로, 각 키워드는 특정 연결 특성을 식별합니다.

참고

SQL Server용 OLE DB 드라이버는 이전 버전과의 호환성을 유지하기 위해 연결 문자열에서 모호성을 허용합니다. 예를 들어 일부 키워드를 여러 번 지정할 수 있으며 위치나 우선 순위에 따라 충돌하는 키워드를 해결할 수 있습니다. 이후 릴리스의 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::Initialize

  • IDataInitialize::GetDataSource

첫 번째 경우에는 DBPROPSET_DBINIT 속성 집합의 DBPROP_INIT_PROVIDERSTRING 속성을 설정하는 방법을 통해 공급자 문자열을 사용하여 연결 속성을 초기화할 수 있습니다. 두 번째 경우에는 초기화 문자열을 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=server2를 지정하는 경우 Data Source가 속성으로 설정되지만 Server는 공급자 문자열로 이동합니다.

같은 공급자별 속성의 인스턴스를 여러 개 지정하면 첫 번째 속성의 첫 번째 값이 사용됩니다.

IDBInitialize::Initialize 사용

IDBInitialize::Initialize에 DBPROP_INIT_PROVIDERSTRING을 지정하는 OLE DB 애플리케이션에서 사용하는 연결 문자열의 구문은 다음과 같습니다.

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

  • empty-string ::=

  • attribute ::= attribute-keyword=[{]attribute-value[}]

  • attribute-value ::= character-string

  • attribute-keyword ::= identifier

특성 값을 중괄호로 묶을 수도 있으며, 그렇게 하는 것이 좋습니다. 이 방법으로 특성 값에 영숫자가 아닌 문자가 있을 경우 발생할 수 있는 문제를 막을 수 있습니다. 값에서 첫 번째 닫는 중괄호는 값을 종료하는 문자로 간주되므로 값에 닫는 중괄호가 있어서는 안 됩니다.

연결 문자열 키워드에서 등호(=) 다음에 나오는 공백 문자는 값을 따옴표로 묶은 경우에도 리터럴로 해석됩니다.

다음 표에서는 DBPROP_INIT_PROVIDERSTRING에서 사용할 수 있는 키워드에 대해 설명합니다.

키워드 초기화 속성 Description
Addr SSPROP_INIT_NETWORKADDRESS Address의 동의어입니다.
주소 SSPROP_INIT_NETWORKADDRESS SQL Server 인스턴스를 실행하는 서버의 네트워크 주소입니다. Address는 일반적으로 서버의 네트워크 이름이지만 파이프, IP 주소나 TCP/IP 포트 및 소켓 주소와 같은 다른 이름일 수도 있습니다.

IP 주소를 지정하는 경우 SQL Server 구성 관리자에서 TCP/IP 또는 명명된 파이프 프로토콜이 설정되어 있는지 확인합니다.

OLE DB Driver for SQL Server를 사용하는 경우 Address의 값이 연결 문자열에서 Server에 전달된 값보다 우선하여 적용됩니다. 또한 Address=;이면 Server 키워드에 지정된 서버에 연결하지만 Address= ;, Address=.;, Address=localhost; 및 Address=(local);이면 항상 로컬 서버에 연결합니다.

Address 키워드에 대한 전체 구문은 다음과 같습니다.

[protocol:]Address[,port |\pipe\pipename]

protocol 은 tcp (TCP/IP), lpc (공유 메모리) 또는 np (명명된 파이프)일 수 있습니다. 프로토콜에 대한 자세한 내용은 클라이언트 프로토콜 구성을 참조하세요.

protocol 및 Network 키워드를 모두 지정하지 않은 경우 OLE DB Driver for SQL Server는 SQL Server 구성 관리자에서 지정한 프로토콜 순서를 사용합니다.

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에서는 이 데이터베이스를 다시 연결하지 않으며 연결된 데이터베이스를 연결 기본값으로 사용합니다.
인증1 SSPROP_AUTH_MODE 사용되는 SQL 또는 Microsoft Entra 인증을 지정합니다. 유효한 값은 다음과 같습니다.
  • (not set): 다른 키워드에 의해 결정되는 인증 모드입니다.
  • ActiveDirectoryPassword:Microsoft Entra ID를 사용하여 사용자 ID 및 암호 인증
  • ActiveDirectoryIntegrated: Microsoft Entra ID와 통합 인증.

    • 참고:ActiveDirectoryIntegrated 키워드는 SQL Server에 대한 Windows 인증에도 사용할 수 있습니다. Integrated Security(또는 Trusted_Connection) 인증 키워드를 대체합니다. Integrated Security(또는 Trusted_Connection) 키워드 또는 해당 속성을 사용하는 애플리케이션은 Authentication 키워드(또는 해당 속성)의 값을 ActiveDirectoryIntegrated로 설정하여 새 암호화 및 인증서 유효성 검사 동작을 사용할 것을 권장합니다.

  • ActiveDirectoryInteractive: Microsoft Entra ID를 사용한 대화형 인증. 이 방법은 Microsoft Entra 다단계 인증을 지원합니다.
  • ActiveDirectoryMSI:관리 ID 인증. 사용자 할당 ID의 경우 사용자 ID를 사용자 ID의 개체 ID로 설정해야 합니다.
  • ActiveDirectoryServicePrincipal: Microsoft Entra 서비스 주체를 사용한 인증. 사용자 ID는 애플리케이션(클라이언트) ID로 설정해야 합니다. 암호는 애플리케이션(클라이언트) 비밀로 설정해야 합니다.
  • SqlPassword: 사용자 ID 및 암호를 사용하는 인증입니다.

    • 참고:SQL Server 인증을 사용하는 애플리케이션은 Authentication 키워드(또는 해당 속성)의 값을 SqlPassword로 설정하여 새 암호화 및 인증서 유효성 검사 동작을 사용할 것을 권장합니다.
자동 번역 SSPROP_INIT_AUTOTRANSLATE AutoTranslate의 동의어입니다.
AutoTranslate SSPROP_INIT_AUTOTRANSLATE OEM/ANSI 문자 변환을 구성합니다. 인식되는 값은 yes 및 no입니다.
ConnectRetryCount SSPROP_INIT_CONNECT_RETRY_COUNT 연결이 끊어진 경우 다시 연결 시도 횟수를 제어합니다. 유효한 값은 0에서 255 사이입니다. 기본값은 1입니다. 값이 0이면 다시 연결하려고 시도하지 않습니다. 자세한 내용은 유휴 연결 복원력을 참조하세요.
ConnectRetryInterval SSPROP_INIT_CONNECT_RETRY_INTERVAL 연결이 끊어진 경우 연결하려고 다시 시도하는 간격(초)을 지정합니다. 유효한 값은 1에서 60 사이입니다. 기본값은 10입니다. 자세한 내용은 유휴 연결 복원력을 참조하세요.
Database DBPROP_INIT_CATALOG 데이터베이스 이름입니다.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY 사용할 데이터 형식 처리 모드를 지정합니다. 인식되는 값은 0(공급자 데이터 형식) 및 80(SQL Server 2000 데이터 형식)입니다.
Encrypt1 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 인증서의 유효성을 검사합니다.
참고: 서버 인증서를 신뢰할 수 있는 경우 이 속성은 무시됩니다. 암호화가 Strict로 설정되면 인증서의 유효성이 항상 검사됩니다.
언어 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=Yes

OLE 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 키워드에 대한 전체 구문은 다음과 같습니다.

Server= [protocol: ]Server[ ,port]

protocol 은 tcp (TCP/IP), lpc (공유 메모리) 또는 np (명명된 파이프)일 수 있습니다.

다음 예시는 명명된 파이프를 지정합니다.

np:\\.\pipe\MSSQL$MYINST01\sql\query

위 줄은 명명된 파이프 프로토콜(np), 로컬 머신의 명명된 파이프(\\.\pipe), SQL Server 인스턴스 이름(MSSQL$MYINST01) 및 명명된 파이프의 기본 이름(sql/query)을 지정합니다.

protocol 및 Network 키워드를 모두 지정하지 않은 경우 OLE DB Driver for SQL Server는 SQL Server 구성 관리자에서 지정한 프로토콜 순서를 사용합니다.

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 키워드를 지정해야 합니다.
TrustServerCertificate1 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를 yes로 설정하면 드라이버가 메타데이터 검색을 위해 SET FMTONLY를 대신 사용합니다.
UseProcForPrepare SSPROP_INIT_USEPROCFORPREP 이 키워드는 더 이상 사용되지 않으며 OLE DB Driver for SQL Server는 이 설정을 무시합니다.
WSID SSPROP_INIT_WSID 워크스테이션 식별자입니다.

[1]: 보안을 개선하기 위해 인증 또는 액세스 토큰 초기화 속성이나 해당 연결 문자열 키워드를 사용하는 경우, 암호화 및 인증서 유효성 검사 동작이 수정됩니다. 자세한 내용은 암호화 및 인증서 유효성 검사를 참조하세요.

IDataInitialize::GetDataSource 사용

IDataInitialize::GetDataSource를 사용하는 OLE DB 애플리케이션에서 사용하는 연결 문자열의 구문은 다음과 같습니다.

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

  • empty-string ::=

  • attribute ::= attribute-keyword=[quote]attribute-value[quote]

  • attribute-value ::= character-string

  • attribute-keyword ::= identifier

  • quote ::= " | '

속성 사용은 해당 범위에 허용되는 구문을 따라야 합니다. 예를 들어 WSID는 따옴표 대신 중괄호( {} )를 사용하고 애플리케이션 이름은 작은따옴표( ' ) 또는 큰따옴표( " )를 사용합니다. 문자열 속성만 따옴표로 묶을 수 있습니다. 정수 또는 열거형 속성을 따옴표로 묶으면 Connection String doesn't conform to OLE DB specification 오류가 발생합니다.

특성 값을 작은따옴표나 큰따옴표로 묶을 수 있으며, 그렇게 하는 것이 좋습니다. 이 방법으로 값에 영숫자가 아닌 문자가 있을 경우 발생할 수 있는 문제를 막을 수 있습니다. 큰따옴표로 묶은 경우 따옴표로 묶어 사용한 문자도 값에 표시할 수 있습니다.

연결 문자열 키워드에서 등호(=) 다음에 나오는 공백 문자는 값을 따옴표로 묶은 경우에도 리터럴로 해석됩니다.

연결 문자열에 다음 표에 나열된 속성이 두 개 이상 있으면 마지막 속성의 값이 사용됩니다.

다음 표에서는 IDataInitialize::GetDataSource에서 사용할 수 있는 키워드에 대해 설명합니다.

키워드 초기화 속성 Description
액세스 토큰1 SSPROP_AUTH_ACCESS_TOKEN Microsoft Entra ID에 인증하는 데 사용되는 액세스 토큰입니다.

참고: 이 키워드를 지정하면 오류가 발생하고 UID, PWD, Trusted_Connection 또는 Authentication 연결 문자열 키워드 또는 해당 속성/키워드를 지정해도 오류가 발생합니다.
애플리케이션 이름 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의 고가용성, 재해 복구 지원을 참조하세요.
인증1 SSPROP_AUTH_MODE 사용되는 SQL 또는 Microsoft Entra 인증을 지정합니다. 유효한 값은 다음과 같습니다.
  • (not set): 다른 키워드에 의해 결정되는 인증 모드입니다.
  • ActiveDirectoryPassword:Microsoft Entra ID를 사용하여 사용자 ID 및 암호 인증
  • ActiveDirectoryIntegrated: Microsoft Entra ID와 통합 인증.

    • 참고:ActiveDirectoryIntegrated 키워드는 SQL Server에 대한 Windows 인증에도 사용할 수 있습니다. Integrated Security(또는 Trusted_Connection) 인증 키워드를 대체합니다. Integrated Security(또는 Trusted_Connection) 키워드 또는 해당 속성을 사용하는 애플리케이션은 Authentication 키워드(또는 해당 속성)의 값을 ActiveDirectoryIntegrated로 설정하여 새 암호화 및 인증서 유효성 검사 동작을 사용할 것을 권장합니다.

  • ActiveDirectoryInteractive: Microsoft Entra ID를 사용한 대화형 인증. 이 방법은 Microsoft Entra 다단계 인증을 지원합니다.
  • ActiveDirectoryMSI:관리 ID 인증. 사용자 할당 ID의 경우 사용자 ID를 사용자 ID의 개체 ID로 설정해야 합니다.
  • ActiveDirectoryServicePrincipal: Microsoft Entra 서비스 주체를 사용한 인증. 사용자 ID는 애플리케이션(클라이언트) ID로 설정해야 합니다. 암호는 애플리케이션(클라이언트) 비밀로 설정해야 합니다.
  • SqlPassword: 사용자 ID 및 암호를 사용하는 인증입니다.

    • 참고:SQL Server 인증을 사용하는 애플리케이션은 Authentication 키워드(또는 해당 속성)의 값을 SqlPassword로 설정하여 새 암호화 및 인증서 유효성 검사 동작을 사용할 것을 권장합니다.
자동 번역 SSPROP_INIT_AUTOTRANSLATE OEM/ANSI 문자 변환을 구성합니다. 인식되는 값은 true 및 false입니다.
Connect Timeout DBPROP_INIT_TIMEOUT 데이터 원본 초기화가 완료될 때까지 기다릴 시간(초)입니다.
연결 다시 시도 횟수 SSPROP_INIT_CONNECT_RETRY_COUNT 연결이 끊어진 경우 다시 연결 시도 횟수를 제어합니다. 유효한 값은 0에서 255 사이입니다. 기본값은 1입니다. 값이 0이면 다시 연결하려고 시도하지 않습니다. 자세한 내용은 유휴 연결 복원력을 참조하세요.
연결 다시 시도 간격 SSPROP_INIT_CONNECT_RETRY_INTERVAL 연결이 끊어진 경우 연결하려고 다시 시도하는 간격(초)을 지정합니다. 유효한 값은 1에서 60 사이입니다. 기본값은 10입니다. 자세한 내용은 유휴 연결 복원력을 참조하세요.
Current Language SSPROPT_INIT_CURRENTLANGUAGE SQL Server 언어 이름입니다.
데이터 원본 DBPROP_INIT_DATASOURCE 조직의 SQL Server 인스턴스 이름입니다.

지정하지 않으면 로컬 컴퓨터의 기본 인스턴스에 연결합니다.

유효한 주소 구문에 대한 자세한 내용은 이 문서에 있는 Server 키워드에 대한 설명을 참조하세요.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY 사용할 데이터 형식 처리 모드를 지정합니다. 인식되는 값은 0(공급자 데이터 형식) 및 80(SQL Server 2000(8.x) 데이터 형식)입니다.
장애 조치(failover) 파트너 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 인증서의 유효성을 검사합니다.
참고: 서버 인증서를 신뢰할 수 있는 경우 이 속성은 무시됩니다. 데이터에 대해 암호화 사용이 Strict로 설정되면 인증서의 유효성이 항상 검사됩니다.
초기 카탈로그 DBPROP_INIT_CATALOG 데이터베이스 이름입니다.
초기 파일 이름 SSPROP_INIT_FILENAME 연결할 수 있는 데이터베이스의 전체 경로 이름을 포함한 주 파일의 이름입니다. AttachDBFileName을 사용하려면 공급자 문자열 DATABASE 키워드에도 데이터베이스 이름을 지정해야 합니다. 데이터베이스가 이전에 연결된 경우 SQL Server에서는 이 데이터베이스를 다시 연결하지 않으며 연결된 데이터베이스를 연결 기본값으로 사용합니다.
통합 보안 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=True

OLE 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입니다(실제 값은 서버에서 결정함).
암호 DBPROP_AUTH_PASSWORD SQL Server 로그인 암호입니다.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO true 및 false 문자열을 값으로 허용합니다. false인 경우 중요한 인증 정보를 데이터 원본 개체에 유지할 수 없습니다.
공급자 OLE DB Driver for SQL Server의 경우 이 값은 "MSOLEDBSQL19" 또는 "MSOLEDBSQL"이어야 합니다.
서버 인증서 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 확인 사용을 참조하세요.
서버 인증서 신뢰1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE true 및 false 문자열을 값으로 허용합니다. 기본값은 false이며, 서버 인증서의 유효성을 검사합니다.
데이터에 대해 암호화 사용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를 true로 설정하면 드라이버가 메타데이터 검색을 위해 SET FMTONLY를 대신 사용합니다.
사용자 ID DBPROP_AUTH_USERID SQL Server 로그인 이름입니다.
Workstation ID SSPROP_INIT_WSID 워크스테이션 식별자입니다.

[1]: 보안을 개선하기 위해 인증/액세스 토큰 초기화 속성 또는 해당 연결 문자열 키워드를 사용하는 경우 암호화 및 인증서 유효성 검사 동작이 수정됩니다. 자세한 내용은 암호화 및 인증서 유효성 검사를 참조하세요.

참고

연결 문자열에서 Old Password 속성은 공급자 문자열 속성을 통해 사용할 수 없는 현재(만료된) 암호인 SSPROP_AUTH_OLD_PASSWORD를 설정합니다.

ADO(ActiveX Data Objects) 연결 문자열 키워드

ADO 애플리케이션에서는 ADODBConnection 개체의 ConnectionString 속성을 설정하거나 ADODBConnection 개체의 Open 메서드에 대한 매개 변수로 연결 문자열을 제공합니다.

ADO 애플리케이션에서는 OLE DB IDBInitialize::Initialize 메서드에 사용되는 키워드도 사용할 수 있지만 이러한 키워드는 기본값이 없는 속성에만 사용할 수 있습니다. 애플리케이션이 초기화 문자열에 ADO 키워드와 IDBInitialize::Initialize 키워드를 모두 사용하는 경우에는 ADO 키워드 설정이 사용됩니다. 애플리케이션에서 ADO 연결 문자열 키워드만 사용하는 것이 좋습니다.

ADO에서 사용하는 연결 문자열의 구문은 다음과 같습니다.

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

  • empty-string ::=

  • attribute ::= attribute-keyword=["]attribute-value["]

  • attribute-value ::= character-string

  • attribute-keyword ::= identifier

특성 값을 큰따옴표로 묶을 수도 있으며, 그렇게 하는 것이 좋습니다. 이 방법으로 값에 영숫자가 아닌 문자가 있을 경우 발생할 수 있는 문제를 막을 수 있습니다. 특성 값에는 큰따옴표가 있으면 안 됩니다.

다음 표에서는 ADO 연결 문자열에서 사용할 수 있는 키워드에 대해 설명합니다.

키워드 초기화 속성 Description
액세스 토큰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의 고가용성, 재해 복구 지원을 참조하세요.
애플리케이션 이름 SSPROP_INIT_APPNAME 애플리케이션을 식별하는 문자열입니다.
인증1 SSPROP_AUTH_MODE 사용되는 SQL 또는 Microsoft Entra 인증을 지정합니다. 유효한 값은 다음과 같습니다.
  • (not set): 다른 키워드에 의해 결정되는 인증 모드입니다.
  • ActiveDirectoryPassword:Microsoft Entra ID를 사용하여 사용자 ID 및 암호 인증
  • ActiveDirectoryIntegrated: Microsoft Entra ID와 통합 인증.

    • 참고:ActiveDirectoryIntegrated 키워드는 SQL Server에 대한 Windows 인증에도 사용할 수 있습니다. Integrated Security(또는 Trusted_Connection) 인증 키워드를 대체합니다. Integrated Security(또는 Trusted_Connection) 키워드 또는 해당 속성을 사용하는 애플리케이션은 Authentication 키워드(또는 해당 속성)의 값을 ActiveDirectoryIntegrated로 설정하여 새 암호화 및 인증서 유효성 검사 동작을 사용할 것을 권장합니다.

  • ActiveDirectoryInteractive: Microsoft Entra ID를 사용한 대화형 인증. 이 방법은 Microsoft Entra 다단계 인증을 지원합니다.
  • ActiveDirectoryMSI:관리 ID 인증. 사용자 할당 ID의 경우 사용자 ID를 사용자 ID의 개체 ID로 설정해야 합니다.
  • ActiveDirectoryServicePrincipal: Microsoft Entra 서비스 주체를 사용한 인증. 사용자 ID는 애플리케이션(클라이언트) ID로 설정해야 합니다. 암호는 애플리케이션(클라이언트) 비밀로 설정해야 합니다.
  • SqlPassword: 사용자 ID 및 암호를 사용하는 인증입니다.

    • 참고:SQL Server 인증을 사용하는 애플리케이션은 Authentication 키워드(또는 해당 속성)의 값을 SqlPassword로 설정하여 새 암호화 및 인증서 유효성 검사 동작을 사용할 것을 권장합니다.
자동 번역 SSPROP_INIT_AUTOTRANSLATE OEM/ANSI 문자 변환을 구성합니다. 인식되는 값은 true 및 false입니다.
Connect Timeout DBPROP_INIT_TIMEOUT 데이터 원본 초기화가 완료될 때까지 기다릴 시간(초)입니다.
연결 다시 시도 횟수 SSPROP_INIT_CONNECT_RETRY_COUNT 연결이 끊어진 경우 다시 연결 시도 횟수를 제어합니다. 유효한 값은 0에서 255 사이입니다. 기본값은 1입니다. 값이 0이면 다시 연결하려고 시도하지 않습니다. 자세한 내용은 유휴 연결 복원력을 참조하세요.
연결 다시 시도 간격 SSPROP_INIT_CONNECT_RETRY_INTERVAL 연결이 끊어진 경우 연결하려고 다시 시도하는 간격(초)을 지정합니다. 유효한 값은 1에서 60 사이입니다. 기본값은 10입니다. 자세한 내용은 유휴 연결 복원력을 참조하세요.
Current Language SSPROPT_INIT_CURRENTLANGUAGE SQL Server 언어 이름입니다.
데이터 원본 DBPROP_INIT_DATASOURCE 조직의 SQL Server 인스턴스 이름입니다.

지정하지 않으면 로컬 컴퓨터의 기본 인스턴스에 연결합니다.

유효한 주소 구문에 대한 자세한 내용은 이 문서에 있는 Server 키워드에 대한 설명을 참조하세요.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY 사용할 데이터 형식 처리 모드를 지정합니다. 인식되는 값은 0(공급자 데이터 형식) 및 80(SQL Server 2000 데이터 형식)입니다.
장애 조치(failover) 파트너 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 인증서의 유효성을 검사합니다.
참고: 서버 인증서를 신뢰할 수 있는 경우 이 속성은 무시됩니다. 데이터에 대해 암호화 사용이 Strict로 설정되면 인증서의 유효성이 항상 검사됩니다.
초기 카탈로그 DBPROP_INIT_CATALOG 데이터베이스 이름입니다.
초기 파일 이름 SSPROP_INIT_FILENAME 연결할 수 있는 데이터베이스의 전체 경로 이름을 포함한 주 파일의 이름입니다. AttachDBFileName을 사용하려면 공급자 문자열 DATABASE 키워드에도 데이터베이스 이름을 지정해야 합니다. 데이터베이스가 이전에 연결된 경우 SQL Server에서는 이 데이터베이스를 다시 연결하지 않으며 연결된 데이터베이스를 연결 기본값으로 사용합니다.
통합 보안 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=True

OLE 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입니다(실제 값은 서버에서 결정함).
암호 DBPROP_AUTH_PASSWORD SQL Server 로그인 암호입니다.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO true 및 false 문자열을 값으로 허용합니다. false인 경우 중요한 인증 정보를 데이터 원본 개체에 유지할 수 없습니다.
공급자 OLE DB Driver for SQL Server의 경우 값은 MSOLEDBSQL19 또는 MSOLEDBSQL입니다.
서버 인증서 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 확인 사용을 참조하세요.
서버 인증서 신뢰1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE true 및 false 문자열을 값으로 허용합니다. 기본값은 false이며, 서버 인증서의 유효성을 검사합니다.
데이터에 대해 암호화 사용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를 true로 설정하면 드라이버가 메타데이터 검색을 위해 SET FMTONLY를 대신 사용합니다.
사용자 ID DBPROP_AUTH_USERID SQL Server 로그인 이름입니다.
Workstation ID SSPROP_INIT_WSID 워크스테이션 식별자입니다.

[1]: 보안을 개선하기 위해 인증/액세스 토큰 초기화 속성 또는 해당 연결 문자열 키워드를 사용하는 경우 암호화 및 인증서 유효성 검사 동작이 수정됩니다. 자세한 내용은 암호화 및 인증서 유효성 검사를 참조하세요.

참고

연결 문자열에서 "이전 암호" 속성은 공급자 문자열 속성을 통해 사용할 수 없는 현재(만료된) 암호인 SSPROP_AUTH_OLD_PASSWORD를 설정합니다.

참고 항목

SQL Server용 OLE DB 드라이버로 애플리케이션 빌드