Instellingen voor stuurprogrammamogelijkheden voor het Databricks JDBC-stuurprogramma (Simba)

Opmerking

Deze pagina is van toepassing op het Simba JDBC-stuurprogramma (verouderd), versies onder versie 3. Databricks raadt ten zeerste aan om te migreren naar het Databricks JDBC-stuurprogramma voor JDBC-connectiviteit. Het bevat verbeteringen zoals ondersteuning voor metrische weergaven van Unity Catalog, transacties die meerdere SQL-instructies omvatten, opgeslagen procedures, sneller ophalen van grote resultaten en ingebouwde clienttelemetrie.

Op deze pagina wordt beschreven hoe u speciale en geavanceerde stuurprogrammamogelijkheden configureert voor het Databricks JDBC-stuurprogramma.

Het Databricks JDBC-stuurprogramma biedt de volgende speciale en geavanceerde instellingen voor stuurprogrammamogelijkheden.

ANSI SQL-92-queryondersteuning in JDBC

Verouderde Spark JDBC-stuurprogramma's accepteren SQL-query's in ANSI SQL-92 dialect en vertalen ze naar Databricks SQL voordat ze naar de server worden verzonden.

Als uw toepassing Databricks SQL rechtstreeks genereert of niet-ANSI SQL-92-syntaxis gebruikt die specifiek is voor Azure Databricks, stelt u UseNativeQuery=1 in uw verbindingsconfiguratie in. Met deze instelling worden de exacte bewoordingen van SQL-query's doorgegeven aan Azure Databricks zonder vertaling.

Standaardcatalogus en -schema

Als u de standaardcatalogus en het standaardschema wilt opgeven, voegt u ConnCatalog=<catalog-name>;ConnSchema=<schema-name> toe aan de JDBC-verbindings-URL.

Query-tags voor tracering

Belangrijk

Deze functie bevindt zich in Private Preview. Neem contact op met uw accountteam om toegang aan te vragen.

Koppel sleutelwaardetags aan uw SQL-query's voor tracerings- en analysedoeleinden. Querytags worden weergegeven in de system.query.history tabel voor queryidentificatie en -analyse.

Als u querytags aan uw verbinding wilt toevoegen, neemt u de parameter op in de ssp_query_tags URL van uw JDBC-verbinding:

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2

Definieer querytags als door komma's gescheiden sleutel-waardeparen, waarbij elke sleutel en waarde worden gescheiden door een dubbele punt. Bijvoorbeeld: key1:value1,key2:value2.

Grote queryresultaten extraheren in JDBC

Als u de beste prestaties wilt behalen wanneer u grote queryresultaten extraheert, gebruikt u de nieuwste versie van het JDBC-stuurprogramma, waaronder de volgende optimalisaties.

Pijlserialisatie in JDBC

JDBC-stuurprogrammaversie 2.6.16 en hoger ondersteunt een geoptimaliseerde serialisatie-indeling voor queryresultaten die gebruikmaakt van Apache Arrow.

Cloud-gegevens ophalen in JDBC

JDBC-stuurprogrammaversie 2.6.19 en hoger ondersteunt Cloud Fetch, een mogelijkheid waarmee queryresultaten worden opgehaald via de cloudopslag die is geconfigureerd in uw Azure Databricks-implementatie.

Wanneer u een query uitvoert, slaat Azure Databricks de resultaten op in de cloudopslag van uw werkruimte als met pijl geserialiseerde bestanden van maximaal 20 MB. Nadat de query is voltooid, verzendt het stuurprogramma ophalen aanvragen en Azure Databricks retourneert SHARED Access Signature(SAS)-URL's naar de resultaatbestanden. Het stuurprogramma gebruikt deze URL's vervolgens om resultaten rechtstreeks vanuit Azure-opslag te downloaden.

Cloud Fetch is alleen van toepassing op queryresultaten die groter zijn dan 1 MB. Het stuurprogramma haalt kleinere resultaten rechtstreeks op uit Azure Databricks.

Azure Databricks verzamelt automatisch verzamelde bestanden door ze na 24 uur te markeren voor verwijdering en ze 24 uur later permanent te verwijderen.

Netwerkvereisten

Als uw netwerk privé is, moet u de volgende instellingen configureren om Cloud fetch te laten werken:

Als u Cloud ophalen wilt uitschakelen, stelt u EnableQueryResultDownload=0 deze in uw verbindingsconfiguratie in.

Trage downloads diagnosticeren

Ingesteld LogLevel op 4 (INFO) en LogPath op het volledige pad van een logboekmap om metrische gegevens over de downloadsnelheid van Cloud Fetch weer te geven. De stuurprogrammalogboeken downloaden snelheid per segment, zodat grote resultatensets meerdere logboeklijnen genereren. De bestuurder registreert ook een waarschuwing wanneer de snelheid lager is dan ongeveer 1 MB/s. Deze functie is beschikbaar in stuurprogrammaversies van JDBC (Simba) die na december 2025 zijn uitgebracht.

Als downloads traag of vastlopen, kunnen SAS-tokens verlopen voordat het stuurprogramma klaar is met het downloaden van alle resultaatbestanden. Controleer op bandbreedtebeperking of netwerkcongestie tussen de client en Azure Blob Storage.

Logboekregistratie inschakelen

Als u logboekregistratie in het JDBC-stuurprogramma wilt inschakelen, stelt u de LogLevel eigenschap in op een waarde tussen 1 (alleen ernstige gebeurtenissen) en 6 (alle stuurprogrammaactiviteit). Stel de LogPath eigenschap in op het volledige pad van de map waarin u logboekbestanden wilt opslaan.

Zie Logboekregistratie configureren in de Handleiding voor het JDBC-stuurprogramma van Databricks voor meer informatie.

  • Last updated on