Ondersteunde verbindingseigenschappen

In dit artikel worden de verbindingseigenschappen beschreven die worden ondersteund door het Databricks JDBC-stuurprogramma, versie 3 en hoger.

Verificatie-eigenschappen

De volgende verificatie-eigenschappen worden ondersteund door het Databricks JDBC-stuurprogramma. Zie Verificatie-instellingen voor het Databricks JDBC-stuurprogramma voor meer informatie over het configureren van elke verificatiemethode. Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
AuthMech Verplicht Het verificatiemechanisme, waarbij 3 het mechanisme aangeeft, is een Azure Databricks persoonlijk toegangstoken en 11 geeft het mechanisme OAuth 2.0-tokens aan. Er zijn extra eigenschappen vereist voor elk mechanisme. Zie verificatie-instellingen voor het Databricks JDBC-stuurprogramma.
Auth_AccessToken null Een Azure Databricks OAuth-token of een JSON-webtoken (JWT) van een externe id-provider. Vereist wanneer Auth_Flow ( 0 token passthrough). Als u een extern IdP-token doorgeeft, Azure Databricks het omruilt voor een Azure Databricks token met behulp van tokenfederatie.
Auth_Flow 0 De OAuth2-verificatiestroom voor de stuurprogrammaverbinding. Deze eigenschap is vereist als AuthMech is 11. Geldige waarden zijn 0 (token passthrough), 1 (M2M-clientreferenties), 2 (U2M-browser) en 3 (Azure beheerde identiteit).
Auth_JWT_Alg RS256 Het algoritme voor JWT-verificatie met een persoonlijke sleutel. De ondersteunde algoritmen zijn: RSA: RS256, RS384, RS512, PS256, PS384, PS512 en EC: ES256, ES384, ES512
Auth_JWT_Key_File null Het pad naar het private-sleutelbestand (PEM-indeling) voor JWT-authenticatie.
Auth_JWT_Key_Passphrase null De wachtwoordzin voor het ontsleutelen van een versleutelde persoonlijke sleutel.
Auth_KID null De sleutel-id (KID) die is vereist voor JWT-verificatie. Dit is verplicht bij het gebruik van JWT met een persoonlijke sleutel.
Auth_RefreshToken null Het OAuth2-vernieuwingstoken dat wordt gebruikt om een nieuw toegangstoken op te halen.
Auth_Scope all-apis Het verificatiebereik voor OAuth2-stromen.
Azure_workspace_resource_id null De Azure resource-id van uw Azure Databricks werkruimte. Vereist wanneer Auth_Flow is 3 (Azure beheerde identiteit).
AzureTenantId null De Azure tenant-id voor Azure-specifieke verificatie. Vereist bij het gebruik van een Azure beheerde service-principal met Auth_Flow ingesteld op 1.
EnableOIDCDiscovery 1 Als deze optie is ingesteld op 1, wordt de OpenID Connect-detectie-URL gebruikt.
EnableTokenCache 1 Als deze optie is ingesteld 1, kunnen OAuth-tokens in de cache worden opgeslagen om de prestaties te verbeteren. Ingesteld op 0 afmelden voor tokencaching voor U2M-verificatie (Auth_Flow=2).
GoogleCredentialsFile null Het pad naar het JSON-sleutelbestand voor verificatie van google-serviceaccounts.
GoogleServiceAccount null Hiermee schakelt u verificatie in met behulp van een Google-serviceaccount.
OAuth2ClientId null De OAuth2-client-id voor verificatie. Vereist wanneer Auth_Flow ( 1 M2M). Stel dit in op de UUID of toepassings-id van de service-principal. Voor Auth_Flow3 (Azure beheerde identiteit) stelt u dit in op de Client-id (alleen vereist voor door de gebruiker toegewezen beheerde identiteiten). Voor U2M (Auth_Flow=2) databricks-sql-jdbc wordt standaard gebruikt.
OAuth2ConnAuthAuthorizeEndpoint null De URL van het autorisatie-eindpunt die wordt gebruikt in een OAuth2-stroom.
OAuth2ConnAuthTokenEndpoint null De eindpunt-URL van het token voor de OAuth2-stroom.
OAuth2RedirectUrlPort 8020 De omleidings-URL-poort voor OAuth2 voor verificatiestromen op basis van een browser.
OIDCDiscoveryEndpoint null De Detectie-URL van OpenID Connect voor het ophalen van de OIDC-configuratie.
OAuth2Secret null De OAuth-geheime waarde van de service-principal. Vereist wanneer Auth_Flow ( 1 M2M-clientreferenties).
TokenCachePassPhrase null De wachtwoordzin die moet worden gebruikt voor OAuth U2M-tokencacheversleuteling. Vereist wanneer Auth_Flow ( 2 U2M). Dit voorkomt herhaalde verificaties op basis van een browser door referenties in de cache op te cachen.
UID null De gebruikersnaam voor verificatie. Vereist wanneer AuthMech ( 3 persoonlijk toegangstoken). Stel dit in op de letterlijke tekenreeks token.
PWD of password null Het wachtwoord voor verificatie. Vereist wanneer AuthMech ( 3 persoonlijk toegangstoken). Stel dit in op uw Azure Databricks persoonlijke toegangstokenwaarde.
UseJWTAssertion false Hiermee schakelt u JWT-verificatie met een persoonlijke sleutel in voor M2M-gebruiksvoorbeelden waarbij verificatie van clientgeheimen is beperkt.

