Partilhar via


Parâmetros de configuração

Aplica-se a: Marque 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 substituir o valor padrão do sistema para um parâmetro usando Configurar parâmetros SQL ou API do SQL Warehouse. Esse valor é, então, o valor inicial visto por qualquer sessão recém-estabelecida no futuro.

  • 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 substitua novamente com uma instruçã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 Description Predefinição do sistema Globalmente configurável Mesa de ajuste da sessão
ANSI_MODE Permite desativar o comportamento ANSI SQL estrito para determinadas funções e regras de transmissão. TRUE Sim Sim
LEGACY_TIME_PARSER_POLICY Controla como os carimbos de data e hora são analisados e formatados. EXCEÇÃO Sim Sim
MAX_FILE_PARTITION_BYTES O número máximo de bytes para empacotar em uma única partição ao ler de fontes baseadas em arquivo. 128 milhões Não Sim
READ_ONLY_EXTERNAL_METASTORE Controla se um metastore externo é tratado como somente leitura. FALSE Sim No
STATEMENT_TIMEOUT Define um tempo limite de instrução SQL em segundos 172800 segundos Sim Sim
FUSO HORÁRIO 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. TRUE Não Sim

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