Delen via


CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

van toepassing op: SQL Server 2016 (13.x) en hoger Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

In dit artikel vindt u aanvullende informatie, CONNECTION_OPTIONS afhankelijk van de provider. Het argument CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS kan variëren, afhankelijk van de externe gegevensprovider.

Het argument voor CONNECTION_OPTIONS is voor het eerst geïntroduceerd in SQL Server 2019 (15.x). Dit document is van toepassing op SQL Server 2019 (15.x) voor Windows en Linux, evenals OP SQL Server 2019 Big Data Clusters.

  • Het key_value_pair is het trefwoord en de waarde voor een specifieke verbindingsoptie.
  • Als u meerdere verbindingsopties wilt gebruiken, scheidt u deze door een puntkomma.
  • Mogelijke sleutel-waardeparen zijn specifiek voor het stuurprogramma.

De rest van dit artikel bevat leverancierspecifieke verbindingsopties.

Externe SQL Server-gegevensbron

U kunt alleen de sleutel-waardeparen opgeven die een vermelding hebben in DSN- en verbindingsreekstrefwoorden en -kenmerken onder de kolom DSN/Trefwoord voor verbindingsreeks . Het trefwoord wordt bijvoorbeeld SQL_ATTR_TXN_ISOLATION niet ondersteund, omdat dat een kenmerkset is met behulp van SQLSetConnectAttr, niet in de verbindingsreeks.

Opmerking

PolyBase ondersteunt alleen het Microsoft ODBC-stuurprogramma versie 17 en 18. Zie De versie van het SQL Server-stuurprogramma voor PolyBase wijzigen voor meer informatie.

Orakel

U kunt alleen de sleutel-waardeparen opgeven die een vermelding hebben in de tabel Oracle Wire Protocol als volgt:

