적용 대상:
SQL Server 2016(13.x) 이상 Azure SQL 데이터베이스Azure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)
이 문서에서는 공급자에 CONNECTION_OPTIONS 따라 추가 세부 정보를 제공합니다.
CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS 인수는 외부 데이터 공급자에 따라 달라질 수 있습니다.
CONNECTION_OPTIONS
CREATE EXTERNAL DATA SOURCE에 대한 인수는 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를 사용하는 특성 집합이므로 지원되지 않습니다.
비고
PolyBase는 Microsoft ODBC 드라이버 버전 17 및 18만 지원합니다. 자세한 내용은 PolyBase에 대한 SQL Server 드라이버 버전 변경을 참조하세요.
Microsoft OLE DB 공급자에 대한 연결 문자열 키워드 및 옵션:
Microsoft OLE DB Driver for SQL Server: OLE DB Driver for SQL Server에서 연결 문자열 키워드 사용
SQL Server Native Client에서 연결 문자열 키워드를 사용하는 SQL Native Client(사용되지 않음)
Microsoft ODBC DB 공급자에 대한 연결 문자열 키워드 및 옵션:
- Microsoft ODBC Driver for SQL Server: DSN 및 연결 문자열 키워드 및 특성
- SQL Native Client(사용되지 않음) ODBC 드라이버 연결 문자열 키워드
오라클
다음과 같이 Oracle 유선 프로토콜 테이블에 항목이 있는 키-값 쌍만 지정할 수 있습니다.
| 특성(짧은 이름) | 기본값 |
|---|---|
| AccountingInfo(AI) | 없음 |
| 작업(ACT) | 없음 |
| AlternateServers(ASRV) | 없음 |
| AllowedOpenSSLVersions(AOV) | 최신 |
| ApplicationName(AN) | 없음 |
| 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) | 없음 |
| BulkLoadOptions(BLO) | 0 |
| BulkLoadRecordDelimiter(BLRD) | 없음 |
| CachedCursorLimit(CCL) | 32 |
| CachedDescriptionLimit(CDL) | 0 |
| CatalogIncludesSynonyms(CIS) | 1(사용) |
| CatalogOptions(CO) | 0(사용 안 함) |
| ClientHostName(CHN) | 없음 |
| ClientID(CID) | 없음 |
| ClientUser(CU) | 없음 |
| ConnectionReset(CR) | 0(사용 안 함) |
| ConnectionRetryCount(CRC) | 0 |
| ConnectionRetryDelay(CRD) | 3 |
| CredentialsWalletEntry(CWE) | 없음 |
| CredentialsWalletPassword(CWPWD) | 없음 |
| CredentialsWalletPath(CWPATH) | 없음 |
| CryptoProtocolVersion(CPV) | TLSv1.2,TLSv1.1,TLSv1 |
| CryptoLibName(CLN) | 빈 문자열 |
| DataIntegrityLevel(DIL) | 1(수락됨) |
| DATAIntegrityTypes(DIT) | MD5, SHA1, SHA256, SHA384, SHA512 |
| DataSourceName(DSN) | 없음 |
| DefaultLongDataBuffLen(DLDBL) | 1024 |
| DescribeAtPrepare(DAP) | 0(사용 안 함) |
| 설명(n/a) | 없음 |
| EditionName(EN) | 없음 |
| EnableBulkLoad(EBL) | 0(사용 안 함) |
| EnableDescribeParam(EDP) | 0(사용 안 함) |
| ENS(EnableNcharSupport)(사용되지 않음) | 없음 |
| EnableScrollableCursors(ESC) | 1(사용) |
| EnableServerResultCache(ESRC) | 0(사용 안 함) |
| EnableStaticCursorsForLongData(ESCLD) | 0(사용 안 함) |
| ETWT(EnableTimestampwithTimezone)(사용되지 않음) | 없음 |
| EncryptionLevel(EL) | 1(수락됨) |
| EncryptionMethod(EM) | 0(암호화 없음) |
| EncryptionTypes(ET) | 암호화 방법이 지정되지 않았습니다. 드라이버는 모든 암호화 방법 목록을 Oracle 서버로 보냅니다. |
| FailoverGranularity(FG) | 0(비원자) |
| FailoverMode(FM) | 0(연결) |
| FP(FailoverPreconnect) | 0(사용 안 함) |
| FetchTSWTZasTimestamp(FTSWTZAT) | 0(사용 안 함) |
| GSSClient(GSSC) | 원주민 |
| HostName(HOST) | 없음 |
| HostNameInCertificate(HNIC) | 없음 |
| IANAAppCodePage(IACP)(UNIX 및 Linux에만 해당) | 4(ISO 8559-1 Latin-1) |
| ImpersonateUser(IU) | 없음 |
| InitializationString(IS) | 없음 |
| KeepAlive(KA) | 0(사용 안 함) |
| KeyPassword(KP) | 없음 |
| KS(키 저장소) | 없음 |
| KSP(KeystorePassword) | 없음 |
| LDAPDistinguishedName(LDAPDN) | 없음 |
| LoadBalanceTimeout(LBT) | 0 |
| LoadBalancing(LB) | 0(사용 안 함) |
| LOBPrefetchSize(LPS) | 4000 |
| LocalTimezoneOffset(LTZO) | ""(빈 문자열) |
| LockTimeout(LTO) | -1 |
| LoginTimeout(LT) | 15 |
| LogonID(UID) | 없음 |
| MaxPoolSize(MXPS) | 100 |
| MinPoolSize(MNPS) | 0 |
| 모듈(MOD) | 없음 |
| 암호(PWD) | 없음 |
| 풀링(풀) | 0(사용 안 함) |
| PortNumber(PORT) | 없음 |
| PSF(PRNGSeedFile)(UNIX 및 Linux에만 해당) | /dev/random |
| PSS(PRNGSeedSource)(UNIX 및 Linux에만 해당) | 0(파일) |
| ProcedureRetResults(PRR) | 0(사용 안 함) |
| ProgramID(PID) | 없음 |
| ProxyHost(PXHN) | 빈 문자열 |
| ProxyMode(PXM) | 0(NONE) |
| ProxyPassword(PXPW) | 빈 문자열 |
| ProxyPort(PXPT) | 0 |
| ProxyUser(PXU) | 빈 문자열 |
| QueryTimeout(QT) | 0 |
| ReportCodepageConversionErrors(RCCE) | 0(오류 무시) |
| ReportRecycleBin(RRB) | 0(사용 안 함) |
| SDUSize(SDU) | 16384 |
| ServerName(SRVR) | 없음 |
| 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에 연결을 시도합니다. |
| TS(Truststore) | 없음 |
| TSP(TruststorePassword) | 없음 |
| USECurrentSchema(UCS) | 1(사용) |
| UseDefaultEncryptionOptions | 1(사용) |
| ValidateServerCertificate(VSC) | 1(사용) |
| WireProtocolMode(WPM) | 2 |
Teradata
Teradata 커넥터 구성 옵션에 제공된 커넥터 구성 옵션에 항목이 있는 키-값 쌍만 지정할 수 있습니다.
Cosmos DB용 MongoDB API
다음 드라이버 구성 옵션에 항목이 있는 키-값 쌍만 지정할 수 있습니다.
| 키 이름 | 기본값 | 필수 | 설명 |
|---|---|---|---|
DefaultStringColumnLength |
255 | 아니오 | 열에 STRING 포함할 수 있는 최대 문자 수입니다. 이 옵션에 대해 설정할 수 있는 최대값은 2147483647. |
noCursorTimeout |
거짓 | 아니오 | 이 옵션은 드라이버에서 데이터 원본 서버의 활성 커서가 만료되도록 허용할지 여부를 지정합니다. 이 경우 FALSE데이터 원본 서버는 서버에 설정된 임계값 비활성 기간 후에 유휴 커서를 시간 초과합니다. 설정 TRUE하면 드라이버가 데이터 원본 서버에서 유휴 커서의 타이밍을 초과하지 못하게 하고, 드라이버가 예기치 않게 서버에 대한 연결을 종료하거나 끊어야 하는 경우 서버에서 커서가 무기한 열려 있을 위험이 있습니다. MongoDB 서버에서 유휴 커서 시간 제한에 대한 임계값을 조정할 수 있습니다. 자세한 내용은 Self-Managed 배포에 대한 MongoDB 서버 매개 변수 를 참조하세요. |
SamplingLimit |
100 | 아니오 | 드라이버가 임시 스키마 정의를 생성하기 위해 샘플링할 수 있는 최대 레코드 수입니다. 이 옵션을 0으로 설정하면 드라이버는 데이터베이스의 모든 문서를 샘플링합니다. 필요한 모든 데이터를 샘플링하도록 드라이버를 구성해야 합니다. 샘플링되지 않은 문서는 스키마 정의에 포함되지 않으므로 ODBC 애플리케이션에서 사용할 수 없게 됩니다. 일반적으로 많은 수의 문서를 샘플링하면 더 정확하고 데이터베이스의 모든 데이터를 더 잘 나타낼 수 있는 스키마 정의가 생성됩니다. 그러나 많은 문서를 샘플링할 때, 특히 데이터베이스에 복잡한 중첩된 데이터 구조가 포함된 경우 샘플링 프로세스가 예상보다 오래 걸릴 수 있습니다. |
SamplingStrategy |
전달 | 아니오 | 이 옵션은 임시 스키마 정의를 생성할 때 드라이버가 데이터를 샘플링하는 방법을 지정합니다. 전달: 드라이버는 데이터베이스의 첫 번째 레코드에서 시작하는 데이터를 샘플링한 다음, 다음 레코드를 샘플링하는 등의 작업을 수행합니다. 뒤로: 드라이버는 데이터베이스의 마지막 레코드에서 시작하는 데이터를 샘플링한 다음 이전 레코드를 샘플링하는 등의 작업을 수행합니다. 임의: 드라이버는 SamplingLimit에 도달할 때까지 데이터 원본에서 샘플 레코드를 임의로 선택합니다. |
SSL |
지우기(0) |
아니오 | 이 옵션은 드라이버가 SSL을 사용하여 서버에 연결할지 여부를 지정합니다. 사용 (1): 드라이버는 SSL을 사용하여 서버에 연결합니다. 사용 안 함 (0): 드라이버는 SSL을 사용하여 서버에 연결하지 않습니다. |
일반 ODBC
CONNECTION_OPTIONS PolyBase 제네릭 ODBC 외부 데이터 원본에 대해 지정할 수 있는 것은 드라이버에 따라 다릅니다. 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 지원이 없음을 나타내는 빈 문자열입니다. 사용자가 지정 TOPtop {0} 하는 경우 형식 문자열로 사용됩니다. 사용자가 지정 LIMITlimit {0} 하는 경우 형식 문자열로 사용됩니다. 이 구현은 드라이버 관련이며 외부 데이터 원본 및/또는 드라이버 설명서를 참조하세요. 예: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'. |