Aracılığıyla paylaş


CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

Şunlar için geçerlidir: SQL Server 2016 (13.x) ve sonraki sürümleri Azure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse Analytics AnalyticsPlatform Sistemi (PDW)

Bu makalede, sağlayıcıya bağlı olarak için CONNECTION_OPTIONS ek ayrıntılar sağlanır. CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS bağımsız değişkeni, dış veri sağlayıcısına bağlı olarak değişebilir.

CONNECTION_OPTIONS CREATE EXTERNAL DATA SOURCE bağımsız değişkeni ilk olarak SQL Server 2019'da (15.x) tanıtıldı. Bu belge, Windows ve Linux için SQL Server 2019 (15.x) ve SQL Server 2019 Büyük Veri Kümeleri için geçerlidir.

  • key_value_pair, belirli bir bağlantı seçeneğinin anahtar sözcüğü ve değeridir.
  • Birden çok bağlantı seçeneği kullanmak için bunları noktalı virgülle ayırın.
  • Olası anahtar değer çiftleri sürücüye özgüdür.

Bu makalenin geri kalanında satıcıya özgü bağlantı seçenekleri yer alır.

SQL Server dış veri kaynağı

DSN/Bağlantı Dizesi Anahtar Sözcüğü sütunu altında yalnızca DSN ve Bağlantı Dizesi Anahtar Sözcükleri ve Özniteliklerinde girişi olan anahtar-değer çiftlerini belirtebilirsiniz. Örneğin, bağlantı dizesinde SQL_ATTR_TXN_ISOLATION değil SQLSetConnectAttr kullanan bir öznitelik kümesi olduğundan anahtar sözcüğü desteklenmez.

Uyarı

PolyBase yalnızca Microsoft ODBC Sürücüsü sürüm 17 ve 18'i destekler. Daha fazla bilgi için bkz. PolyBase için SQL Server sürücü sürümünü değiştirme.

Oracle

Yalnızca Oracle wire protocol tablosunda girişi olan anahtar-değer çiftlerini aşağıdaki gibi belirtebilirsiniz:

