Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonction JSON\$1ARRAY\$1LENGTH
<a name="JSON_ARRAY_LENGTH"></a>

**Note**  
JSON\$1PARSE et ses fonctions associées analysent les valeurs JSON en tant que SUPER, qu’Amazon Redshift analyse plus efficacement que VARCHAR.  
 Au lieu d’utiliser JSON\$1ARRAY\$1LENGTH, nous vous recommandons d’analyser vos chaînes JSON en utilisant [Fonction JSON\$1PARSE](JSON_PARSE.md) pour obtenir une valeur SUPER. Ensuite, utilisez [Fonction GET\$1ARRAY\$1LENGTH](get_array_length.md) pour obtenir la longueur de votre tableau. 

La fonction JSON\$1ARRAY\$1LENGTH renvoie le nombre d’éléments du tableau externe d’une chaîne JSON. Si l’argument *null\$1if\$1invalid* a la valeur `true` et que la chaîne JSON n’est pas valide, la fonction renvoie `NULL` au lieu de renvoyer une erreur.

Pour plus d’informations, consultez [Fonctions JSON](json-functions.md). 

## Syntaxe
<a name="JSON_ARRAY_LENGTH-synopsis"></a>

```
JSON_ARRAY_LENGTH('json_array' [, null_if_invalid ] ) 
```

## Arguments
<a name="JSON_ARRAY_LENGTH-arguments"></a>

 *json\$1array*  
Tableau JSON au bon format.

 *null\$1if\$1invalid*  
(Facultatif) Valeur `BOOLEAN` qui spécifie s’il faut renvoyer `NULL` quand la chaîne JSON en entrée n’est pas valide au lieu de renvoyer une erreur. Pour renvoyer `NULL` si la chaîne JSON n’est pas valide, spécifiez `true` (`t`). Pour renvoyer une erreur si la chaîne JSON n’est pas valide, spécifiez `false` (`f`). La valeur par défaut est `false`.

## Type de retour
<a name="JSON_ARRAY_LENGTH-return"></a>

`INTEGER`

## Exemples
<a name="JSON_ARRAY_LENGTH-examples"></a>

Pour renvoyer le nombre d’éléments du tableau, utilisez l’exemple suivant. 

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14]'); 

+-------------------+
| json_array_length |
+-------------------+
|                 5 |
+-------------------+
```

Pour renvoyer une erreur si la chaîne JSON n’est pas valide, utilisez l’exemple suivant.

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14');
 
ERROR: invalid json array object [11,12,13,{"f1":21,"f2":[25,26]},14
```

Pour définir *null\$1if\$1invalid* sur *true* afin que l’instruction renvoie `NULL` au lieu de renvoyer une erreur en cas de chaîne JSON non valide, utilisez l’exemple suivant.

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14',true);

+-------------------+
| json_array_length |
+-------------------+
| NULL              |
+-------------------+
```