Categorias:: Funções de agregação (General) , Funções de janela

MAX¶

Retorna o valor máximo para os registros dentro de expr. NULL são ignorados, a menos que todos os registros sejam NULL, caso em que um valor NULL é retornado.

Consulte também:: COUNT , SUM , MIN

Sintaxe¶

Função de agregação

MAX( <expr> )

Função de janela

MAX( <expr> ) [ OVER ( [ PARTITION BY <expr1> ] [ ORDER BY <expr2> [ { ASC | DESC } ] [ NULLS { FIRST | LAST } ] [ <window_frame> ] ] ) ]

Para uma sintaxe window_frame detalhada, consulte Sintaxe e uso da função de janela.

Retornos¶

O tipo de dados do valor retornado é o mesmo que o tipo de dados dos valores de entrada.

Notas de uso¶

Para compatibilidade com outros sistemas, você pode especificar a palavra-chave DISTINCT como argumento para a função, mas ela não tem nenhum efeito.
Se a função for chamada como uma função de janela, a janela pode incluir um window_frame opcional. O window_frame (seja cumulativo ou deslizante) especifica o subconjunto de linhas dentro da janela para o qual os valores somados são retornados. Se nenhum window_frame for especificado, o padrão é o seguinte quadro cumulativo de janela (de acordo com o padrão ANSI para funções de janela):

RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

Para obter mais detalhes sobre quadros de janela, incluindo sintaxe e exemplos, consulte Notas de uso para quadros de janela.

Detalhes do agrupamento¶

The comparisons follow the collation based on the input arguments” collations and precedences.
The collation of the result is the same as the collation of the input.

Exemplos¶

Os exemplos a seguir demonstram como utilizar a função MAX.

Criar uma tabela e dados:

CREATE OR REPLACE TABLE sample_table (k CHAR(4), d CHAR(4));

INSERT INTO sample_table VALUES
  ('1', '1'), ('1', '5'), ('1', '3'),
  ('2', '2'), ('2', NULL),
  ('3', NULL),
  (NULL, '7'), (NULL, '1');

Exibir os dados:

SELECT k, d
  FROM sample_table
  ORDER BY k, d;

+------+------+
| K    | D    |
|------+------|
| 1    | 1    |
| 1    | 3    |
| 1    | 5    |
| 2    | 2    |
| 2    | NULL |
| 3    | NULL |
| NULL | 1    |
| NULL | 7    |
+------+------+

Use a função MAX para recuperar o maior valor na coluna denominada d:

SELECT MAX(d)
  FROM sample_table;

+--------+
| MAX(D) |
|--------|
| 7      |
+--------+

Combine a cláusula GROUP BY com a função MAX para recuperar os maiores valores em cada grupo (onde cada grupo é baseado no valor da coluna k):

SELECT k, MAX(d)
  FROM sample_table
  GROUP BY k
  ORDER BY k;

+------+--------+
| K    | MAX(D) |
|------+--------|
| 1    | 5      |
| 2    | 2      |
| 3    | NULL   |
| NULL | 7      |
+------+--------+

Use a PARTITION BY clause to break the data into groups based on the value of k. This is similar to, but not identical to, using GROUP BY. In particular, GROUP BY produces one output row per group, while PARTITION BY produces one output row per input row.

SELECT k, d, MAX(d) OVER (PARTITION BY k)
  FROM sample_table
  ORDER BY k, d;

+------+------+------------------------------+
| K    | D    | MAX(D) OVER (PARTITION BY K) |
|------+------+------------------------------|
| 1    | 1    | 5                            |
| 1    | 3    | 5                            |
| 1    | 5    | 5                            |
| 2    | 2    | 2                            |
| 2    | NULL | 2                            |
| 3    | NULL | NULL                         |
| NULL | 1    | 7                            |
| NULL | 7    | 7                            |
+------+------+------------------------------+

Use uma cláusula de janela ORDER BY para criar uma janela deslizante com duas linhas de largura, e produza o valor mais alto dentro daquela janela. (Lembre-se de que ORDER BY na cláusula de janela é separado de ORDER BY no nível de instrução). Este exemplo usa uma única partição, portanto não há cláusula PARTITION BY na cláusula OVER().

SELECT k, d, MAX(d) OVER (ORDER BY k, d ROWS BETWEEN 1 PRECEDING AND CURRENT ROW)
  FROM sample_table
  ORDER BY k, d;

+------+------+----------------------------------------------------------------------+
| K    | D    | MAX(D) OVER (ORDER BY K, D ROWS BETWEEN 1 PRECEDING AND CURRENT ROW) |
|------+------+----------------------------------------------------------------------|
| 1    | 1    | 1                                                                    |
| 1    | 3    | 3                                                                    |
| 1    | 5    | 5                                                                    |
| 2    | 2    | 5                                                                    |
| 2    | NULL | 2                                                                    |
| 3    | NULL | NULL                                                                 |
| NULL | 1    | 1                                                                    |
| NULL | 7    | 7                                                                    |
+------+------+----------------------------------------------------------------------+