Partilhar via

Configuração parameters

  • Artigo

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 where é set.

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 o Configurar SQL parameters ou SQL Warehouse API. 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 a sobreponha novamente com uma declaração SET ou RESET.

Configuração suportada parameters

A seguir, encontra-se uma list das configurações suportadas parameters que pode-se set no Databricks SQL, os seus padrões de sistema e os níveis em que podem ser set. 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 a serem empacotados em um único partition ao ler de fontes baseadas em arquivos. 128 milhões Não Sim
READ_ONLY_EXTERNAL_METASTORE Controla se um metastore externo é tratado como somente leitura. FALSE 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. TRUE Não Sim

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