Condividi tramite

Impostazioni delle funzionalità del driver per il driver ODBC di Databricks

  • Articolo

Questo articolo descrive come configurare impostazioni speciali e avanzate delle funzionalità del driver per il driver ODBC di Databricks.

Il driver ODBC di Databricks offre le impostazioni speciali e avanzate seguenti per le funzionalità del driver.

Impostare lo schema iniziale in ODBC

Il driver ODBC consente di specificare lo schema impostando Schema=<schema-name> come configurazione di connessione. Equivale all'esecuzione USE <schema-name>di .

Supporto delle query ANSI SQL-92 in ODBC

Il driver ODBC accetta query SQL nel dialetto SQL-92 ANSI e converte le query nel dialetto SQL di Databricks. Tuttavia, se l'applicazione genera direttamente Databricks SQL o l'applicazione usa una sintassi SQL-92 standard non ANSI specifica per Azure Databricks, Databricks consiglia di impostare UseNativeQuery=1 come configurazione di connessione. Con questa impostazione, il driver passa le query SQL verbatim ad Azure Databricks.

Estrarre risultati di query di grandi dimensioni in ODBC

Per ottenere prestazioni ottimali quando si estraggono risultati di query di grandi dimensioni, usare la versione più recente del driver ODBC che include le ottimizzazioni seguenti.

Serializzazione delle frecce in ODBC

Il driver ODBC versione 2.6.15 e successive supporta un formato di serializzazione dei risultati delle query ottimizzato che usa Apache Arrow.

Recupero cloud in ODBC

Odbc Driver versione 2.6.17 e successive supporta Cloud Fetch, una funzionalità che recupera i risultati delle query tramite l'archiviazione cloud configurata nella distribuzione di Azure Databricks.

I risultati delle query vengono caricati in un percorso di archiviazione DBFS interno come file serializzati con freccia fino a 20 MB. Quando il driver invia richieste di recupero dopo il completamento delle query, Azure Databricks genera e restituisce firme di accesso condiviso ai file caricati. Il driver ODBC usa quindi gli URL per scaricare i risultati direttamente da DBFS.

Il recupero cloud viene usato solo per i risultati delle query superiori a 1 MB. I risultati più piccoli vengono recuperati direttamente da Azure Databricks.

Azure Databricks esegue automaticamente il Garbage Collection dei file accumulati contrassegnati per l'eliminazione dopo 24 ore. Questi file contrassegnati vengono eliminati completamente dopo altre 24 ore.

Per altre informazioni sull'architettura di recupero cloud, vedere Come è stata raggiunta la connettività a larghezza di banda elevata con gli strumenti di BUSINESS Intelligence.

Abilitazione della registrazione

Per abilitare la registrazione nel driver ODBC per Windows, impostare i campi seguenti nell'amministratore origine dati ODBC per il DSN correlato:

  • Impostare il campo livello di log da FATAL per registrare solo eventi gravi tramite TRACE per registrare tutte le attività del driver.
  • Impostare il campo percorso del log sul percorso completo della cartella in cui si vuole salvare i file di log.
  • Impostare il campo numero massimo di file sul numero massimo di file di log da mantenere.
  • Impostare il campo dimensioni massime del file sulla dimensione massima di ogni file di log in megabyte.

Per abilitare la registrazione nel driver ODBC per un computer non Windows, impostare le proprietà seguenti nella stringa di connessione DSN o senza DSN correlata:

  • Impostare la proprietà LogLevel da 1 per registrare solo eventi gravi fino a 6 per registrare tutte le attività del conducente.
  • Impostare la proprietà LogPath sul percorso completo della cartella in cui si desidera salvare i file di log.
  • Impostare la proprietà LogFileCount sul numero massimo di file di log da mantenere.
  • Imposta la proprietà LogFileSize alla dimensione massima di ogni file di log in byte.

Per altre informazioni, vedere le sezioni Configuring Logging Options on Windows e Configuring Logging Options on a Non-Windows Machine la Guida al driver JDBC di Databricks.