configurações de sessão join_*

Essas configurações estão disponíveis em system.settings e são geradas automaticamente com base no código-fonte. Especifica qual algoritmo de JOIN é usado. Vários algoritmos podem ser especificados, e um deles será escolhido para uma consulta específica com base em kind/strictness e no motor de tabela. Valores possíveis:

• grace_hash

Grace hash join é usado. O Grace hash oferece uma opção de algoritmo que permite executar junções complexas com bom desempenho, limitando o uso de memória. A primeira fase de uma grace join lê a tabela da direita e a divide em N buckets, dependendo do valor de hash das colunas-chave (inicialmente, N é grace_hash_join_initial_buckets). Isso é feito de forma a garantir que cada bucket possa ser processado de maneira independente. As linhas do primeiro bucket são adicionadas a uma tabela hash em memória, enquanto as demais são salvas em disco. Se a tabela hash crescer além do limite de memória (por exemplo, conforme definido por max_bytes_in_join), o número de buckets será aumentado, assim como o bucket atribuído a cada linha. Todas as linhas que não pertencem ao bucket atual são descarregadas e reatribuídas. Oferece suporte a INNER/LEFT/RIGHT/FULL ALL/ANY JOIN.

• hash

O algoritmo hash join é usado. É a implementação mais genérica, compatível com todas as combinações de kind e strictness e com várias chaves de junção combinadas com OR na seção JOIN ON. Ao usar o algoritmo hash, a parte direita de JOIN é carregada na RAM.

• parallel_hash

Uma variação de hash join que divide os dados em buckets e constrói simultaneamente várias tabelas hash em vez de apenas uma, para acelerar esse processo. Ao usar o algoritmo parallel_hash, a parte direita de JOIN é carregada na RAM.

• partial_merge

Uma variação do algoritmo sort-merge, em que apenas a tabela da direita é totalmente ordenada. RIGHT JOIN e FULL JOIN têm suporte apenas com strictness ALL (SEMI, ANTI, ANY e ASOF não têm suporte). Ao usar o algoritmo partial_merge, o ClickHouse ordena os dados e os grava em disco. O algoritmo partial_merge no ClickHouse difere ligeiramente da implementação clássica. Primeiro, o ClickHouse ordena a tabela da direita pelas chaves de junção em blocos e cria um índice min-max para os blocos ordenados. Em seguida, ordena partes da tabela da esquerda pela join key e faz a junção com a tabela da direita. O índice min-max também é usado para ignorar blocos desnecessários da tabela da direita.

• direct

O algoritmo direct (também conhecido como nested loop) realiza um lookup na tabela da direita usando as linhas da tabela da esquerda como chaves. É compatível com armazenamentos especiais, como tabelas Dicionário, EmbeddedRocksDB e MergeTree. Para tabelas MergeTree, o algoritmo envia filtros de chave de junção diretamente para a camada de armazenamento. Isso pode ser mais eficiente quando a chave pode usar o índice de chave primária da tabela para lookups; caso contrário, ele executa varreduras completas na tabela da direita para cada bloco da tabela da esquerda. Oferece suporte a junções INNER e LEFT e apenas a chaves de junção de igualdade de uma única coluna, sem outras condições.

• auto

Quando definido como auto, hash join é tentado primeiro, e o algoritmo é alterado dinamicamente para outro algoritmo se o limite de memória for excedido.

• full_sorting_merge

Algoritmo sort-merge com ordenação completa das tabelas unidas antes da junção.

• prefer_partial_merge

O ClickHouse sempre tenta usar partial_merge join, se possível; caso contrário, usa hash. Descontinuado; é o mesmo que partial_merge,hash.

• default (descontinuado)

Valor legado; não use mais. O mesmo que direct,hash, ou seja, tente usar direct join e hash join (nessa ordem). Altera o comportamento das operações JOIN com strictness ANY quando a tabela da direita tem mais de uma linha correspondente para uma chave. Valores possíveis:

• 0 — Se a tabela da direita tiver mais de uma linha correspondente, apenas a primeira encontrada será combinada.
• 1 — Se a tabela da direita tiver mais de uma linha correspondente, apenas a última encontrada será combinada.

Veja também:

• cláusula JOIN
• motor de tabela Join
• join_default_strictness

Define a strictness padrão das cláusulas JOIN. Valores possíveis:

• ALL — Se a tabela da direita tiver várias linhas correspondentes, o ClickHouse cria um produto cartesiano com as linhas correspondentes. Esse é o comportamento normal de JOIN no SQL padrão.
• ANY — Se a tabela da direita tiver várias linhas correspondentes, somente a primeira encontrada é combinada. Se a tabela da direita tiver apenas uma linha correspondente, os resultados de ANY e ALL serão os mesmos.
• ASOF — Para junção de sequências com correspondência incerta.
• Empty string — Se ALL ou ANY não for especificado na consulta, o ClickHouse lança uma exceção.

Limita o número de arquivos permitidos para a ordenação paralela em operações MergeJoin quando são executadas em disco. Quanto maior o valor da configuração, mais RAM é usada e menos E/S de disco é necessária. Valores possíveis:

• Qualquer número inteiro positivo, a partir de 2.

O limite inferior da média de linhas por chave na tabela à direita para determinar se a saída deve ser feita por lista de linhas em hash join. Define qual ação o ClickHouse executa quando um JOIN atinge qualquer um dos seguintes limites:

• max_bytes_in_join
• max_rows_in_join

Essa configuração só é considerada para os valores hash e parallel_hash de join_algorithm. Outros algoritmos (por exemplo, partial_merge, grace_hash, auto) lidam com esses limites de outra forma — fazendo spill para disco, reparticionando ou mudando de estratégia — veja join_algorithm. Valores possíveis:

• THROW — o ClickHouse lança uma exceção e interrompe a consulta.
• BREAK — o ClickHouse interrompe a consulta e não lança uma exceção.

Valor padrão: THROW. Veja também

• cláusula JOIN
• motor de tabela Join

Define o comportamento de JOIN. Ao combinar tabelas, células vazias podem aparecer. O ClickHouse as preenche de forma diferente com base nessa configuração. Valores possíveis:

• 0 — As células vazias são preenchidas com o valor padrão do tipo de campo correspondente.
• 1 — JOIN se comporta da mesma forma que no SQL padrão. O tipo do campo correspondente é convertido para Nullable, e as células vazias são preenchidas com NULL.