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 utilizador pode sobrepor um parâmetro de configuração durante a duração da sessão com a SET instrução. Alguns parâmetros têm uma instrução dedicada, como SET PATH ou SET TIME ZONE. A definição mantém-se ativa até que o utilizador a sobrepune novamente ou use 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
CAMINHO Define o caminho de pesquisa do esquema usado para resolver nomes não qualificados. system.session, system.builtin, system.ai, CURRENT_SCHEMA Sim 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.

  • Última atualização a