Categorias:: Funções de agregação (Counting Distinct Values) , Window functions (Semi-structured Data Aggregation)

ARRAY_UNION_AGG¶

Returns an ARRAY that contains the union of the distinct values from the input arrays in a column. You can use this to aggregate distinct values in arrays produced by ARRAY_UNIQUE_AGG.

Consulte também:: ARRAY_UNIQUE_AGG , Uso de matrizes para computar valores distintos para agregações hierárquicas

Sintaxe¶

Aggregate function

ARRAY_UNION_AGG( <column> )

Copy

Window function

ARRAY_UNION_AGG( <column> ) OVER ( [ PARTITION BY <expr> ] )

Copy

For details about the OVER clause, see Sintaxe e uso da função de janela.

Argumentos¶

column: The column containing the arrays with the distinct values (the arrays produced by ARRAY_UNIQUE_AGG).

Retornos¶

The function returns an array containing the distinct values from the arrays in column. The values in the array are in no particular order, and the order is not deterministic.

Note that this function uses multiset semantics, which means that the maximum number of occurrences of an individual value in a single input array determines the number of occurrences of that value in the output array. See Examples.

The function ignores NULL values in column and in the arrays in column. If column contains only NULL values or the table containing column is empty, the function returns an empty array.

Notas de uso¶

Essa função pode ser usada como um dos seguintes tipos de funções:
- função de agregação.
- função de janela.
Quando esta função é chamada como uma função de janela, ela não oferece suporte a quadros de janela explícitos.
Quando você passa uma matriz estruturada para a função, a função retorna uma matriz estruturada do mesmo tipo.

Exemplos¶

Agregação: união de matrizes¶

The following example illustrates how the function returns the union of distinct values from two arrays:

CREATE TABLE union_test(a array);

INSERT INTO union_test
    SELECT PARSE_JSON('[ 1, 1, 2]')
    UNION ALL
    SELECT PARSE_JSON('[ 1, 2, 3]');

SELECT ARRAY_UNION_AGG(a) FROM union_test;
+-------------------------+
| ARRAY_UNION_AGG(A)      |
+-------------------------+
| [ 1, 1, 2, 3]           |
+-------------------------+

Copy

A operação usa a semântica de multiset. O valor 1 aparece duas vezes na saída porque aparece duas vezes em uma das arrays de entrada.

Consulte Uso de matrizes para computar valores distintos para agregações hierárquicas.