Delen via


Ondersteunde verbindingseigenschappen

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

verificatie- en proxyeigenschappen

De volgende verificatie- en proxy-eigenschappen worden ondersteund door het JDBC-stuurprogramma van Databricks. 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.
Auth_Flow 0 De OAuth2-verificatiestroom voor de stuurprogrammaverbinding. Deze eigenschap is vereist als AuthMech is 11.
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.
AuthMech Verplicht Het verificatiemechanisme, waarbij 3 het mechanisme opgeeft, is een persoonlijk toegangstoken van Azure Databricks en 11 geeft aan dat het mechanisme OAuth 2.0-tokens is. Er zijn extra eigenschappen vereist voor elk mechanisme. Zie Het stuurprogramma authentiseren.
AzureTenantId null De Azure-tenant-id voor azure-specifieke verificatie.
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.
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.
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. databricks-sql-jdbc Standaard wordt deze gebruikt voor AWS, GCP en Azure. Er is een aangepaste client-id vereist voor geavanceerde OAuth-configuraties.
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.
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.
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.
TokenCachePassPhrase null De wachtwoordzin die moet worden gebruikt voor OAuth U2M-tokencacheversleuteling.
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.
UseJWTAssertion false Hiermee schakelt u JWT-verificatie met een persoonlijke sleutel in voor M2M-gebruiksvoorbeelden waarbij verificatie van clientgeheimen is beperkt.
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.
CheckCertificateRevocation 0 Als dit is ingesteld 1, controleert het stuurprogramma of het SSL-certificaat is ingetrokken.
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)

Vertrouwensarchief voor Java-systeemeigenschappen

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 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 JDK-standaardvertrouwensarchief wilt gebruiken, stelt u deze in UseSystemTrustStore=1 en zorgt u ervoor dat u geen aangepast vertrouwensarchief of een vertrouwensarchief voor java-systeemeigenschappen opgeeft. Als een vertrouwensarchief ook is opgegeven met behulp van de Java-systeemeigenschap javax.net.ssl.trustStore, wordt deze 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 Java-systeemeigenschap 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 for 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 van de verbindingsreeks in op het gewenste informatieniveau 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 Als deze optie is ingesteld 0op , wordt de serialisatie van pijlen voor resultaten uitgeschakeld, waardoor het gedrag van cloud ophalen ook wordt uitgeschakeld omdat de indeling Van de pijl nodig is voor Cloud Fetch.
EnableComplexDatatypeSupport 0 Als deze optie is ingesteld op 1, wordt ondersteuning voor complexe gegevenstypen (ARRAY's, STRUCT's, 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 Indien 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.