Eigenschappen van verbinding en proxy

De volgende verbindings- en proxy-eigenschappen worden ondersteund door het Databricks JDBC-stuurprogramma. Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
AsyncExecPollInterval 200 De tijd in milliseconden tussen elke poll voor de status van de asynchrone uitvoering van de query. Asynchroon verwijst naar het feit dat de RPC-aanroep die wordt gebruikt om een query uit te voeren op Spark asynchroon is. Dit betekent niet dat Asynchrone JDBC-bewerkingen worden ondersteund.
CFProxyAuth 0 Als dit is ingesteld op 1, gebruikt het stuurprogramma de proxyverificatiegebruiker en het wachtwoord, vertegenwoordigd door CFProxyUID en CFProxyPwd.
CFProxyHost null Een tekenreeks die de naam vertegenwoordigt van de proxyhost die moet worden gebruikt wanneer UseCFProxy ook is ingesteld op 1.
CFProxyPort null Een geheel getal dat het nummer aangeeft van de proxypoort die moet worden gebruikt wanneer UseCFProxy ook is ingesteld op 1.
CFProxyPwd null Een tekenreeks die het wachtwoord vertegenwoordigt dat moet worden gebruikt voor proxyverificatie wanneer CFProxyAuth en UseCFProxy ook zijn ingesteld op 1.
CFProxyUID null Een tekenreeks die de gebruikersnaam vertegenwoordigt die moet worden gebruikt voor proxyverificatie wanneer CFProxyAuth en UseCFProxy ook zijn ingesteld op 1.
ConnCatalog of catalog SPARK De naam van de standaardcatalogus die moet worden gebruikt.
ConnSchema of schema default De naam van het standaardschema dat moet worden gebruikt. Dit kan worden opgegeven door <schema> in de URL te vervangen door de naam van het schema dat moet worden gebruikt of door de eigenschap ConnSchema in te stellen op de naam van het schema dat moet worden gebruikt.
ProxyAuth 0 Als dit is ingesteld op 1, gebruikt het stuurprogramma de proxyverificatiegebruiker en het wachtwoord, vertegenwoordigd door ProxyUID en ProxyPwd.
ProxyHost null Een tekenreeks die de naam vertegenwoordigt van de proxyhost die moet worden gebruikt wanneer UseProxy ook is ingesteld op 1.
ProxyPort null Een geheel getal dat het nummer aangeeft van de proxypoort die moet worden gebruikt wanneer UseProxy ook is ingesteld op 1.
ProxyIgnoreList "" (lege tekenreeks) Een door komma's gescheiden lijst met hosts of domeinen die de proxy omzeilen wanneer UseProxy deze is ingesteld op 1. Bijvoorbeeld: localhost,127.0.0.1.
ProxyPwd null Een tekenreeks die het wachtwoord vertegenwoordigt dat moet worden gebruikt voor proxyverificatie wanneer ProxyAuth en UseProxy ook zijn ingesteld op 1.
ProxyUID null Een tekenreeks die de gebruikersnaam vertegenwoordigt die moet worden gebruikt voor proxyverificatie wanneer ProxyAuth en UseProxy ook zijn ingesteld op 1.
UseCFProxy 0 Als dit is ingesteld op 1, gebruikt het stuurprogramma de proxy-instellingen voor het ophalen van de cloud als deze zijn opgegeven, anders gebruikt u de reguliere proxy.
UseProxy 0 Als dit is ingesteld op 1, gebruikt het stuurprogramma de opgegeven proxyinstellingen (bijvoorbeeld: ProxyAuth, ProxyHost, ProxyPort, ProxyPwden ProxyUID).
UseSystemProxy 0 Als dit is ingesteld op 1, gebruikt het stuurprogramma de proxy-instellingen die zijn ingesteld op systeemniveau. Als er extra proxy-eigenschappen zijn ingesteld in de verbindings-URL, overschrijven deze aanvullende proxy-eigenschappen die zijn ingesteld op systeemniveau.

