Inställningar för drivrutinsfunktioner för Databricks ODBC-drivrutinen

På den här sidan beskrivs hur du konfigurerar särskilda och avancerade kapacitetsinställningar för drivrutiner för Databricks ODBC-drivrutinen.

Databricks ODBC-drivrutinen innehåller följande särskilda och avancerade kapacitetsinställningar för drivrutiner.

Ange det första schemat i ODBC

Med ODBC-drivrutinen kan du ange schemat genom att ange Schema=<schema-name> som en anslutningskonfiguration. Detta motsvarar att köra USE <schema-name>.

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 inkluderar du parametern ssp_query_tags i odbc-anslutningskonfigurationen:

Definiera frågetaggar som kommaavgränsade nyckel/värde-par, där varje nyckel och värde avgränsas med ett kolon. Till exempel ssp_query_tags=team:engineering,env:prod.

Stöd för ANSI SQL-92-frågor i ODBC

Äldre Spark ODBC-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.

Extrahera stora frågeresultat i ODBC

För att uppnå bästa prestanda när du extraherar stora frågeresultat använder du den senaste versionen av ODBC-drivrutinen, som innehåller följande optimeringar.

Pilserialisering i ODBC

ODBC-drivrutinsversion 2.6.15 och senare stöder ett optimerat frågeresultats serialiseringsformat som använder Apache Arrow.

Cloud Fetch i ODBC

ODBC-drivrutinsversion 2.6.17 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.net och *.store.core.windows.net i 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 ODBC-drivrutinsversioner som släpptes efter november 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 ODBC-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 loggningsalternativ i en dator som inte Windows i Databricks ODBC-drivrutinsguiden.