Dela via

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

  • Artikel

I den här artikeln 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 inledande 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>.

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

ODBC-drivrutinen accepterar SQL-frågor i ANSI SQL-92-dialekten och översätter frågorna till Databricks SQL-dialekten. Men om ditt program genererar Databricks SQL direkt eller om ditt program använder någon sql-syntax som inte är ANSI SQL-92 som är specifik för Azure Databricks rekommenderar Databricks att du anger UseNativeQuery=1 som en anslutningskonfiguration. Med den inställningen skickar drivrutinen SQL-frågorna ordagrant till Azure Databricks.

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.

Frågeresultat laddas upp till en intern DBFS-lagringsplats som Pil-serialiserade filer på upp till 20 MB. När drivrutinen skickar hämtningsbegäranden efter att frågan har slutförts genererar och returnerar Azure Databricks signaturer för delad åtkomst till de uppladdade filerna. ODBC-drivrutinen använder sedan URL:erna för att ladda ned resultatet direkt från DBFS.

Cloud Fetch används endast för frågeresultat som är större än 1 MB. Mindre resultat hämtas direkt från Azure Databricks.

Azure Databricks samlar automatiskt in de ackumulerade filer som har markerats för borttagning efter 24 timmar. Dessa markerade filer tas bort helt efter ytterligare 24 timmar.

Mer information om cloud fetch-arkitekturen finns i How We Achieved High-bandwidth Connectivity With BI Tools (Hur vi uppnådde anslutning med hög bandbredd med BI-verktyg).

Aktivera loggning

Om du vill aktivera loggning i ODBC-drivrutinen för Windows anger du följande fält i ODBC-datakälladministratören för det relaterade DSN:t:

  • Ange fältet Loggnivå från FATAL för att endast logga allvarliga händelser via TRACE för att logga all drivrutinsaktivitet.
  • Ange fältet Loggsökväg till den fullständiga sökvägen till mappen där du vill spara loggfiler.
  • Ange fältet Max antal filer till det maximala antalet loggfiler som ska behållas.
  • Ange fältet Maximal filstorlek till den maximala storleken för varje loggfil i megabyte.

Om du vill aktivera loggning i ODBC-drivrutinen för en icke-Windows-dator anger du följande egenskaper i den relaterade DSN- eller DSN-niska veze:

  • LogLevel Ange egenskapen från 1 för att logga endast allvarliga händelser genom 6 för att logga all drivrutinsaktivitet.
  • Ange egenskapen LogPath till den fullständiga sökvägen till mappen där du vill spara loggfiler.
  • Ange egenskapen LogFileCount till det maximala antalet loggfiler som ska behållas.
  • Ange egenskapen LogFileSize till den maximala storleken för varje loggfil i byte.

Mer information finns i avsnitten Configuring Logging Options on Windows och Configuring Logging Options on a Non-Windows Machine i drivrutinsguiden för Databricks JDBC.