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.
Si applica a:
Databricks SQL
Un parametro di configurazione è un'impostazione che influisce sul comportamento di Databricks SQL all'esterno della sintassi SQL specificata.
Il valore effettivo di un parametro di configurazione è derivato dai diversi livelli in cui è impostato.
Ambiti dei parametri di configurazione
Sistema
Il valore di sistema è il valore predefinito usato da Databricks SQL se non è presente alcuna sostituzione.
Globale
Un amministratore può sovrascrivere il valore predefinito del sistema per un parametro usando Configura i parametri SQL o l'API SQL Warehouse. Questo valore è quindi il valore iniziale visualizzato da qualsiasi sessione appena stabilita in futuro.
Sessione
Un utente può sovrascrivere un parametro di configurazione per tutta la durata della sessione con l'istruzioneSET. Alcuni parametri hanno un'istruzione dedicata, come SET PATH o SET TIME ZONE. L'impostazione rimane attiva finché l'utente non la sovrascrive nuovamente o non utilizza RESET.
Parametri di configurazione supportati
Di seguito è riportato un elenco dei parametri di configurazione supportati che è possibile impostare in Databricks SQL, le relative impostazioni predefinite di sistema e i livelli che è possibile impostare. Databricks SQL non supporta l'impostazione delle configurazioni di Spark non elencate.
| Nome del parametro | Descrizione | Predefinito del sistema | Impostabile a livello globale | Impostazioni di sessione |
|---|---|---|---|---|
| ANSI_MODE | Consente di disabilitare un comportamento SQL ANSI rigoroso per determinate funzioni e regole di casting. | Vero | Sì | Sì |
| LEGACY_TIME_PARSER_POLICY | Controlla la modalità di analisi e formattazione dei timestamp e della data. | eccezione | Sì | Sì |
| MAX_FILE_PARTITION_BYTES | Numero massimo di byte da comprimere in una singola partizione durante la lettura da origini basate su file. | 128m | NO | Sì |
| PATH | Imposta il percorso di ricerca dello schema usato per risolvere i nomi non qualificati. | system.session, system.builtin, system.ai, CURRENT_SCHEMA |
Sì | Sì |
| READ_ONLY_EXTERNAL_METASTORE | Controlla se un metastore esterno viene considerato di sola lettura. | Falso | Sì | NO |
| STATEMENT_TIMEOUT | Imposta il tempo massimo di esecuzione per un'istruzione SQL in secondi. | 172800 secondi | Sì | Sì |
| TIMEZONE | Imposta il fuso orario locale. | UTC | Sì | Sì |
| USE_CACHED_RESULT | Controlla se Databricks SQL memorizza nella cache e riutilizza i risultati quando possibile. | Vero | NO | Sì |
Il valore predefinito del ANSI_MODE sistema è FALSE per gli account aggiunti prima di Databricks SQL 2022.35.