Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
- Tag di query per il rilevamento
- Supporto delle query ANSI SQL-92 in ODBC
- Estrarre risultati di query di grandi dimensioni in ODBC
- Serializzazione delle frecce in ODBC
- Recupero cloud in ODBC
- Abilitazione della registrazione
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
Importante
Questa funzionalità si trova in anteprima privata. Per richiedere l'accesso, contattare il team di account.
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.
Annotazioni
Il recupero cloud è disponibile solo per aws e Azure aree di lavoro.
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 i garbage collection accumulati automaticamente, contrassegnandoli per l'eliminazione dopo 24 ore e eliminandoli definitivamente dopo altre 24 ore.
Prerequisiti di rete
Se la rete è privata, è necessario configurare le impostazioni seguenti per il funzionamento di Cloud Fetch:
- Consentire
*.blob.core.windows.nete*.store.core.windows.netnell'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.
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.