Skip to main content
Dans ce guide, vous apprendrez à utiliser les tableaux dans ClickHouse, ainsi que quelques-unes des fonctions de tableau les plus couramment utilisées.

​
Introduction aux tableaux

Un tableau est une structure de données en mémoire qui regroupe des valeurs. On appelle ces valeurs les éléments du tableau, et chaque élément peut être désigné par un indice, qui indique sa position dans cet ensemble. Dans ClickHouse, les tableaux peuvent être créés à l’aide de la fonction array :
Ou bien, en utilisant [] :
Par exemple, vous pouvez créer un tableau de nombres :
Ou un tableau de chaînes :
Ou un tableau de types imbriqués tels que des tuples:
Vous pourriez être tenté de créer un tableau contenant différents types, comme ceci :
Cependant, les éléments d’un tableau doivent toujours avoir un super-type commun, c’est-à-dire le plus petit type de données capable de représenter sans perte des valeurs de deux types ou plus, afin de pouvoir les utiliser ensemble. S’il n’existe pas de super-type commun, une exception sera renvoyée lorsque vous tenterez de constituer le tableau :
lors de la création de tableaux à la volée, ClickHouse choisit le type le plus spécifique compatible avec tous les éléments. Par exemple, si vous créez un tableau d’entiers et de nombres à virgule flottante, un supertype flottant est choisi :
Vous pouvez utiliser le paramètre use_variant_as_common_type pour modifier le comportement par défaut décrit ci-dessus. Cela permet d’utiliser le type Variant comme type de résultat pour les fonctions if/multiIf/array/map lorsqu’il n’existe aucun type commun entre les types d’argument.Par exemple :
Vous pouvez ensuite extraire du tableau les valeurs par nom de type :
La notation d’indexation [] offre un moyen pratique d’accéder aux éléments d’un tableau. Dans ClickHouse, il est important de savoir que l’indice d’un tableau commence toujours à 1. Cela peut différer d’autres langages de programmation auxquels vous êtes habitué, où les tableaux sont indexés à partir de zéro. Par exemple, étant donné un tableau, vous pouvez en sélectionner le premier élément en écrivant :
Il est également possible d’utiliser des indices négatifs. Vous pouvez ainsi sélectionner des éléments par rapport au dernier élément :
Bien que les tableaux soient indexés à partir de 1, vous pouvez tout de même accéder à l’élément en position 0. La valeur renvoyée sera la valeur par défaut du type de tableau. Dans l’exemple ci-dessous, une chaîne vide est renvoyée, car il s’agit de la valeur par défaut du type de données String :

​
Fonctions de tableau

ClickHouse propose de nombreuses fonctions utiles pour manipuler les tableaux. Dans cette section, nous allons passer en revue quelques-unes des plus utiles, en commençant par les plus simples pour aller vers les plus complexes.

​
fonctions length, arrayEnumerate, indexOf, has*

La fonction length renvoie le nombre d’éléments du tableau :
Vous pouvez également utiliser la fonction arrayEnumerate pour retourner un tableau contenant les indices des éléments :
Si vous souhaitez trouver la position d’une valeur particulière, vous pouvez utiliser la fonction indexOf :
Notez que cette fonction renverra le premier indice trouvé s’il existe plusieurs valeurs identiques dans le tableau. Si les éléments de votre tableau sont triés par ordre croissant, vous pouvez utiliser la fonction indexOfAssumeSorted. Les fonctions has, hasAll et hasAny sont utiles pour déterminer si un tableau contient une valeur donnée. Prenons l’exemple suivant :

​
Exploration des données de vol avec les fonctions de tableau

Jusqu’ici, les exemples étaient assez simples. L’utilité des tableaux apparaît vraiment lorsqu’ils sont appliqués à un jeu de données réel. Nous allons utiliser le jeu de données ontime, qui contient des données de vol du Bureau of Transportation Statistics. Vous trouverez ce jeu de données dans le SQL playground. Nous avons choisi ce jeu de données, car les tableaux sont souvent bien adaptés aux données de séries temporelles et peuvent aider à simplifier des requêtes autrement complexes.
Cliquez sur le bouton “play” ci-dessous pour exécuter les requêtes directement dans la documentation et voir le résultat en direct.

​
groupArray

