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.

Set il schema iniziale in ODBC

Il driver ODBC consente di specificare il 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 setUseNativeQuery=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 supportano Cloud Fetch, una funzionalità che consente di recuperare i risultati delle query tramite l'archiviazione cloud set nella tua 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, set i campi seguenti nell'amministratore origine dati ODBC per il DSN correlato:

  • Set il campo Livello di Log da FATAL per registrare solo eventi gravi fino a TRACE per registrare tutte le attività del driver.
  • Set il campo Percorso Log con il percorso completo della cartella dove where desideri salvare i file di log.
  • Set il campo numero massimo di file al numero massimo di file di log da conservare.
  • Set il campo dimensioni massime file alle dimensioni massime di ogni file di log in megabyte.

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

  • Set la proprietà LogLevel da 1 per registrare solo eventi gravi tramite 6 per registrare tutte le attività del driver.
  • Set la proprietà LogPath al percorso completo della cartella where in cui si desidera salvare i file di log.
  • Set la proprietà LogFileCount al numero massimo di file di log da mantenere.
  • Set la proprietà LogFileSize alle dimensioni massime 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.