Kenmerk (korte naam) Verstek
AccountingInfo (AI) Geen
Actie (ACT) Geen
AlternateServers (ASRV) Geen
AllowedOpenSSLVersions (AOV) nieuwste
ApplicationName (AN) Geen
ApplicationUsingThreads (AUT) 1 (ingeschakeld)
Matricesize (AS) 60000
AuthenticationMethod (AM) 1 (Wachtwoord versleutelen)
BatchFailureReturnsError (BFRE) 0 (uitgeschakeld)
BindParamsAsUnicode (BPAU) 0 (uitgeschakeld)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Geen
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Geen
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (ingeschakeld)
CatalogOptions (CO) 0 (uitgeschakeld)
ClientHostName (CHN) Geen
ClientID (CID) Geen
ClientUser (CU) Geen
ConnectionReset (CR) 0 (uitgeschakeld)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Geen
CredentialsWalletPassword (CWPWD) Geen
CredentialsWalletPath (CWPATH) Geen
CryptoProtocolVersion (CPV) TLSv1.2, TLSv1.1, TLSv1
CryptoLibName (CLN) Lege tekenreeks
DataIntegrityLevel (DIL) 1 (Geaccepteerd)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Geen
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (uitgeschakeld)
Beschrijving (n/a) Geen
EditionName (EN) Geen
EnableBulkLoad (EBL) 0 (uitgeschakeld)
EnableDescribeParam (EDP) 0 (uitgeschakeld)
EnableNcharSupport (ENS) (afgeschaft.) Geen
EnableScrollableCursors (ESC) 1 (ingeschakeld)
EnableServerResultCache (ESRC) 0 (uitgeschakeld)
EnableStaticCursorsForLongData (ESCLD) 0 (uitgeschakeld)
EnableTimestampwithTimezone (ETWT) (afgeschaft) Geen
EncryptionLevel (EL) 1 (Geaccepteerd)
EncryptionMethod (EM) 0 (geen versleuteling)
EncryptionTypes (ET) Er zijn geen versleutelingsmethoden opgegeven. Het stuurprogramma verzendt een lijst met alle versleutelingsmethoden naar de Oracle-server.
FailoverGranularity (FG) 0 (niet-atomisch)
FailoverMode (FM) 0 (verbinding)
FailoverPreconnect (FP) 0 (uitgeschakeld)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (uitgeschakeld)
GSSClient (GSSC) inheems
HostNaam (HOST) Geen
HostNameInCertificate (HNIC) Geen
IANAAppCodePage (IACP) (alleen UNIX en Linux) 4 (ISO 8559-1 Latijns-1)
IU (imitateUser) Geen
InitializationString (IS) Geen
KeepAlive (KA) 0 (uitgeschakeld)
KeyPassword (KP) Geen
Sleutelarchief (KS) Geen
KeystorePassword (KSP) Geen
LDAPDistinguishedName (LDAPDN) Geen
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (uitgeschakeld)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (lege tekenreeks)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
Aanmeldings-id (UID) Geen
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Module (MOD) Geen
Wachtwoord (PWD) Geen
Pooling (POOL) 0 (uitgeschakeld)
PortNumber (PORT) Geen
PRNGSeedFile (PSF) (alleen UNIX en Linux) /dev/random
PRNGSeedSource (ALLEEN PSS) (UNIX en Linux) 0 (bestand)
ProcedureRetResults (PRR) 0 (uitgeschakeld)
ProgramID (PID) Geen
ProxyHost (PXHN) Lege tekenreeks
ProxyMode (PXM) 0 (GEEN)
ProxyPassword (PXPW) Lege tekenreeks
ProxyPort (PXPT) 0
ProxyUser (PXU) Lege tekenreeks
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Fouten negeren)
ReportRecycleBin (RRB) 0 (uitgeschakeld)
SDUSize (SDU) 16384
Servernaam (SRVR) Geen
ServerType (ST) 0 (standaardserver)
ServiceName (SN) Geen. Als er geen waarde is opgegeven voor de optie SID, Service Name of TNSNames, probeert het stuurprogramma standaard verbinding te maken met de ORCL-SID.
SID (SID) Geen. Als er geen waarde is opgegeven voor de optie SID, Service Name of TNSNames, probeert het stuurprogramma standaard verbinding te maken met de ORCL-SID.
SSLLibName (SLN) Lege tekenreeks
SupportBinaryXML (SBX) 0 (uitgeschakeld)
TimestampEscapeMapping (TEM) 0 (Oracle Version Specific)
TNSNamesFile (TNF) Geen. Als er geen waarde is opgegeven voor de optie SID, Service Name of TNSNames, probeert het stuurprogramma standaard verbinding te maken met de ORCL-SID.
Truststore (TS) Geen
TruststorePassword (TSP) Geen
UseCurrentSchema (UCS) 1 (ingeschakeld)
UseDefaultEncryptionOptions 1 (ingeschakeld)
ValidateServerCertificate (VSC) 1 (ingeschakeld)
WireProtocolMode (WPM) 2

Teradata

U kunt alleen de sleutel-waardeparen opgeven die een vermelding hebben in de configuratieopties van de connector die zijn opgegeven in de configuratieopties van de Teradata-connector.

MongoDB-API voor Cosmos DB

U kunt alleen de sleutel-waardeparen opgeven die een vermelding hebben in de volgende stuurprogrammaconfiguratieopties.

Sleutelnaam Verstek Verplicht Beschrijving
DefaultStringColumnLength 255 Nee. Het maximum aantal tekens dat in STRING kolommen kan worden opgenomen. De maximumwaarde die u voor deze optie kunt instellen, is 2147483647.
noCursorTimeout Onwaar Nee. Met deze optie geeft u op of het stuurprogramma actieve cursors op de gegevensbronserver laat verlopen. Wanneer FALSE, treedt er een time-out op voor de gegevensbronserver na de inactiviteitsperiode van de drempelwaarde die is ingesteld op de server. Als deze optie is ingesteld TRUE, voorkomt het stuurprogramma dat de gegevensbronserver niet-actieve cursors uitvalt en er is een risico dat als het stuurprogramma de verbinding met de server onverwacht moet afsluiten of verliezen, de cursor voor onbepaalde tijd geopend blijft op de server. U kunt de drempelwaarde voor time-outs voor niet-actieve cursor op de MongoDB-server aanpassen. Zie MongoDB-serverparameters voor een Self-Managed-implementatie voor meer informatie.
SamplingLimit 100 Nee. Het maximum aantal records dat het stuurprogramma kan gebruiken om een tijdelijke schemadefinitie te genereren. Wanneer deze optie is ingesteld op 0, wordt elk document in de database door het stuurprogramma gebruikt.

