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ò eseguire l'override del valore predefinito del sistema per un parametro usando 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 edizione Standard T. L'impostazione rimane attiva per la durata della sessione, a meno che l'utente non esegua nuovamente l'override con un'istruzione edizione Standard T o RE edizione Standard T.
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ì |
| ENABLE_PHOTON | Controlla l'utilizzo del motore di query vettorializzato Photon. | TRUE | No | Sì |
| LEGACY_TIME_PAR edizione Standard R_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ì |
| FUSO ORARIO | Imposta il fuso orario locale. | UTC | Sì | Sì |
| U edizione Standard_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.