Partilhar via


Parâmetros de configuração

Aplica-se a:Marcado como Sim Databricks SQL

Um parâmetro de configuração é uma configuração que afeta o comportamento do Databricks SQL fora da sintaxe SQL especificada.

O valor efetivo de um parâmetro de configuração é derivado dos diferentes níveis onde ele é definido.

Escopos de parâmetros de configuração

  • Sistema

    O valor do sistema é o valor padrão usado pelo Databricks SQL se não houver substituição.

  • A nível mundial

    Um administrador pode mudar o valor padrão do sistema para um parâmetro usando o Configurar parâmetros SQL ou a API SQL Warehouse. Esse valor passa a 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 dentro de 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 sobreponha novamente com uma declaração SET ou RESET.

Parâmetros de configuração suportados

A seguir está uma lista dos parâmetros de configuração suportados que você pode definir no Databricks SQL, seus padrões de sistema e em quais níveis eles podem ser definidos. O Databricks SQL não oferece suporte à definição de configurações do Spark que não estão listadas.

Nome do parâmetro Descrição Predefinição do sistema Globalmente configurável Ajustável na sessão
ANSI_MODE Permite desativar o comportamento estrito do ANSI SQL para determinadas funções e regras de conversão. VERDADEIRO Sim Sim
LEGACY_TIME_PARSER_POLICY Controla como as datas e horas são interpretadas e formatadas. EXCEÇÃO Sim Sim
MAX_FILE_PARTITION_BYTES O número máximo de bytes para empacotar numa única partição quando lê de fontes baseadas em ficheiros. 128 metros Não Sim
READ_ONLY_EXTERNAL_METASTORE Controla se um metastore externo é tratado como de leitura somente. FALSO Sim Não
STATEMENT_TIMEOUT Define um tempo limite de instrução SQL em segundos 172800 segundos Sim Sim
TIMEZONE Define o fuso horário local. UTC Sim Sim
USE_CACHED_RESULT Controla se o Databricks SQL armazena em cache e reutiliza os resultados sempre que possível. VERDADEIRO Não Sim

O ANSI_MODE valor padrão do sistema é FALSE para contas adicionadas antes do Databricks SQL 2022.35.