JSON_TYPE

Description

This function returns a utf8mb4 string that represents the type of the JSON value.

Syntax

JSON_TYPE(json_val)

Description

The json_val parameter can be an object, an array, or a scalar.

If the parameter is NULL, the function returns NULL. If the parameter is not a valid JSON value, an error is returned.

Examples

SET @jn = '{"a": [10, true]}';
Query OK, 0 rows affected (0.000 sec)

SELECT JSON_TYPE(JSON_EXTRACT(@jn, '$.a'));
+-------------------------------------+
| JSON_TYPE(JSON_EXTRACT(@jn, '$.a')) |
+-------------------------------------+
| ARRAY                               |
+-------------------------------------+
1 row in set (0.001 sec)

SELECT JSON_TYPE(JSON_EXTRACT(@jn, '$.a[0]'));
+----------------------------------------+
| JSON_TYPE(JSON_EXTRACT(@jn, '$.a[0]')) |
+----------------------------------------+
| INTEGER                                |
+----------------------------------------+
1 row in set (0.001 sec)

SELECT JSON_TYPE(JSON_EXTRACT(@jn, '$.a[1]'));
+----------------------------------------+
| JSON_TYPE(JSON_EXTRACT(@jn, '$.a[1]')) |
+----------------------------------------+
| BOOLEAN                                |
+----------------------------------------+
1 row in set (0.001 sec)

SELECT JSON_TYPE(NULL);
+-----------------+
| JSON_TYPE(NULL) |
+-----------------+
| NULL            |
+-----------------+
1 row in set (0.001 sec)

SELECT JSON_TYPE(1);
ERROR 3146 (22032): Invalid data type for JSON data in argument 1
to function json_type; a JSON string or JSON type is required.