📣
TiDB Cloud Premium is now in public preview. Unlimited growth, instant elasticity, advanced security for enterprise workloads. Try it out →

GET



Extracts value from a Variant that contains ARRAY by index, or a Variant that contains OBJECT by field_name. 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( <variant>, <index> ) GET( <variant>, <field_name> )

Arguments

ArgumentsDescription
<variant>The VARIANT value that contains either an ARRAY or an OBJECT
<index>The Uint32 value specifies the position of the value in ARRAY
<field_name>The String value specifies the key in a key-value pair of OBJECT

Return Type

VARIANT

Examples

SELECT get(parse_json('[2.71, 3.14]'), 0); +------------------------------------+ | get(parse_json('[2.71, 3.14]'), 0) | +------------------------------------+ | 2.71 | +------------------------------------+ SELECT get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'aa'); +---------------------------------------------------+ | get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'aa') | +---------------------------------------------------+ | 1 | +---------------------------------------------------+ SELECT get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'AA'); +---------------------------------------------------+ | get(parse_json('{"aa":1, "aA":2, "Aa":3}'), 'AA') | +---------------------------------------------------+ | NULL | +---------------------------------------------------+

Was this page helpful?