Skip to main content

Get

Extracts value from an ARRAY by index, an OBJECT by field_name, or a VARIANT that contains either ARRAY or OBJECT. The value is returned as a Variant or NULL if either of the arguments is NULL.

GET applies case-sensitive matching to field_name. For case-insensitive matching, use GET_IGNORE_CASE.

Syntax

get(array, index)
get(variant, index)

get(object, field_name)
get(variant, field_name)

Arguments

ArgumentsDescription
arrayThe ARRAY value
objectThe OBJECT value
variantThe VARIANT value that contains either an ARRAY or an OBJECT
indexThe Uint32 value specifies the position of the value in ARRAY
field_nameThe String value specifies the key in a key-value pair of OBJECT

Return Type

Variant

Examples

mysql> select get(parse_json('[2.71, 3.14]'), 0);
+------------------------------------+
| get(parse_json('[2.71, 3.14]'), 0) |
+------------------------------------+
| 2.71 |
+------------------------------------+
1 row in set (0.01 sec)

mysql> select get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'aa');
+---------------------------------------------------+
| get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'aa') |
+---------------------------------------------------+
| 1 |
+---------------------------------------------------+
1 row in set (0.01 sec)

mysql> select get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'AA');
+---------------------------------------------------+
| get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'AA') |
+---------------------------------------------------+
| NULL |
+---------------------------------------------------+
1 row in set (0.01 sec)