Configuratie-eigenschappen van SSL-vertrouwensarchief

De volgende configuratie-eigenschappen van het SSL-vertrouwensarchief worden ondersteund door het Databricks JDBC-stuurprogramma. Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
AcceptUndeterminedRevocation 0 Als deze optie is ingesteld 1, accepteert u certificaten met een onbepaalde intrekkingsstatus wanneer certificaatintrekkingscontrole is ingeschakeld.
AllowSelfSignedCerts 0 Indien ingesteld op 1, staat het stuurprogramma verbindingen met servers met zelfondertekende SSL-certificaten toe.
CheckCertRevocation 1 Of het stuurprogramma het intrekken van SSL-certificaten controleert. Ingesteld op 0 het accepteren van ingetrokken certificaten.
SSL 1 Of de connector met de Spark-server communiceert via een socket met SSL.
SSLKeyStore null Het pad naar het SSL-sleutelarchiefbestand voor verificatie van clientcertificaten. Tls-verificatie alleen op de server wordt standaard uitgevoerd, zodat er geen clientcertificaat is vereist.
SSLKeyStorePwd null Het wachtwoord voor het SSL-sleutelarchiefbestand.
SSLKeyStoreType JKS Het type SSL-sleutelopslag. Geldige waarden zijnJKS, PKCS12, en JCEKSDKSPKCS11 .
SSLTrustStore null Het pad naar het vertrouwensarchiefbestand voor SSL-certificaatvalidatie.
SSLTrustStorePassword null Het wachtwoord voor het vertrouwensarchiefbestand, als het met een wachtwoord is beveiligd.
SSLTrustStoreType JKS Het type vertrouwensopslag, bijvoorbeeld JKS of PKCS12. Indien niet gespecificeerd, stelt de bestuurder standaard de JKS truststore in. Geldige typen zijn JKS, PKCS12en BCFKS.
UseSystemTrustStore 0 Indien ingesteld op 1, gebruikt het stuurprogramma het standaardvertrouwensarchief van het systeem voor SSL-certificaatverificatie.

Vertrouwensopslagtypen

Het JDBC-stuurprogramma ondersteunt de volgende SSL-modi en vertrouwensarchieftypen.

Modus voor zelfondertekende certificaten

Als u de zelfondertekende certificaatmodus wilt gebruiken, stelt u de verbindingseigenschap AllowSelfSignedCerts=1in. Deze modus maakt gebruik van een trust-all socket factory die elk certificaat accepteert.

Aangepaste vertrouwensopslag

Als u een aangepast vertrouwensarchief wilt gebruiken, geeft u een aangepast archiefbestand op in de SSLTrustStore verbindingseigenschap. Deze truststore wordt rechtstreeks geladen vanuit het opgegeven pad en de certificaten worden gebruikt voor validatie van SSL-certificaten. Het kan in JKS-, PKCS12- of andere ondersteunde formaten zijn.

U moet de volgende aanvullende verbindingseigenschappen opgeven:

  • SSLTrustStore: Pad naar het truststore-bestand
  • SSLTrustStorePassword: Wachtwoord voor het vertrouwensarchief (indien nodig)
  • SSLTrustStoreType: Type vertrouwensarchief (optioneel, standaard ingesteld op JKS als dit niet is opgegeven)

Java vertrouwensarchief voor systeemeigenschap

