SQL Server Native Client에서 연결 문자열 키워드 사용

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

일부 SQL Server Native Client API는 연결 문자열을 사용하여 연결 특성을 지정합니다. 연결 문자열은 키워드와 연관된 값의 목록이며 각 키워드는 특정 연결 특성을 식별합니다.

자세한 내용은 OLE DB Driver for SQL Server에서 연결 문자열 키워드 사용을 참조 하세요.

다음 섹션에서는 SQL Server Native Client를 데이터 공급자로 사용할 때 SQL Server Native Client OLE DB 공급자, SQL Server Native Client ODBC 드라이버 및 ADO(ActiveX Data Objects)와 함께 사용할 수 있는 키워드에 대해 설명합니다.

ODBC 드라이버 연결 문자열 키워드

ODBC 애플리케이션은 연결 문자열을 SQLDriverConnect 및 SQLBrowseConnect 함수에 대한 매개 변수로 사용합니다.

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

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

empty-string ::=

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

attribute-value ::= character-string

attribute-keyword ::= identifier

특성 값은 선택적으로 중괄호로 묶을 수 있으며 이렇게 하는 것이 좋습니다. 이렇게 하면 특성 값에 영숫자가 아닌 문자가 포함된 경우 문제가 발생하지 않습니다. 값의 첫 번째 닫는 중괄호는 값을 종료하는 것으로 간주되므로 값에 닫는 중괄호 문자를 포함할 수 없습니다.

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

SQL Server Native Client ODBC 드라이버는 현재 사용자의 로캘 레지스트리 설정을 사용합니다. 애플리케이션이 연결 후 SetThreadLocale를 호출하여 설정하는 경우 드라이버는 현재 스레드의 로캘을 적용하지 않습니다.

데이터 원본의 국가별 동작을 변경하면 애플리케이션에서 오류가 발생할 수 있습니다. 날짜 문자열을 구문 분석하고 ODBC에서 정의한 대로 날짜 문자열이 표시될 것으로 예상하는 애플리케이션은 이 값을 변경하면 부정적인 영향을 받을 수 있습니다.

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 키워드를 사용하지 않는 것이 좋습니다.

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

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에서 사용할 수 있는 키워드에 대해 설명합니다.

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는 따옴표 대신 중괄호( {} )를 사용하고 애플리케이션 이름은 작은따옴표( ' ) 또는 큰따옴표( " )를 사용합니다. 문자열 속성만 따옴표로 묶을 수 있습니다. 정수 또는 열거된 속성을 인용하려고 하면 "연결 문자열이 OLE DB 사양을 준수하지 않습니다." 오류가 발생합니다.

특성 값을 작은따옴표나 큰따옴표로 묶을 수 있으며 그렇게 하는 것이 좋습니다. 이렇게 하면 값에 영숫자가 아닌 문자가 포함된 경우 문제가 발생하지 않습니다. 두 배가 되는 경우 사용된 따옴표 문자도 값에 표시될 수 있습니다.

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

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

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

참고 연결 문자열에서 “이전 암호” 속성은 공급자 문자열 속성을 통해 사용할 수 없는 현재(만료된) 암호인 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 연결 문자열에서 사용할 수 있는 키워드에 대해 설명합니다.

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

참고 항목

SQL Server Native Client를 사용하여 애플리케이션 빌드