Condividi tramite

Parametri di configurazione

  • Articolo

Si applica a: segno di spunta sì 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 SET. L'impostazione rimane attiva per la durata della sessione, a meno che l'utente non esegua nuovamente l'override 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ì
ENABLE_PHOTON Controlla l'utilizzo del motore di query vettorializzato Photon. TRUE No 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ì
FUSO ORARIO 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.