Als u het vertrouwensarchief van de systeemeigenschap wilt gebruiken, configureert u deze via UseSystemTrustStore=1 en zorgt u ervoor dat u geen aangepast vertrouwensarchief specificeert. Geef in plaats daarvan een vertrouwensarchief op met behulp van de systeemeigenschap Java systeemeigenschap javax.net.ssl.trustStore. Deze eigenschap wordt ingesteld op JVM-niveau met behulp van de -D vlag, bijvoorbeeld:

java -Djavax.net.ssl.trustStore=/path/to/truststore.jks -Djavax.net.ssl.trustStorePassword=changeit ...

Het JDBC-stuurprogramma controleert eerst op de Java systeemeigenschap javax.net.ssl.trustStore. Als dit is ingesteld, wordt dit bestand voor het vertrouwensarchief gebruikt in plaats van de standaardwaarde van de JDK. Als er geen systeemeigenschap is ingesteld, wordt het standaardvertrouwensarchief (cacerts) van de JDK gebruikt, dat zich bevindt op $JAVA_HOME/lib/security/cacerts of een vergelijkbaar pad.

JDK-standaardvertrouwensarchief (cacerts)

De JDK wordt geleverd met een ingebouwd vertrouwensarchief met de naam cacerts dat certificaten van bekende certificeringsinstanties bevat, waarmee verificatie van certificaten die door deze CA's zijn uitgegeven, is toegestaan. Dit vertrouwensarchief bevindt zich meestal op $JAVA_HOME/lib/security/cacerts met een standaard wachtwoord "changeit" of "changeme".

Als u het standaardvertrouwensarchief van de JDK wilt gebruiken, stelt u UseSystemTrustStore=1 in en zorgt u ervoor dat u geen aangepast vertrouwensarchief of een Java vertrouwensarchief voor systeemeigenschap opgeeft. Als er ook een vertrouwensarchief wordt opgegeven met behulp van de systeemeigenschap Java systeemeigenschap javax.net.ssl.trustStore, wordt het genegeerd, waardoor het stuurprogramma alleen certificaten uit het standaard-JDK-vertrouwensarchief gebruikt.

Volgorde van prioriteit van vertrouwenswinkel

Het stuurprogramma gebruikt de volgende volgorde van prioriteit om te bepalen welk vertrouwensarchief moet worden gebruikt:

  1. Het aangepaste vertrouwensarchief dat is opgegeven in de SSLTrustStore verbindingseigenschap
  2. Het vertrouwensarchief dat is opgegeven in de systeemeigenschap Java javax.net.ssl.trustStore (wanneer UseSystemTrustStore=1)
  3. Het standaard truststore van de JDK (cacerts)

Aanbevelingen voor beveiliging

Databricks raadt het volgende aan om uw verbinding veilig te houden:

  • Voor productieomgevingen:

    • Gebruik de zelfondertekende certificaatmodus (AllowSelfSignedCerts=1) niet.
    • Gebruik officiële door ca ondertekende certificaten.
    • Gebruik UseSystemTrustStore=1 tenzij je een aangepaste vertrouwenstore nodig hebt.

  • Voor aangepaste vertrouwensopslagplaatsen:

    • Gebruik deze functie wanneer u verbinding maakt met servers met certificaten die niet in het standaardvertrouwensarchief staan.
    • Zorg ervoor dat het vertrouwensarchief de volledige certificaatketen bevat.
    • Beveilig vertrouwensopslagbestanden met de juiste machtigingen.

Eigenschappen van strategie voor opnieuw proberen

De volgende eigenschappen van de strategie voor opnieuw proberen worden ondersteund door het Databricks JDBC-stuurprogramma (OSS). Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
RateLimitRetry 1 Als deze optie is ingesteld 1, kunt u het opnieuw proberen voor fouten met frequentielimieten.
RateLimitRetryTimeout 120 Opnieuw probeer-tijdsduur voor tarieflimiet in seconden.
TemporarilyUnavailableRetry 1 Als deze optie is ingesteld op 1, wordt automatisch opnieuw geprobeerd bij tijdelijk niet-beschikbare fouten.
TemporarilyUnavailableRetryTimeout 900 De time-out voor herhaald proberen bij tijdelijk niet-beschikbare fouten, in seconden.
VolumeOperationRetryableHttpCode 408,429,500,502,503,504 De door komma's gescheiden lijst met opnieuw te proberen HTTP-codes voor opname van Unity Catalog-volumes.
VolumeOperationRetryTimeout 15 De wachttijd voor herhaalde pogingen bij HTTP-aanvragen voor het opnemen van Unity Catalog-volumes, in minuten.

