json_query

json_path 式で特定できる要素の値を JSON オブジェクトからクエリし、JSON 値を返します。

ヒント

すべての JSON 関数と演算子はナビゲーションと overview page に一覧されています。

クエリを 生成列 で高速化しましょう。

Syntax

json_query(json_object_expr, json_path)

Parameters

• json_object_expr: JSON オブジェクトを表す式。このオブジェクトは JSON カラム、または PARSE_JSON などの JSON コンストラクタ関数によって生成された JSON オブジェクトであることができます。

• json_path: JSON オブジェクト内の要素へのパスを表す式。このパラメータの値は文字列です。StarRocks がサポートする JSON パス構文については、Overview of JSON functions and operators を参照してください。

Return value

JSON 値を返します。

要素が存在しない場合、json_query 関数は SQL 値 NULL を返します。

Examples

Example 1: 指定された JSON オブジェクト内で '$.a.b' 式で特定できる要素の値をクエリします。この例では、json_query 関数は JSON 値 1 を返します。

mysql> SELECT json_query(PARSE_JSON('{"a": {"b": 1}}'), '$.a.b') ;

       -> 1

Example 2: 指定された JSON オブジェクト内で '$.a.c' 式で特定できる要素の値をクエリします。この例では、要素が存在しないため、json_query 関数は SQL 値 NULL を返します。

mysql> SELECT json_query(PARSE_JSON('{"a": {"b": 1}}'), '$.a.c') ;

       -> NULL

Example 3: 指定された JSON オブジェクト内で '$.a[2]' 式で特定できる要素の値をクエリします。この例では、配列 a という名前の JSON オブジェクトがインデックス 2 に要素を含んでおり、その要素の値は 3 です。したがって、JSON_QUERY 関数は JSON 値 3 を返します。

mysql> SELECT json_query(PARSE_JSON('{"a": [1,2,3]}'), '$.a[2]') ;

       -> 3

Example 4: 指定された JSON オブジェクト内で '$.a[3]' 式で特定できる要素をクエリします。この例では、配列 a という名前の JSON オブジェクトがインデックス 3 に要素を含んでいません。したがって、json_query 関数は SQL 値 NULL を返します。

mysql> SELECT json_query(PARSE_JSON('{"a": [1,2,3]}'), '$.a[3]') ;

       -> NULL