Configurazione parameters
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 deriva dai diversi livelli where è set.
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 il Configure SQL parameters o l'API di 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.
Configurazione supportata parameters
Di seguito è riportato un list della configurazione supportata parameters che è possibile set in Databricks SQL, le impostazioni predefinite del sistema e i livelli in cui possono essere set. 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 | Il numero massimo di byte da inserire in un singolo partition durante la lettura da fonti 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.