Pular para o conteúdo principal

any

Introduzido em: v1.1.0 Seleciona o primeiro valor encontrado em uma coluna.
Como uma consulta pode ser executada em qualquer ordem, o resultado desta função é não determinístico. Se você precisar de um resultado arbitrário, mas determinístico, use as funções min ou max.
Por padrão, a função nunca retorna NULL, ou seja, ignora valores NULL na coluna de entrada. No entanto, se a função for usada com o modificador RESPECT NULLS, ela retorna o primeiro valor lido, independentemente de ser NULL ou não. Detalhes de implementação Em alguns casos, você pode confiar na ordem de execução. Isso se aplica aos casos em que o SELECT vem de uma subconsulta que usa ORDER BY. Quando uma consulta SELECT tem a cláusula GROUP BY ou pelo menos uma função de agregação, o ClickHouse (ao contrário do MySQL) exige que todas as expressões nas cláusulas SELECT, HAVING e ORDER BY sejam calculadas a partir de chaves ou de funções de agregação. Em outras palavras, cada coluna selecionada da tabela deve ser usada nas chaves ou dentro de funções de agregação. Para obter um comportamento semelhante ao do MySQL, você pode colocar as outras colunas na função de agregação any.
O tipo de retorno da função é o mesmo da entrada, exceto por LowCardinality, que é descartado. Isso significa que, se não houver linhas na entrada, ela retornará o valor padrão desse tipo (0 para inteiros ou Null para uma coluna Nullable()). Você pode usar o combinador -OrNull para modificar esse comportamento.
Sintaxe
any(column)[ RESPECT NULLS]
Aliases: any_value, first_value Argumentos
  • column — O nome da coluna. Any
Valor retornado Retorna o primeiro valor encontrado. Any Exemplos Exemplo de uso
Query
CREATE TABLE tab (city Nullable(String)) ENGINE=Memory;
INSERT INTO tab (city) VALUES (NULL), ('Amsterdam'), ('New York'), ('Tokyo'), ('Valencia'), (NULL);
SELECT any(city), anyRespectNulls(city) FROM tab;
Response
┌─any(city)─┬─anyRespectNulls(city)─┐
│ Amsterdam │ ᴺᵁᴸᴸ                  │
└───────────┴───────────────────────┘
Última modificação em 10 de junho de 2026