Categories: Datatype, Variant Type

IS_LIST Preview

Returns TRUE if the input expression is a VARIANT<ARRAY>.

Syntax

IS_LIST(value VARIANT) → BOOLEAN

• value: The VARIANT value to check.

Examples

IS_LIST example

SELECT IS_LIST(PARSE_JSON('[1, 2, 3]'))
-- TRUE

IS_LIST example

SELECT IS_LIST(PARSE_JSON('{"name": "Alice"}'))
-- FALSE

Usage Notes

NULL handling for VARIANT inputs

If the input is SQL NULL (e.g., from a missing path), IS_LIST returns NULL.

Input	Result
VARIANT array	TRUE
VARIANT other type	FALSE
VARIANT null	FALSE
SQL NULL	NULL