Parámetros de configuración
Se aplica a:
Databricks SQL
Un parámetro de configuración es un valor que afecta al comportamiento de Databricks SQL fuera de la sintaxis SQL especificada.
El valor efectivo de un parámetro de configuración se deriva de los distintos niveles donde se establece.
Ámbitos de los parámetros de configuración
Sistema
El valor del sistema es el valor predeterminado que usa Databricks SQL si no hay ninguna invalidación.
Operaciones
Un administrador puede invalidar el valor predeterminado del sistema para un parámetro mediante el Configurar parámetros SQL o API de SQL Warehouse. A continuación, este valor es el valor inicial visto por cualquier sesión recién establecida que avance.
De sesión
Un usuario puede invalidar un parámetro de configuración temporalmente dentro de un ámbito de sesión mediante la instrucción SET. La configuración se mantiene durante toda la sesión a menos que el usuario lo invalide de nuevo con una instrucción SET o RESET.
Parámetros de configuración admitidos
A continuación se muestra una lista de los parámetros de configuración admitidos que se pueden establecer en Databricks SQL, los valores predeterminados del sistema y los niveles en los que se pueden establecer. Databricks SQL no admite la configuración de Spark que no aparece en la lista.
| Nombre de parámetro | Descripción | Valor predeterminado del sistema | Se puede establecer globalmente | Tabla de configuración de sesión |
|---|---|---|---|---|
| ANSI_MODE | Permite deshabilitar el comportamiento estricto de ANSI SQL para determinadas funciones y reglas de conversión. | TRUE | Sí | Sí |
| ENABLE_PHOTON | Controla el uso del motor de consulta vectorial de Photon. | true | No | Sí |
| LEGACY_TIME_PARSER_POLICY | Controla cómo se analizan y da formato a las marcas de tiempo y de fecha. | EXCEPTION | Sí | Sí |
| MAX_FILE_PARTITION_BYTES | El número máximo de bytes a empaquetar en una sola partición cuando se lee de fuentes basadas en archivos. | 128m | No | Sí |
| READ_ONLY_EXTERNAL_METASTORE | Controla si un metastore externo se trata como de solo lectura. | false | Sí | No |
| STATEMENT_TIMEOUT | Establece un tiempo de espera de instrucción SQL en segundos. | 172 800 seconds | Sí | Sí |
| TIMEZONE | Establece la zona horaria local. | UTC | Sí | Sí |
| USE_CACHED_RESULT | Controla si Databricks SQL almacena en caché y reutiliza los resultados siempre que sea posible. | true | No | Sí |
El valor predeterminado del sistema ANSI_MODE es FALSE para las cuentas agregadas antes de Databricks SQL 2022.35.