Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Función JSON\$1ARRAY\$1LENGTH
<a name="JSON_ARRAY_LENGTH"></a>

**nota**  
JSON\$1PARSE y sus funciones asociadas analizan los valores JSON como SUPER, que Amazon Redshift analiza de forma más eficiente que VARCHAR.  
 En lugar de usar JSON\$1ARRAY\$1LENGTH, le recomendamos que analice las cadenas JSON con [Función JSON\$1PARSE](JSON_PARSE.md) para obtener un valor SUPER. A continuación, use [Función GET\$1ARRAY\$1LENGTH](get_array_length.md) para obtener la longitud de la matriz. 

La función JSON\$1ARRAY\$1LENGTH devuelve la cantidad de elementos en la matriz exterior de una cadena JSON. Si el argumento *null\$1if\$1invalid* está establecido en `true` y la cadena JSON no es válida, la función devuelve `NULL` en lugar de un error.

Para obtener más información, consulte [Funciones JSON](json-functions.md). 

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

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

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

 *json\$1array*  
Una matriz JSON con formato adecuado.

 *null\$1if\$1invalid*  
(Opcional) Un valor `BOOLEAN` que especifica que se devuelva `NULL` si la cadena JSON de entrada no es válida en lugar de devolver un error. Para devolver `NULL` si la cadena JSON no es válida, especifique `true` (`t`). Para devolver un error si la cadena JSON no es válida, especifique `false` (`f`). El valor predeterminado es `false`.

## Tipo de retorno
<a name="JSON_ARRAY_LENGTH-return"></a>

`INTEGER`

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

Para devolver la cantidad de elementos en la matriz, use el siguiente ejemplo. 

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

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

Para devolver un error porque la cadena JSON no es válida, use el siguiente ejemplo.

```
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
```

Para establecer *null\$1if\$1invalid* en *true*, para que la instrucción devuelva `NULL` en lugar de devolver un error para indicar que la cadena JSON no es válida, use el siguiente ejemplo.

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

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