Parâmetros de configuração
Aplica-se a:
SQL do Databricks
Um parâmetro de configuração é uma configuração que afeta o comportamento do SQL do Databricks fora da sintaxe SQL especificada.
O valor efetivo de um parâmetro de configuração é derivado dos diferentes níveis em que ele é definido.
Escopos do parâmetro de configuração
Sistema
O valor do sistema é o valor padrão usado pelo SQL do Databricks quando não há substituição.
Global
Um administrador pode substituir o valor padrão do sistema para um parâmetro usando a Configuração de parâmetros SQL ou a API de SQL warehouses. A partir deste momento, esse valor será o valor inicial visto por qualquer sessão recém-estabelecida.
Sessão
Um usuário pode substituir um parâmetro de configuração temporariamente em um escopo de sessão usando a instrução SET. A configuração permanece em vigor durante a sessão, a menos que o usuário a substitua novamente com uma instrução SET ou com RESET.
Parâmetros de configuração com suporte
A seguir, temos uma lista dos parâmetros de configuração com suporte que podem ser definidos no Databricks SQL, além dos respectivos padrões de sistema e dos níveis em que eles podem ser definidos. O Databricks SQL não dá suporte à definição de configurações do Spark que não estão listadas.
| Nome do parâmetro | Descrição | Padrão do sistema | Configurável globalmente | Configurável na sessão |
|---|---|---|---|---|
| ANSI_MODE | Permite desabilitar o comportamento estrito de SQL ANSI para determinadas funções e regras de conversão. | TRUE | Sim | Sim |
| LEGACY_TIME_PARSER_POLICY | Controla como os carimbos de data e hora são analisados e formatados. | EXCEPTION | Sim | Yes |
| MAX_FILE_PARTITION_BYTES | O número máximo de bytes a serem empacotados em uma única partição ao ler fontes baseadas em arquivo. | 128 M | No | Sim |
| READ_ONLY_EXTERNAL_METASTORE | Controla se um metastore externo é tratado como somente leitura. | FALSE | Sim | No |
| STATEMENT_TIMEOUT | Define um tempo limite da instrução SQL em segundos | 172800 segundos | Sim | Yes |
| TIMEZONE | Define o fuso horário local. | UTC | Sim | Yes |
| USE_CACHED_RESULT | Controla se o SQL do Databricks armazena em cache e reutiliza os resultados sempre que possível. | TRUE | No | Sim |
O valor padrão do sistema ANSI_MODE para contas adicionadas antes do Databricks SQL 2022.35 é FALSE.