Parâmetros de configuração

  • Artigo

Aplica-se a:marca de seleção positiva 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.