ARRAY_UNION_AGG¶

Syntaxe¶

ARRAY_UNION_AGG( <column> )

Arguments¶

column

La colonne contenant les ARRAYs avec les valeurs distinctes (les ARRAYs produits par ARRAY_UNIQUE_AGG).

Renvoie¶

La fonction renvoie un ARRAY contenant les valeurs distinctes des ARRAYs de column. Les valeurs dans l’ARRAY ne sont pas dans un ordre particulier, et l’ordre n’est pas déterministe.

Notez que cette fonction utilise la sémantique multiset, ce qui signifie que le nombre maximum d’occurrences d’une valeur individuelle dans un seul ARRAY d’entrée détermine le nombre d’occurrences de cette valeur dans l’ARRAY de sortie. Voir des exemples.

La fonction ignore les valeurs NULL dans la column et dans les ARRAYs de column. Si column ne contient que des valeurs NULL ou si la table contenant une column est vide, la fonction renvoie un ARRAY vide.

Notes sur l’utilisation¶

• Cette fonction peut être utilisée comme l’un des types de fonctions suivants :

  • fonction d’agrégation

  • fonction de fenêtre

    Lorsqu’elle est utilisée comme fonction de fenêtre, cette fonction ne prend pas en charge les cadres de fenêtres.

• Lorsque vous transmettez un ARRAY structuré à la fonction, celle-ci renvoie un ARRAY structuré du même type.

Exemples¶

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]           |
+-------------------------+