Zorg ervoor dat u het stuurprogramma configureert om alle benodigde gegevens te samplen. Documenten die niet worden gesampleerd, worden niet opgenomen in de schemadefinitie en zijn dus niet beschikbaar in ODBC-toepassingen.
Normaal gesproken resulteert het nemen van een groot aantal documenten in een schemadefinitie die nauwkeuriger is en beter in staat is om alle gegevens in de database weer te geven. Het steekproefproces kan echter langer duren dan verwacht wanneer veel documenten worden bemonsterd, met name als de database complexe, geneste gegevensstructuren bevat.
SamplingStrategy Voorwaarts Nee. Met deze optie geeft u op hoe de gegevens van stuurprogramma's worden gebruikt bij het genereren van een tijdelijke schemadefinitie.

Doorsturen: de gegevens van de stuurprogrammavoorbeelden die beginnen vanaf de eerste record in de database, en vervolgens de volgende record, enzovoort.
Achterwaarts: de gegevens van de stuurprogramma's die beginnen met de laatste record in de database, en vervolgens de voorgaande record, enzovoort.
Willekeurig: Het stuurprogramma selecteert steekproefrecords uit de gegevensbron willekeurig totdat samplinglimit is bereikt.
SSL Wissen (0) Nee. Met deze optie geeft u op of het stuurprogramma SSL gebruikt om verbinding te maken met de server.

Ingeschakeld (1): Het stuurprogramma gebruikt SSL om verbinding te maken met de server.
Uitgeschakeld (0): Het stuurprogramma gebruikt geen SSL om verbinding te maken met de server.

Algemene ODBC

Geldig CONNECTION_OPTIONS dat u kunt opgeven voor PolyBase Generic ODBC External Data Source zijn stuurprogrammaspecifiek. Als u geen ODBC-provider van Microsoft gebruikt (zie de vorige sectie), raadpleegt u de documentatie van het stuurprogramma voor geldige sleutel-waardeparen.

Er zijn enkele geldige sleutel-waardeparen in PolyBase die beschikbaar zijn voor alle algemene ODBC-stuurprogramma's. De volgende sleutels zijn toegevoegd aan SQL Server 2019 in CU5.

Sleutelcode Mogelijke waarden Beschrijving
PolyBaseOdbcSupportsRowCount TRUE, FALSE Hiermee wordt aangegeven of het stuurprogramma de SQLRowCount-functie ondersteunt die wordt aangeroepen op ODBC-catalogusfuncties. De standaardwaarde is vals. Voorbeeld: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Geeft aan of het stuurprogramma ondersteuning biedt voor het instellen van het METADATA_ID instructiekenmerk. De standaardwaarde is vals. Voorbeeld: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Hiermee wordt aangegeven of het stuurprogramma bindings offsets ondersteunt voor rijgewijze binding van resultatensets. Als dat niet het is, gebruikt u kolombinding. De standaardwaarde is vals. Voorbeeld: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Bevat informatie die aangeeft hoe de operator naar de TOP back-end moet worden gepusht. De standaardwaarde is een lege tekenreeks die aangeeft dat er geen ondersteuning is voor TOP pushdown. Als de gebruiker opgeeft TOP, top {0} wordt deze gebruikt als de notatietekenreeks. Als de gebruiker opgeeft LIMIT, limit {0} wordt deze gebruikt als de notatietekenreeks. Deze implementatie is stuurprogrammaspecifiek, raadpleeg de externe gegevensbron en/of stuurprogrammadocumentatie. Voorbeeld: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.