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

Questa pagina 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 .

Tag di ricerca per monitoraggio

Allegare tag chiave-valore alle query SQL per scopi di rilevamento e analisi. I tag di query vengono visualizzati nella system.query.history tabella per l'identificazione e l'analisi delle query.

Per aggiungere tag di query alla connessione, includere il ssp_query_tags parametro nella configurazione della connessione ODBC:

Definire i tag di query come coppie chiave-valore delimitate da virgole, in cui ogni chiave e valore è separato da due punti. Ad esempio: ssp_query_tags=team:engineering,env:prod.

Supporto delle query ANSI SQL-92 in ODBC

I driver ODBC Spark legacy accettano query SQL in dialetto ANSI SQL-92 e le traducono in Databricks SQL prima di inviarle al server.

Se l'applicazione genera direttamente Databricks SQL o usa una sintassi sql-92 non ANSI specifica per Azure Databricks, impostare UseNativeQuery=1 nella configurazione della connessione. Questa impostazione passa le query SQL verbatim a Azure Databricks senza traduzione.

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

Il driver ODBC 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.

Quando si esegue una query, Azure Databricks archivia i risultati nell'archiviazione cloud dell'area di lavoro come file serializzati con freccia fino a 20 MB. Al termine della query, il driver invia richieste di recupero e Azure Databricks restituisce URL della firma di accesso condiviso ai file di risultato. Il driver usa quindi questi URL per scaricare i risultati direttamente dalla risorsa di archiviazione Azure.

Il recupero cloud si applica solo ai risultati delle query superiori a 1 MB. Il driver recupera risultati più piccoli direttamente da Azure Databricks.

Azure Databricks garbage collect raccoglie automaticamente i file accumulati contrassegnandoli per l'eliminazione dopo 24 ore e rimuovendoli definitivamente 24 ore dopo.

Prerequisiti di rete

Se la rete è privata, è necessario configurare le impostazioni seguenti per il funzionamento di Cloud Fetch:

• Consentire *.blob.core.windows.net e *.store.core.windows.net nell'ambiente di rete.
• Aggiungere i download e le revoche di certificati necessari all'elenco elementi consentiti.
• Se il supporto del firewall è abilitato nell'account di archiviazione dell'area di lavoro Azure Databricks, configurare un gateway dati di rete virtuale o un gateway dati on-premises per consentire l'accesso privato all'account di archiviazione.

Per disabilitare Cloud Fetch, impostare EnableQueryResultDownload=0 nella configurazione della connessione.

Diagnosticare i download lenti

Impostare LogLevel su 4 (INFO) e LogPath sul percorso completo di una cartella di log per visualizzare le metriche di velocità di download di Recupero cloud. Il driver registra la velocità di download per blocco, quindi set di risultati di grandi dimensioni generano più righe di log. Il driver registra anche un avviso quando la velocità scende al di sotto di circa 1 MB/s. Questa funzionalità è disponibile nelle versioni del driver ODBC rilasciate dopo novembre 2025.

Se i download sono lenti o bloccati, i token di firma di accesso condiviso possono scadere prima che il driver termini il download di tutti i file di risultato. Verificare la limitazione della larghezza di banda o la congestione della rete tra il client e Archiviazione BLOB di Azure.

Abilitazione della registrazione

Per abilitare la registrazione nel driver ODBC, impostare la LogLevel proprietà su un valore compreso tra 1 (solo eventi gravi) e 6 (tutte le attività del driver). Impostare la LogPath proprietà sul percorso completo della cartella in cui si desidera salvare i file di log.

Per altre informazioni, vedere Configuring Logging Options in a Non-Windows Machine nella Guida al driver ODBC di Databricks.