Eigenschappen voor prestatie- en verbindingsbeheer

De volgende eigenschappen voor prestaties en verbindingsbeheer worden ondersteund door het Databricks JDBC-stuurprogramma (OSS). Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
CloudFetchThreadPoolSize 16 De grootte van de threadpool voor het ophalen van cloudbewerkingen.
DefaultStringColumnLength 255 Het maximum aantal tekens dat kan worden opgenomen in tekenreekskolommen voor het rapporteren van metagegevens.
HttpConnectionPoolSize 100 De maximale grootte van de HTTP-verbindingsgroep.
IdleHttpConnectionExpiry 60 De verlooptijd van de inactieve HTTP-verbinding, in seconden.
RowsFetchedPerBlock 2000000 Het maximum aantal rijen dat een query tegelijk retourneert. Dit geldt alleen voor inlineresultaten.
SocketTimeout 900 De time-out voor sockets voor netwerkbewerkingen, in seconden.

SQL-configuratie-eigenschappen

De volgende SQL-configuratie-eigenschappen worden ondersteund door het Databricks JDBC-stuurprogramma. Deze worden ook beschreven in Configuratieparameters. Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
ansi_mode TRUE Of u strikte ANSI SQL-gedrag wilt inschakelen voor bepaalde functies en cast-regels.
enable_photon TRUE Hiermee wordt aangegeven of de Photon vectorized query engine moet worden ingeschakeld.
legacy_time_parser_policy EXCEPTION De methoden voor het parseren en opmaken van datums en tijdstempels. Geldige waarden zijn EXCEPTION, LEGACYen CORRECTED.
max_file_partition_bytes 128m Het maximum aantal bytes dat moet worden ingepakt in één partitie bij het lezen van bronnen op basis van bestanden. De instelling kan elk positief geheel getal zijn en eventueel een meting bevatten, zoals b (bytes), k of kb (1024 bytes).
query_tags "" (lege tekenreeks) Een door komma's gescheiden lijst met sleutel-waardetags die moeten worden gekoppeld aan SQL-query's voor het bijhouden en analyseren in system.query.history.
read_only_external_metastore false Hiermee bepaalt u of een externe metastore wordt hanteert als alleen-lezen.
statement_timeout 172800 Hiermee stelt u een time-out voor de SQL-instructie in tussen 0 en 172800 seconden.
timezone UTC Stel de lokale tijdzone in. Regio-id's in de vorm area/city, zoals Amerika/Los_Angeles of zone-offsets in de notatie (+|-)HH, (+|-)HH:mm of (+|-)HH:mm:ss, bijvoorbeeld -08, +01:00 of -13:33:33. UTC wordt ook ondersteund als alias voor +00:00
use_cached_result true Of Databricks SQL resultaten indien mogelijk in de cache opgeslagen en hergebruikt.

Logboek eigenschappen

De volgende eigenschappen voor logboekregistratie worden ondersteund door het Databricks JDBC-stuurprogramma. Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
LogFileCount 10 Het maximum aantal toegestane logboekbestanden
LogFileSize 10 De maximaal toegestane logboekbestandsgrootte, opgegeven in MB
LogLevel OFF Het logboekregistratieniveau, een waarde 0 tot en met 6:
  • 0: Schakel alle logboekregistratie uit.
  • 1: Schakel logboekregistratie in op het FATAL-niveau, waarmee zeer ernstige foutgebeurtenissen worden geregistreerd die ertoe leiden dat de connector wordt afgebroken.
  • 2: Schakel logboekregistratie in op het ERROR-niveau, waarmee foutgebeurtenissen worden geregistreerd die de connector mogelijk nog steeds kunnen laten draaien.
  • 3: Schakel logboekregistratie in op waarschuwingsniveau, waarmee gebeurtenissen worden geregistreerd die tot een fout kunnen leiden als er geen actie wordt ondernomen.
  • 4: Schakel logboekregistratie in op het INFO-niveau, waarin algemene informatie wordt vermeld waarin de voortgang van de connector wordt beschreven.
  • 5: Schakel logboekregistratie in op het niveau DEBUG, waarmee gedetailleerde informatie wordt beschreven die nuttig is voor het opsporen van fouten in de connector.
  • 6: Schakel logboekregistratie in op TRACE-niveau, waarmee alle activiteit van de connector wordt in logboeken opgeslagen.