Ce jeu de données comporte de nombreuses colonnes, mais nous allons nous concentrer sur un sous-ensemble de colonnes. Exécutez la requête ci-dessous pour voir à quoi ressemblent les données : Examinons les 10 aéroports les plus fréquentés des États-Unis un jour donné choisi au hasard, par exemple ‘2024-01-01’. Nous voulons savoir combien de vols partent de chaque aéroport. Nos données contiennent une ligne par vol, mais il serait pratique de pouvoir regrouper les données par aéroport d’origine et de rassembler les destinations dans un tableau. Pour ce faire, nous pouvons utiliser la fonction d’agrégation groupArray, qui prend les valeurs de la colonne spécifiée pour chaque ligne et les regroupe dans un tableau. Exécutez la requête ci-dessous pour voir comment cela fonctionne : La fonction toStringCutToZero dans la requête ci-dessus sert à supprimer les caractères nuls qui apparaissent après le code à 3 lettres de certains aéroports. Avec les données sous cette forme, nous pouvons facilement classer les aéroports les plus fréquentés en calculant la longueur des tableaux « Destinations » agrégés :

​
arrayMap et arrayZip

Nous avons vu dans la requête précédente que l’aéroport international de Denver était celui qui comptait le plus de vols au départ pour la journée choisie. Voyons maintenant combien de ces vols étaient à l’heure, retardés de 15 à 30 minutes ou retardés de plus de 30 minutes. Dans ClickHouse, de nombreuses fonctions de tableau sont ce que l’on appelle des “fonctions d’ordre supérieur” et acceptent une fonction lambda comme premier paramètre. La fonction arrayMap en est un exemple : elle renvoie un nouveau tableau à partir du tableau fourni en appliquant une fonction lambda à chaque élément du tableau d’origine. Exécutez la requête ci-dessous, qui utilise la fonction arrayMap, pour voir quels vols étaient retardés ou à l’heure. Pour chaque paire origine/destination, elle affiche le numéro de queue et le statut de chaque vol : Dans la requête ci-dessus, la fonction arrayMap prend un tableau à un seul élément [DepDelayMinutes] et applique la fonction lambda d -> if(d >= 30, 'DELAYED', if(d >= 15, 'WARNING', 'ON-TIME' pour le catégoriser. Ensuite, le premier élément du tableau résultant est extrait avec [DepDelayMinutes][1]. La fonction arrayZip combine le tableau Tail_Number et le tableau statuses en un seul tableau.

​
arrayFilter

Ensuite, nous allons examiner uniquement le nombre de vols retardés de 30 minutes ou plus pour les aéroports DEN, ATL et DFW : Dans la requête ci-dessus, nous passons une fonction lambda comme premier argument à la fonction arrayFilter. Cette fonction lambda prend elle-même le retard en minutes (d) et renvoie 1 si la condition est remplie, sinon 0.

​
arraySort et arrayIntersect

Ensuite, nous allons déterminer quelles paires de grands aéroports américains desservent le plus de destinations en commun à l’aide des fonctions arraySort et arrayIntersect. arraySort prend un tableau et trie ses éléments par défaut dans l’ordre croissant, même s’il est également possible de lui passer une fonction lambda pour définir l’ordre de tri. arrayIntersect prend plusieurs tableaux et renvoie un tableau contenant les éléments présents dans tous les tableaux. Exécutez la requête ci-dessous pour voir ces deux fonctions de tableau en action : La requête fonctionne en deux grandes étapes. D’abord, elle crée un jeu de données temporaire appelé airport_routes à l’aide d’une expression de table commune (CTE), qui examine tous les vols du 1er janvier 2024 et construit, pour chaque aéroport d’origine, une liste triée de toutes les destinations uniques qu’il dessert. Dans le jeu de résultats airport_routes, par exemple, DEN peut avoir un tableau contenant toutes les villes qu’il dessert, comme ['ATL', 'BOS', 'LAX', 'MIA', ...], et ainsi de suite. Dans la deuxième étape, la requête prend cinq grands hubs aéroportuaires américains (DEN, ATL, DFW, ORD et LAS) et compare toutes les paires possibles. Elle le fait à l’aide d’un CROSS JOIN, qui crée toutes les combinaisons de ces aéroports. Ensuite, pour chaque paire, elle utilise la fonction arrayIntersect pour identifier les destinations qui apparaissent dans les listes des deux aéroports. La fonction length compte le nombre de destinations qu’ils ont en commun. La condition a1.Origin < a2.Origin garantit que chaque paire n’apparaît qu’une seule fois. Sans cela, vous obtiendriez à la fois JFK-LAX et LAX-JFK comme résultats distincts, ce qui serait redondant puisqu’ils représentent la même comparaison. Enfin, la requête trie les résultats pour montrer quelles paires d’aéroports ont le plus grand nombre de destinations communes et ne renvoie que les 10 premières. Cela met en évidence les grands hubs dont les réseaux de liaisons se recoupent le plus, ce qui peut indiquer des marchés concurrentiels où plusieurs compagnies aériennes desservent les mêmes paires de villes, ou des hubs qui desservent des régions géographiques similaires et pourraient donc servir de points de correspondance alternatifs pour les voyageurs.

​
arrayReduce

Puisque nous examinons les retards, utilisons une autre fonction de tableau d’ordre supérieur, arrayReduce, pour trouver le retard moyen et le retard maximal pour chaque itinéraire au départ de l’aéroport international de Denver : Dans l’exemple ci-dessus, nous avons utilisé arrayReduce pour déterminer les retards moyen et maximal de différents vols au départ de DEN. arrayReduce applique une fonction d’agrégation, spécifiée dans le premier paramètre de la fonction, aux éléments du tableau fourni, spécifié dans le second paramètre de la fonction.

​
arrayJoin

Les fonctions classiques de ClickHouse ont la propriété de renvoyer le même nombre de lignes qu’elles en reçoivent. Il existe toutefois une fonction intéressante et unique qui enfreint cette règle, et qui mérite d’être connue : la fonction arrayJoin. arrayJoin « déplie » un tableau en créant une ligne distincte pour chaque élément. Cela s’apparente aux fonctions SQL UNNEST ou EXPLODE dans d’autres bases de données. Contrairement à la plupart des fonctions de tableau, qui renvoient des tableaux ou des valeurs scalaires, arrayJoin modifie fondamentalement le jeu de résultats en multipliant le nombre de lignes. Considérez la requête ci-dessous, qui renvoie un tableau de valeurs de 0 à 100 par pas de 10. On peut considérer que ce tableau représente différents temps de retard : 0 minute, 10 minutes, 20 minutes, etc. Nous pouvons écrire une requête utilisant arrayJoin pour déterminer combien de retards il y a eu jusqu’à ce nombre de minutes entre deux aéroports. La requête ci-dessous crée un histogramme montrant la distribution des retards de vol de Denver (DEN) à Miami (MIA) le 1er janvier 2024, en utilisant des buckets de retard cumulatifs : Dans la requête ci-dessus, nous renvoyons un tableau de retards à l’aide d’une clause CTE (clause WITH). Destination convertit le code de destination en chaîne de caractères. Nous utilisons arrayJoin pour déplier le tableau de retards en lignes distinctes. Chaque valeur du tableau delay devient sa propre ligne avec l’alias del, et nous obtenons 10 lignes : une pour del=0, une pour del=10, une pour del=20, etc. Pour chaque seuil de retard (del), la requête compte combien de vols avaient des retards supérieurs ou égaux à ce seuil à l’aide de countIf(DepDelayMinutes >= del). arrayJoin a également un équivalent en SQL : ARRAY JOIN. La requête ci-dessus est reproduite ci-dessous avec l’équivalent SQL à des fins de comparaison :

​
Étapes suivantes

Félicitations ! Vous avez appris à utiliser les tableaux dans ClickHouse, de la création et de l’indexation de tableaux simples à des fonctions puissantes comme groupArray, arrayFilter, arrayMap, arrayReduce et arrayJoin. Pour aller plus loin, consultez la référence complète des fonctions de tableau afin de découvrir d’autres fonctions comme arrayFlatten, arrayReverse et arrayDistinct. Vous pouvez également vous intéresser à des structures de données connexes, comme les tuples et les types JSON et Map, qui s’utilisent très bien avec les tableaux. Exercez-vous à appliquer ces concepts à vos propres jeux de données, et testez différentes requêtes dans le SQL playground ou sur d’autres jeux de données d’exemple. Les tableaux sont une fonctionnalité fondamentale de ClickHouse qui permettent d’effectuer des requêtes analytiques efficaces. À mesure que vous vous familiariserez avec les fonctions de tableau, vous constaterez qu’elles peuvent considérablement simplifier des aggregations complexes et l’analyse de séries temporelles. Pour aller encore plus loin sur les tableaux, nous vous recommandons la vidéo YouTube ci-dessous de Mark, notre expert data :
Dernière modification le 3 juillet 2026