Catégories :: Fonctions de données semi-structurées (tableau/objet)

ARRAY_SIZE¶

Renvoie la taille du tableau d’entrée.

Une variation de ARRAY_SIZE prend une valeur de VARIANT en entrée. Si la valeur VARIANT contient un tableau, sa taille est renvoyée ; sinon, NULL est renvoyé si la valeur n’est pas un tableau.

Syntaxe¶

ARRAY_SIZE( <array> )

ARRAY_SIZE( <variant> )

Renvoie¶

Le type de données de la valeur renvoyée est INTEGER.

Notes sur l’utilisation¶

Prend une valeur ARRAY en entrée et renvoie la taille du tableau (c’est-à-dire le plus grand index + 1).

Si le tableau est un tableau clairsemé cela signifie que la taille inclut les éléments non définis ainsi que les éléments définis.
Un argument NULL renvoie NULL en conséquence.

Exemples¶

Voici un exemple simple :

SELECT ARRAY_SIZE(ARRAY_CONSTRUCT(1, 2, 3)) AS SIZE;
+------+
| SIZE |
|------|
|    3 |
+------+

Voici un exemple un peu plus complexe, utilisant cette fois le type de données VARIANT :

CREATE OR replace TABLE colors (v variant);

INSERT INTO
   colors
   SELECT
      parse_json(column1) AS v
   FROM
   VALUES
     ('[{r:255,g:12,b:0},{r:0,g:255,b:0},{r:0,g:0,b:255}]'),
     ('[{r:255,g:128,b:0},{r:128,g:255,b:0},{r:0,g:255,b:128},{r:0,g:128,b:255},{r:128,g:0,b:255},{r:255,g:0,b:128}]')
    v;

Récupérez la taille de chaque tableau dans la colonne VARIANT :

SELECT ARRAY_SIZE(v) from colors;
+---------------+
| ARRAY_SIZE(V) |
|---------------|
|             3 |
|             6 |
+---------------+

Récupérez le dernier élément de chaque tableau dans la colonne VARIANT :

SELECT GET(v, ARRAY_SIZE(v)-1) FROM colors;
+-------------------------+
| GET(V, ARRAY_SIZE(V)-1) |
|-------------------------|
| {                       |
|   "b": 255,             |
|   "g": 0,               |
|   "r": 0                |
| }                       |
| {                       |
|   "b": 128,             |
|   "g": 0,               |
|   "r": 255              |
| }                       |
+-------------------------+