Gebruik deze eigenschap om logboekregistratie in of uit te schakelen in de connector en om de hoeveelheid details op te geven die is opgenomen in logboekbestanden.
LogPath Om het standaardpad voor logboeken te bepalen, gebruikt het stuurprogramma de waarde die is ingesteld voor deze systeemeigenschappen, in deze prioriteitsvolgorde:
  • user.dir
  • java.io.tmpdir
  • de huidige directory, met andere woorden .
 Het volledige pad naar de map waarin de connector logboekbestanden opslaat wanneer logging is ingeschakeld, als een tekenreeks. Om ervoor te zorgen dat de verbindings-URL compatibel is met alle JDBC-toepassingen, escapet u de backslashes (\) in het bestandspad door een andere backslash te typen.
Als de LogPath-waarde ongeldig is, verzendt de connector de vastgelegde gegevens naar de standaarduitvoerstroom (System.out).

Logboekregistratie inschakelen en configureren

Het JDBC-stuurprogramma ondersteunt de Simple Logging Facade voor Java (SLF4J) en java.util.logging (JUL) frameworks. Het stuurprogramma maakt standaard gebruik van het JUL-logboekregistratieframework.

Logboekregistratie inschakelen en configureren voor het JDBC-stuurprogramma:

  1. Schakel het framework voor logboekregistratie in dat u wilt gebruiken:

    • Voor SLF4J-logboekregistratie stelt u de systeemeigenschap in -Dcom.databricks.jdbc.loggerImpl=SLF4JLOGGER en geeft u de SLF4J-binding-implementatie op (compatibel met SLF4J versie 2.0.13 en hoger) en het bijbehorende configuratiebestand in het klassepad.
    • Stel voor JUL-logboekregistratie de systeemeigenschap in -Dcom.databricks.jdbc.loggerImpl=JDKLOGGER. Dit is de standaardwaarde.

  2. Stel de eigenschap LogLevel op de verbindingsreeks in op het gewenste gegevensniveau dat moet worden opgenomen in logboekbestanden.

  3. Stel de eigenschap LogPath op de verbindingsreeks in op het volledige pad naar de map waarin u logboekbestanden wilt opslaan.

    Met de volgende verbindings-URL kunt u bijvoorbeeld logboekregistratieniveau 6 inschakelen en worden de logboekbestanden opgeslagen in de map C:temp:

    jdbc: databricks://localhost:11000;LogLevel=6;LogPath=C:\\temp

  4. Start de JDBC-toepassing opnieuw op en maak opnieuw verbinding met de server om de instellingen toe te passen.

Andere functie-eigenschappen

De volgende eigenschappen schakelen functies in het Databricks JDBC-stuurprogramma in. Eigenschappen zijn niet hoofdlettergevoelig.