Öznitelik (Kısa Ad) Varsayılan
AccountingInfo (AI) Hiç kimse
Eylem (ACT) Hiç kimse
AlternateServers (ASRV) Hiç kimse
AllowedOpenSSLVersions (AOV) en yeni
ApplicationName (AN) Hiç kimse
ApplicationUsingThreads (AUT) 1 (Etkinleştirilmiş)
ArraySize (AS) 60000
AuthenticationMethod () 1 (Parolayı Şifrele)
BatchFailureReturnsError (BFRE) 0 (Devre Dışı)
BindParamsAsUnicode (BPAU) 0 (Devre Dışı)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Hiç kimse
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Hiç kimse
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (Etkinleştirilmiş)
CatalogOptions (CO) 0 (Devre Dışı)
ClientHostName (CHN) Hiç kimse
ClientID (CID) Hiç kimse
ClientUser (CU) Hiç kimse
ConnectionReset (CR) 0 (Devre Dışı)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Hiç kimse
CredentialsWalletPassword (CWPWD) Hiç kimse
CredentialsWalletPath (CWPATH) Hiç kimse
CryptoProtocolVersion (CPV) TLSv1.2, TLSv1.1, TLSv1
CryptoLibName (CLN) Boş dize
DataIntegrityLevel (DIL) 1 (Kabul Edildi)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Hiç kimse
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (Devre Dışı)
Açıklama (yok) Hiç kimse
EditionName (EN) Hiç kimse
EnableBulkLoad (EBL) 0 (Devre Dışı)
EnableDescribeParam (EDP) 0 (Devre Dışı)
EnableNcharSupport (ENS) (kullanım dışı.) Hiç kimse
EnableScrollableCursors (ESC) 1 (Etkinleştirilmiş)
EnableServerResultCache (ESRC) 0 (Devre Dışı)
EnableStaticCursorsForLongData (ESCLD) 0 (Devre Dışı)
EnableTimestampwithTimezone (ETWT) (kullanım dışı) Hiç kimse
EncryptionLevel (EL) 1 (Kabul Edildi)
EncryptionMethod (EM) 0 (Şifreleme Yok)
EncryptionTypes (ET) Hiçbir şifreleme yöntemi belirtilmedi. Sürücü tüm şifreleme yöntemlerinin listesini Oracle sunucusuna gönderir.
Yük DevretmeKulluluk (FG) 0 (Atomik Olmayan)
FailoverMode (FM) 0 (Bağlantı)
Yük DevretmeBağlant (FP) 0 (Devre Dışı)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (Devre Dışı)
GSSClient (GSSC) yerel
HostName (HOST) Hiç kimse
HostNameInCertificate (HNIC) Hiç kimse
IANAAppCodePage (IACP) (yalnızca UNIX ve Linux) 4 (ISO 8559-1 Latin-1)
ImpersonateUser (IU) Hiç kimse
InitializationString (IS) Hiç kimse
KeepAlive (KA) 0 (Devre Dışı)
KeyPassword (KP) Hiç kimse
Keystore (KS) Hiç kimse
KeystorePassword (KSP) Hiç kimse
LDAPDistinguishedName (LDAPDN) Hiç kimse
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (Devre Dışı)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (Boş Dize)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
LogonID (UID) Hiç kimse
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Modül (MOD) Hiç kimse
Parola (PWD) Hiç kimse
Havuz (HAVUZ) 0 (Devre Dışı)
PortNumber (PORT) Hiç kimse
PRNGSeedFile (PSF) (yalnızca UNIX ve Linux) /dev/random
PRNGSeedSource (PSS) (yalnızca UNIX ve Linux) 0 (Dosya)
ProcedureRetResults (PRR) 0 (Devre Dışı)
ProgramID (PID) Hiç kimse
ProxyHost (PXHN) Boş dize
ProxyMode (PXM) 0 (YOK)
ProxyPassword (PXPW) Boş dize
ProxyPort (PXPT) 0
ProxyUser (PXU) Boş dize
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Hataları Yoksay)
ReportRecycleBin (RRB) 0 (Devre Dışı)
SDUSize (SDU) 16384
ServerName (SRVR) Hiç kimse
ServerType (ST) 0 (Sunucu Varsayılanı)
ServiceName (SN) Yok. SID, Hizmet Adı veya TNSNames seçeneği için değer belirtilmezse, sürücü varsayılan olarak ORCL SID'sine bağlanmayı dener.
SID (SID) Yok. SID, Hizmet Adı veya TNSNames seçeneği için değer belirtilmezse, sürücü varsayılan olarak ORCL SID'sine bağlanmayı dener.
SSLLibName (SLN) Boş dize
SupportBinaryXML (SBX) 0 (Devre Dışı)
TimestampEscapeMapping (TEM) 0 (Oracle Sürümüne Özgü)
TNSNamesFile (TNF) Yok. SID, Hizmet Adı veya TNSNames seçeneği için değer belirtilmezse, sürücü varsayılan olarak ORCL SID'sine bağlanmayı dener.
Truststore (TS) Hiç kimse
TruststorePassword (TSP) Hiç kimse
UseCurrentSchema (UCS) 1 (Etkinleştirilmiş)
UseDefaultEncryptionOptions 1 (Etkinleştirilmiş)
ValidateServerCertificate (VSC) 1 (Etkinleştirilmiş)
WireProtocolMode (WPM) 2

Teradata

Yalnızca Teradata Bağlayıcı Yapılandırma Seçenekleri'nde sağlanan bağlayıcı yapılandırma seçeneklerinde girişi olan anahtar-değer çiftlerini belirtebilirsiniz.

Cosmos DB için MongoDB API'si

Yalnızca aşağıdaki sürücü yapılandırma seçeneklerinde girişi olan anahtar-değer çiftlerini belirtebilirsiniz.

