CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS
이 문서에서는 공급자에 따라 CONNECTION_OPTIONS 대한 추가 세부 정보를 제공합니다. CREATE EXTERNAL DATA SOURCE CONNECTION_OPTIONS 인수는 외부 데이터 공급자에 따라 달라질 수 있습니다.
CREATE EXTERNAL DATA SOURCE에 대한 CONNECTION_OPTIONS 인수는 SQL Server 2019(15.x)에서 처음 도입되었습니다. 이 문서는 Windows 및 Linux용 SQL Server 2019(15.x)와 SQL Server 2019 빅 데이터 클러스터에 적용됩니다.
-
key_value_pair는 키워드이며 특정 연결 옵션 값입니다. - 여러 연결 옵션을 사용하려면 세미콜론으로 구분합니다.
- 가능한 키 값 쌍은 드라이버에 따라 다릅니다.
이 문서의 나머지 부분에는 공급자별 연결 옵션이 포함되어 있습니다.
SQL Server 외부 데이터 원본
DSN/연결 문자열 키워드 열 아래에 DSN 및 연결 문자열 키워드 및 특성에 항목이 있는 키-값 쌍만 지정할 수 있습니다. 예를 들어 SQL_ATTR_TXN_ISOLATION 키워드는 연결 문자열이 아닌 SQLSetConnectAttr을 사용하는 특성 집합이므로 지원되지 않습니다.
Microsoft OLE DB 공급자에 대한 연결 문자열 키워드 및 옵션:
- Microsoft OLE DB Driver for SQL Server: SQL Server용 OLE DB 드라이버에서 연결 문자열 키워드 사용
- SQL Native Client(사용되지 않음) 연결 문자열 키워드를 사용한 SQL Native Client NATIVE Client OLE DB(SQLNCLI)
Microsoft ODBC DB 공급자에 대한 연결 문자열 키워드 및 옵션:
- Microsoft ODBC Driver for SQL Server: DSN 및 연결 문자열 키워드 및 특성
- SQL Native Client(사용되지 않음) ODBC 드라이버 연결 문자열 키워드
Oracle
다음과 같이 Oracle 유선 프로토콜 테이블에 항목이 있는 키-값 쌍만 지정할 수 있습니다.
| 특성(짧은 이름) | 기본값 |
|---|---|
| AccountingInfo(AI) | None |
| Action(ACT) | None |
| AlternateServers(ASRV) | None |
| AllowedOpenSSLVersions(AOV) | 최신 |
| ApplicationName(AN) | None |
| ApplicationUsingThreads(AUT) | 1(사용) |
| ArraySize(AS) | 60000 |
| AuthenticationMethod(AM) | 1(암호 암호화) |
| BatchFailureReturnsError(BFRE) | 0(사용 안 함) |
| BindParamsAsUnicode(BPAU) | 0(사용 안 함) |
| BulkBinaryThreshold(BBT) | 32 |
| BulkCharacterThreshold(BCT) | -1 |
| BulkLoadBatchSize(BLBS) | 1024 |
| BulkLoadFieldDelimiter(BLFD) | None |
| BulkLoadOptions(BLO) | 0 |
| BulkLoadRecordDelimiter(BLRD) | None |
| CachedCursorLimit(CCL) | 32 |
| CachedDescriptionLimit(CDL) | 0 |
| CatalogIncludesSynonyms(CIS) | 1(사용) |
| CatalogOptions(CO) | 0(사용 안 함) |
| ClientHostName(CHN) | None |
| ClientID(CID) | None |
| ClientUser(CU) | None |
| ConnectionReset(CR) | 0(사용 안 함) |
| ConnectionRetryCount(CRC) | 0 |
| ConnectionRetryDelay(CRD) | 3 |
| CredentialsWalletEntry(CWE) | None |
| CredentialsWalletPassword(CWPWD) | None |
| CredentialsWalletPath(CWPATH) | None |
| CryptoProtocolVersion(CPV) | TLSv1.2,TLSv1.1,TLSv1 |
| CryptoLibName(CLN) | 빈 문자열 |
| DataIntegrityLevel(DIL) | 1(수락됨) |
| DataIntegrityTypes(DIT) | MD5, SHA1, SHA256, SHA384, SHA512 |
| DataSourceName(DSN) | None |
| DefaultLongDataBuffLen(DLDBL) | 1024 |
| DescribeAtPrepare(DAP) | 0(사용 안 함) |
| 설명(n/a) | None |
| EditionName(EN) | None |
| EnableBulkLoad(EBL) | 0(사용 안 함) |
| EnableDescribeParam(EDP) | 0(사용 안 함) |
| EnableNcharSupport(ENS)(사용되지 않음) | None |
| EnableScrollableCursors(ESC) | 1(사용) |
| EnableServerResultCache(ESRC) | 0(사용 안 함) |
| EnableStaticCursorsForLongData(ESCLD) | 0(사용 안 함) |
| EnableTimestampwithTimezone(ETWT)(사용되지 않음) | None |
| EncryptionLevel(EL) | 1(수락됨) |
| EncryptionMethod(EM) | 0(암호화 없음) |
| EncryptionTypes(ET) | 암호화 메서드가 지정되지 않았습니다. 드라이버는 모든 암호화 방법 목록을 Oracle 서버로 보냅니다. |
| FailoverGranularity(FG) | 0(비원자성) |
| FailoverMode(FM) | 0(연결) |
| FailoverPreconnect(FP) | 0(사용 안 함) |
| FetchTSWTZasTimestamp(FTSWTZAT) | 0(사용 안 함) |
| GSSClient(GSSC) | native |
| HostName(HOST) | None |
| HostNameInCertificate(HNIC) | None |
| IANAAppCodePage(IACP)(UNIX 및 Linux에만 해당) | 4(ISO 8559-1 Latin-1) |
| ImpersonateUser(IU) | None |
| InitializationString(IS) | None |
| KeepAlive(KA) | 0(사용 안 함) |
| KeyPassword(KP) | None |
| Keystore(KS) | None |
| KeystorePassword(KSP) | None |
| LDAPDistinguishedName(LDAPDN) | None |
| LoadBalanceTimeout(LBT) | 0 |
| LoadBalancing(LB) | 0(사용 안 함) |
| LOBPrefetchSize(LPS) | 4000 |
| LocalTimezoneOffset(LTZO) | ""(빈 문자열) |
| LockTimeout(LTO) | -1 |
| LoginTimeout(LT) | 15 |
| LogonID(UID) | None |
| MaxPoolSize(MXPS) | 100 |
| MinPoolSize(MNPS) | 0 |
| Module(MOD) | None |
| Password(PWD) | None |
| Pooling(POOL) | 0(사용 안 함) |
| PortNumber(PORT) | None |
| PRNGSeedFile(PSF)(UNIX 및 Linux에만 해당) | /dev/random |
| PRNGSeedSource(PSS)(UNIX 및 Linux에만 해당) | 0(파일) |
| ProcedureRetResults(PRR) | 0(사용 안 함) |
| ProgramID(PID) | None |
| ProxyHost(PXHN) | 빈 문자열 |
| ProxyMode(PXM) | 0(없음) |
| ProxyPassword(PXPW) | 빈 문자열 |
| ProxyPort(PXPT) | 0 |
| ProxyUser(PXU) | 빈 문자열 |
| QueryTimeout(QT) | 0 |
| ReportCodepageConversionErrors(RCCE) | 0(오류 무시) |
| ReportRecycleBin(RRB) | 0(사용 안 함) |
| SDUSize(SDU) | 16384 |
| ServerName(SRVR) | None |
| ServerType(ST) | 0(서버 기본값) |
| ServiceName(SN) | 없음 SID, 서비스 이름 또는 TNSNames 옵션에 대해 값이 지정되지 않은 경우 드라이버는 기본적으로 ORCL SID에 연결을 시도합니다. |
| SID(SID) | 없음 SID, 서비스 이름 또는 TNSNames 옵션에 대해 값이 지정되지 않은 경우 드라이버는 기본적으로 ORCL SID에 연결을 시도합니다. |
| SSLLibName(SLN) | 빈 문자열 |
| SupportBinaryXML(SBX) | 0(사용 안 함) |
| TimestampEscapeMapping(TEM) | 0(Oracle 버전별) |
| TNSNamesFile(TNF) | 없음 SID, 서비스 이름 또는 TNSNames 옵션에 대해 값이 지정되지 않은 경우 드라이버는 기본적으로 ORCL SID에 연결을 시도합니다. |
| Truststore(TS) | None |
| TruststorePassword(TSP) | None |
| UseCurrentSchema(UCS) | 1(사용) |
| UseDefaultEncryptionOptions | 1(사용) |
| ValidateServerCertificate(VSC) | 1(사용) |
| WireProtocolMode(WPM) | 2 |
Teradata
Teradata 커넥터 구성 옵션에서 제공된 커넥터 구성 옵션에 항목이 있는 키-값 쌍만 지정할 수 있습니다.
Cosmos DB용 MongoDB API
아래 드라이버 구성 옵션에 항목이 있는 키-값 쌍만 지정할 수 있습니다.
| 키 이름 | 기본값 | 필수 | 설명 |
|---|---|---|---|
| DefaultStringColumnLength | 255 | No | STRING 열에 포함될 수 있는 최대 문자 수입니다. 이 옵션에 대해 설정할 수 있는 최댓값은 2147483647입니다. |
| noCursorTimeout | False | 예 | 이 옵션은 드라이버에서 데이터 원본 서버의 활성 커서가 만료되도록 허용할지 여부를 지정합니다. FALSE이면 데이터 원본 서버는 서버에 설정된 임계값 비활성 기간 후에 유휴 커서를 시간이 초과시킵니다. TRUE로 설정하면 드라이버는 데이터 원본 서버에서 유휴 커서를 시간 초과시키지 못하므로, 드라이버가 예기치 않게 서버에 대한 연결을 종료하거나 끊어야 하는 경우 서버에서 커서가 무기한 열려 있을 위험이 있습니다. MongoDB 서버에서 유휴 커서 시간 제한에 대한 임계값을 조정할 수 있습니다. 자세한 내용은 https://docs.mongodb.com/v3.0/reference/parameters/ 자료를 참조하세요. |
| SamplingLimit | 100 | 아니요 | 드라이버가 임시 스키마 정의를 생성하기 위해 샘플링할 수 있는 최대 레코드 수입니다. 이 옵션을 0으로 설정하면 드라이버는 데이터베이스의 모든 문서를 샘플합니다. 필요한 모든 데이터를 샘플링하도록 드라이버를 구성해야 합니다. 샘플링되지 않은 문서는 스키마 정의에 포함되지 않으므로 ODBC 애플리케이션에서 사용할 수 없게 됩니다. 일반적으로 많은 문서를 샘플링하면 더 정확하고 데이터베이스의 모든 데이터를 더 잘 나타낼 수 있는 스키마 정의가 생성됩니다. 그러나 많은 문서를 샘플링할 때, 특히 데이터베이스에 복잡한 중첩된 데이터 구조가 포함된 경우 샘플링 프로세스가 예상보다 오래 걸릴 수 있습니다. |
| SamplingStrategy | 앞으로 | 예 | 이 옵션은 임시 스키마 정의를 생성할 때 드라이버가 데이터를 샘플링하는 방법을 지정합니다. 앞으로: 드라이버는 데이터베이스의 첫 번째 레코드에서 시작하는 데이터를 샘플링하고, 다음 레코드를 샘플링하는 등의 작업을 수행합니다. 뒤로: 드라이버는 데이터베이스의 마지막 레코드에서 시작하는 데이터를 샘플링한 다음 이전 레코드를 샘플하는 등의 작업을 수행합니다. 임의: 드라이버는 SamplingLimit에 도달할 때까지 임의로 데이터 원본에서 샘플 레코드를 선택합니다. |
| SSL | Clear(0) | 예 | 이 옵션은 드라이버가 SSL을 사용하여 서버에 연결하는지 여부를 지정합니다. 사용(1): 드라이버는 SSL을 사용하여 서버에 연결합니다. 사용 안 함(0): 드라이버는 SSL을 사용하여 서버에 연결하지 않습니다. |
일반 ODBC
PolyBase 일반 ODBC 외부 데이터 원본에 대해 지정할 수 있는 유효한 CONNECTION_OPTIONS는 드라이버별로 다릅니다. Microsoft에서 제공하는 ODBC 공급자를 사용하지 않는 경우(이전 섹션 참조) 드라이버 설명서에서 유효한 키-값 쌍을 참조하세요.
PolyBase에는 모든 일반 ODBC 드라이버에서 사용할 수 있는 몇 가지 유효한 키-값 쌍이 있습니다. CU5에서 SQL Server 2019에 다음 키가 추가되었습니다.
| 키 | 가능한 값 | 설명 |
|---|---|---|
| PolyBaseOdbcSupportsRowCount | true, FALSE | 드라이버가 ODBC 카탈로그 함수에서 호출되는 SQLRowCount 함수를 지원하는지 여부를 나타냅니다. 기본값은 false입니다. 예: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE' |
| PolyBaseOdbcSupportsMetadataIdAttributes | true, FALSE | 드라이버가 METADATA_ID 문 특성 설정을 지원하는지 여부를 나타냅니다. 기본값은 false입니다. 예: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE' |
| PolyBaseOdbcSupportsBindOffset | true, FALSE | 드라이버가 결과 집합의 행 단위 바인딩에 대한 바인딩 오프셋을 지원하는지 여부를 나타냅니다. 그렇지 않은 경우 열 바인딩을 사용합니다. 기본값은 false입니다. 예: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE' |
| PolyBaseQoTopPushdownSyntax | TOP, LIMIT | TOP 연산자를 백 엔드로 푸시하는 방법을 지정하는 정보를 포함합니다. 기본값은 빈 문자열로, TOP 푸시다운에 대한 지원이 없음을 나타냅니다. 사용자가 TOP을 지정하는 경우 top {0}이 형식 문자열로 사용됩니다. 사용자가 LIMIT을 지정하는 경우 limit {0}가 형식 문자열로 사용됩니다. 이 구현은 드라이버에 따라 다릅니다. 외부 데이터 원본 및/또는 드라이버 설명서를 참조하세요. 예: CONNECTION_OPTIONS= PolyBaseQoTopPushdownSyntax=TOP' |