Vastgoed Standaardwaarde Beschrijving
EnableArrow 1 Hiermee schakelt u serialisatie van Apache Arrow in voor overdrachten van resultatensets. Cloud fetch is afhankelijk van Pijl, dus als u Pijl uitschakelt, wordt ook Cloud fetch uitgeschakeld. Ingesteld op 0 om uit te schakelen.
Versie 3.3.1 en hoger ondersteunt Arrow met JDK 16 en hoger. Versie 3.2.1 en lager met JDK 16 en hoger kan runtimefouten veroorzaken. U kunt dit omzeilen door uw toepassing of stuurprogramma opnieuw op te starten met de JVM-optie --add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED. Arrow en Cloud Fetch worden niet ondersteund op IBM AIX.
EnableComplexDatatypeSupport 0 Als deze optie is ingesteld op 1, wordt ondersteuning voor complexe gegevenstypen (ARRAY's, STRUCTs, MAPs) als systeemeigen Java objecten ingeschakeld in plaats van tekenreeksen.
EnableDirectResults 1 Als 1 is ingesteld, worden directe resultaten ingeschakeld voor verbeterde queryprestaties.
EnableGeoSpatialSupport 0 Als deze optie is ingesteld op 1, schakelt u ondersteuning in voor georuimtelijke gegevenstypen (GEOMETRIE en GEOGRAFIE) als gestructureerde Java objecten. Vereist EnableComplexDatatypeSupport=1 en EnableArrow=1 (Pijl is standaard ingeschakeld). Wanneer deze functie is uitgeschakeld, worden georuimtelijke kolommen geretourneerd als TEKENREEKS in EWKT-indeling. Zie georuimtelijke ST-functies.
EnableSqlScripting 1 of true Hiermee schakelt u ondersteuning voor SQL-scripting in voor samengestelde instructieblokken (BEGIN... END) en opgeslagen procedure-aanroepen. Beschikbaar in stuurprogrammaversie 1.0.10 en hoger met Databricks Runtime 16.3 en hoger.
Voor opgeslagen procedures is Databricks Runtime 17.0 en hoger en stuurprogrammaversie 3.0.1 en hoger vereist. Gebruik Statement of PreparedStatement om procedures aan te roepen. CallableStatement wordt niet ondersteund. Zie SQL-scripts voor syntaxis en voorbeelden.
EnableMetricViewMetadata 0 Als deze optie is ingesteld 1, kunt u verbeterde metagegevensbewerkingen voor metrische weergaven inschakelen. Zie Werken met metagegevens van de metrische weergave met behulp van het Databricks JDBC-stuurprogramma.
EnableTelemetry 0 Als deze optie is ingesteld 1, is telemetrie ingeschakeld. Zie Telemetrie.
EnableVolumeOperations 1of true De client-info eigenschap om volumebewerkingen op een stream mogelijk te maken. Zie Bestanden beheren in volumes met het Databricks JDBC-stuurprogramma. Deze eigenschap schakelt standaard ook de REMOVE bewerking op een volume in.
Belangrijk: U moet dit instellen als een eigenschap voor clientgegevens. Als u deze alleen opgeeft in de verbindings-URL, worden volumebewerkingen voor een stream niet ingeschakeld.
MaxBatchSize 500 De maximale batchgrootte voor batchbewerkingen en gegevensverwerking.
QueryResultCompressionType 1 Geldige waarden zijn 0 (voor geen compressie) en 1 (voor LZ4-compressie). Het stuurprogramma overschrijft automatisch 0 (geen compressie) voor inlineresultaten, ongeacht de geconfigureerde instelling
UserAgentEntry browser De User-Agent vermelding die opgenomen moet worden in de HTTP-aanvraag. Deze waarde heeft de volgende indeling: [ProductName]/[ProductVersion] [Comment]
UseThriftClient 1 Of het JDBC-stuurprogramma de Thrift-client of Statement Execution APIs moet gebruiken.
VolumeOperationAllowedLocalPaths `` De door komma's gescheiden lijst met toegestane lokale paden voor het downloaden en uploaden van Unity Catalog-volumeopnamebestanden. De paden bevatten ook subdirectories. Wanneer dit niet is opgegeven, valt dit terug op de waarde van StagingAllowedLocalPaths, vervolgens naar een lege tekenreeks die geen beperkingen aangeeft. Zie Bestanden beheren met volumes.
Belangrijk: Als de installatie zich in een omgeving met meerdere tenants bevindt (zoals BI-hulpprogramma's of ontwikkelaarsservices) en de gebruikers de volledige JDBC-URL beheren, moet de service deze eigenschap instellen op een sandboxlocatie of een niet-bestaand pad. Dit voorkomt dat gebruikers arbitraty-bestanden schrijven en de interne implementatie van de service verstoren.

Telemetrieverzameling

Met telemetrie kan Databricks foutopsporing stroomlijnen en tijdig problemen oplossen door het verzamelen:

  • Details van clientomgeving (stuurprogrammaversie, runtime, besturingssysteemdetails)
  • JDBC-verbindingsconfiguraties (sluit eventuele PII-gegevens uit)
  • Latentiemetingen voor bewerkingen
  • Resultaatindeling voor uitvoering (JSON inline, Arrow, enzovoort)
  • Bewerkingstypen (uitvoeringsquery, metagegevensquery, volumebewerkingen)
  • Foutclassificatiegegevens
  • Aantal nieuwe pogingen

Opmerking

Databricks handhaaft strikte privacystandaarden, zodat er geen query-inhoud, resultaten of persoonlijke gegevens (PII) worden verzameld.

  • Last updated on