Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Anmärkning
Den här sidan gäller för Simba JDBC Driver (Legacy), versioner under version 3. Databricks rekommenderar starkt att du migrerar till Databricks JDBC-drivrutinen för JDBC-anslutning. Den innehåller förbättringar som stöd för måttvyer i Unity Catalog, transaktioner som omfattar flera SQL-instruktioner, lagrade procedurer, snabbare hämtning av stora resultat och inbyggd klienttelemetri.
På den här sidan beskrivs hur du konfigurerar särskilda och avancerade kapacitetsinställningar för drivrutiner för Databricks JDBC-drivrutinen.
Databricks JDBC-drivrutinen innehåller följande särskilda och avancerade inställningar för drivrutinsfunktioner.
Stöd för ANSI SQL-92-frågor i JDBC
Äldre Spark JDBC-drivrutiner accepterar SQL-frågor i ANSI SQL-92-dialekten och översätter dem till Databricks SQL innan de skickas till servern.
Om ditt program genererar Databricks SQL direkt eller använder icke-ANSI SQL-92-syntax som är specifik för Azure Databricks anger du UseNativeQuery=1 i anslutningskonfigurationen. Den här inställningen skickar SQL-frågor ordagrant till Azure Databricks utan översättning.
Förvald katalog och schemat
Om du vill ange standardkatalogen och schemat lägger du till ConnCatalog=<catalog-name>;ConnSchema=<schema-name> till JDBC-anslutnings-URL:en.
Frågetaggar för spårning
Viktigt!
Den här funktionen är en privat förhandsversion. Kontakta kontoteamet om du vill begära åtkomst.
Koppla nyckelvärdestaggar till dina SQL-frågor i spårnings- och analyssyfte. Frågetaggar visas i tabellen system.query.history för frågeidentifiering och analys.
Om du vill lägga till frågetaggar i anslutningen tar du med parametern ssp_query_tags i JDBC-anslutnings-URL:en:
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2
Definiera frågetaggar som kommaavgränsade nyckel/värde-par, där varje nyckel och värde avgränsas med ett kolon. Till exempel key1:value1,key2:value2.
Extrahera stora frågeresultat i JDBC
För att uppnå bästa prestanda när du extraherar stora frågeresultat använder du den senaste versionen av JDBC-drivrutinen, som innehåller följande optimeringar.
Pilserialisering i JDBC
JDBC-drivrutinsversion 2.6.16 och senare stöder ett optimerat serialiseringsformat för frågeresultat som använder Apache Arrow.
Molnhämtning i JDBC
JDBC-drivrutinsversion 2.6.19 och senare stöder Cloud Fetch, en funktion som hämtar frågeresultat via molnlagringen som konfigurerats i din Azure Databricks distribution.
När du kör en fråga lagrar Azure Databricks resultatet i arbetsytans molnlagring som Pil-serialiserade filer på upp till 20 MB. När frågan har slutförts skickar drivrutinen hämtningsbegäranden och Azure Databricks returnerar url:er för shared access signature (SAS) till resultatfilerna. Drivrutinen använder sedan dessa URL:er för att ladda ned resultat direkt från Azure lagring.
Cloud Fetch gäller endast för frågeresultat som är större än 1 MB. Drivrutinen hämtar mindre resultat direkt från Azure Databricks.
Azure Databricks automatiskt skräp samlar in ackumulerade filer genom att markera dem för borttagning efter 24 timmar och permanent ta bort dem 24 timmar senare.
Nätverkskrav
Om nätverket är privat måste du konfigurera följande inställningar för att Cloud Fetch ska fungera:
- Tillåt
*.blob.core.windows.netoch*.store.core.windows.neti din nätverksmiljö. - Lägg till nödvändiga certifikatnedladdningar och återkallanden i listan över tillåtna certifikat.
- Om brandväggsstöd är aktiverat på ditt lagringskonto för Azure Databricks arbetsyta konfigurerar du en virtual nätverksdatagateway eller en on-premises datagateway för att tillåta privat åtkomst till lagringskontot.
Om du vill inaktivera Cloud Fetch anger du EnableQueryResultDownload=0 i anslutningskonfigurationen.
Diagnostisera långsamma nedladdningar
Ange LogLevel till 4 (INFO) och LogPath till den fullständiga sökvägen för en loggmapp för att se Hastighetsmått för nedladdningshastighet för Cloud Fetch. Drivrutinsloggarna laddar ned hastighet per segment, så stora resultatuppsättningar genererar flera loggrader. Drivrutinen loggar också en varning när hastigheten understiger cirka 1 MB/s. Den här funktionen är tillgänglig i JDBC-drivrutinsversioner (Simba) som släpptes efter december 2025.
Om nedladdningarna är långsamma eller stoppas kan SAS-token upphöra att gälla innan drivrutinen har laddat ned alla resultatfiler. Sök efter bandbreddsbegränsning eller nätverksbelastning mellan klienten och Azure Blob Storage.
Aktivera loggning
Om du vill aktivera loggning i JDBC-drivrutinen anger du LogLevel egenskapen till ett värde mellan 1 (endast allvarliga händelser) och 6 (all drivrutinsaktivitet). Ange egenskapen LogPath till den fullständiga sökvägen till den mapp där du vill spara loggfiler.
Mer information finns i Konfigurera loggning i Drivrutinsguiden för Databricks JDBC.