Anahtar adı Varsayılan Gerekli Açıklama
DefaultStringColumnLength İki yüz elli beş Hayı Sütunlarda STRING bulunabilecek karakter sayısı üst sınırı. Bu seçenek için ayarlayabileceğiniz en yüksek değer 2147483647.
noCursorTimeout Yanlış Hayı Bu seçenek, sürücünün veri kaynağı sunucusundaki etkin imleçlerin süresinin dolmasına izin verip vermediğini belirtir. olduğunda FALSE, veri kaynağı sunucusu sunucuda ayarlanan eşik etkinliksizlik süresinden sonra boştaki imleçlerin zaman aşımına uğramasını sağlar. olarak ayarlandığında TRUE, sürücü veri kaynağı sunucusunun boştaki imleçlerin zaman aşımına uğramasını engeller ve sürücü beklenmedik bir şekilde sunucu bağlantısını kapatması veya bağlantısını kaybetmesi durumunda imlecin sunucuda süresiz olarak açık kalması riski vardır. MongoDB sunucusunda boşta imleç zaman aşımları eşiğini ayarlayabilirsiniz. Ayrıntılar için bkz. Self-Managed Dağıtımı için MongoDB Sunucu Parametreleri .
SamplingLimit 100 Hayı Sürücünün geçici şema tanımı oluşturmak için örnekleyebileceği en fazla kayıt sayısı. Bu seçenek 0 olarak ayarlandığında, sürücü veritabanındaki tüm belgeleri örnekler.

Gerekli tüm verileri örneklemek için sürücüyü yapılandırdığından emin olun. Örneklenmemiş belgeler şema tanımına dahil değildir ve bu nedenle ODBC uygulamalarında kullanılamaz.
Genellikle çok sayıda belgenin örneklemesi, veritabanındaki tüm verileri daha doğru ve daha iyi temsil edebilen bir şema tanımıyla sonuçlanır. Ancak, özellikle veritabanı karmaşık, iç içe veri yapıları içeriyorsa, birçok belge örneklendiğinde örnekleme işlemi beklenenden uzun sürebilir.
SamplingStrategy İleri Hayı Bu seçenek, sürücünün geçici bir şema tanımı oluştururken verileri nasıl örnekleyeceğini belirtir.

İlet: Sürücü, veritabanındaki ilk kayıttan başlayarak verileri örnekler, sonra da sonraki kaydı örnekler.
Geri: Sürücü, veritabanındaki son kayıttan başlayarak verileri örnekler, ardından önceki kaydı örnekler ve benzeri.
Rastgele: Sürücü, SampleLimit'e ulaşılana kadar veri kaynağından rastgele örnek kayıtları seçer.
SSL Temizle (0) Hayı Bu seçenek, sürücünün sunucuya bağlanmak için SSL kullanıp kullanmadığını belirtir.

Etkin (1): Sürücü sunucuya bağlanmak için SSL kullanır.
Devre dışı (0): Sürücü sunucuya bağlanmak için SSL kullanmaz.

Genel ODBC

PolyBase Genel ODBC Dış Veri Kaynağı için belirtebileceğiniz geçerli CONNECTION_OPTIONS sürücüye özeldir. Microsoft tarafından sağlanan bir ODBC sağlayıcısı kullanmıyorsanız (önceki bölüme bakın), geçerli anahtar-değer çiftleri için sürücünün belgelerine bakın.

PolyBase'de tüm genel ODBC sürücüleri tarafından kullanılabilen bazı geçerli anahtar-değer çiftleri vardır. CU5'te SQL Server 2019'a aşağıdaki anahtarlar eklendi.

Anahtar Olası değerler Açıklama
PolyBaseOdbcSupportsRowCount TRUE, FALSE Sürücünün ODBC katalog işlevlerinde çağrılan SQLRowCount işlevini destekleyip desteklemediğini gösterir. Varsayılan değer false'tur. Örneğin: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Sürücünün deyim özniteliğini ayarlamayı METADATA_ID destekleyip desteklemediğini gösterir. Varsayılan değer false'tur. Örneğin: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Sürücünün sonuç kümelerinin satır başına bağlaması için bağlama uzaklıklarını destekleyip desteklemediğini gösterir. Aksi takdirde sütun bağlamayı kullanın. Varsayılan değer false'tur. Örneğin: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT İşleci arka uçtan aşağı TOP itmeyi belirten bilgileri içerir. Varsayılan değer boş bir dizedir ve aşağı itme desteğinin TOP eksik olduğunu gösterir. Kullanıcı belirtirseTOPtop {0}, biçim dizesi olarak kullanılır. Kullanıcı belirtirseLIMITlimit {0}, biçim dizesi olarak kullanılır. Bu uygulama sürücüye özgüdür, dış veri kaynağına ve/veya sürücü belgelerine başvurun. Örneğin: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.