Condividi tramite


Configurazione parameters

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 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
LEGACY_TIME_PARSER_POLICY Controlla la modalità di analisi e formattazione dei timestamp e della data. EXCEPTION
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
READ_ONLY_EXTERNAL_METASTORE Controlla se un metastore esterno viene considerato di sola lettura. FALSE No
STATEMENT_TIMEOUT Imposta un timeout dell'istruzione SQL in secondi 172800 secondi
TIMEZONE Imposta il fuso orario locale. UTC
USE_CACHED_RESULT Controlla se Databricks SQL memorizza nella cache e riutilizza i risultati quando possibile. TRUE No

Il valore predefinito del ANSI_MODE sistema è FALSE per gli account aggiunti prima di Databricks SQL 2022.35.