Parametri di configurazione
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
Di sistema
Il valore di sistema è il valore predefinito usato da Databricks SQL se non è presente alcuna sostituzione.
Global
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ò eseguire l'override di un parametro di configurazione temporaneamente all'interno di un ambito di sessione usando l'istruzione SET. L'impostazione rimane attiva per la durata della sessione, a meno che l'utente non la sovrascriva nuovamente con un'istruzione SET o 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 parametro | Descrizione | Predefinito del sistema | Tabella impostata a livello globale | Sessione impostabile |
|---|---|---|---|---|
| ANSI_MODE | Consente di disabilitare un comportamento SQL ANSI rigoroso per determinate funzioni e regole di cast. | TRUE | Sì | Sì |
| LEGACY_TIME_PARSER_POLICY | Controlla la modalità di analisi e formattazione dei timestamp e della data. | EXCEPTION | 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ì |
| READ_ONLY_EXTERNAL_METASTORE | Controlla se un metastore esterno viene considerato di sola lettura. | FALSE | Sì | No |
| STATEMENT_TIMEOUT | Imposta un timeout dell'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. | TRUE | No | Sì |
Il valore predefinito del ANSI_MODE sistema è FALSE per gli account aggiunti prima di Databricks SQL 2022.35.