JSON_EXTRACT_BIGINT

説明

JSON_EXTRACT_BIGINTは、JSONオブジェクトから<json_path>で指定されたフィールドを抽出し、BIGINT型に変換します。

構文

JSON_EXTRACT_BIGINT(<json_object>, <json_path>)

パラメータ

• <json_object>: JSON型、抽出元の対象パラメータ
• <json_path>: String型、対象JSONから目的の要素を抽出するためのJSONパス

戻り値

Nullable(BIGINT) 抽出されたBIGINT値を返します。場合によってはNULLを返します

使用上の注意

1. <json_object>または<json_path>がNULLの場合、NULLを返します。

2. <json_path>で指定された要素が存在しない場合、NULLを返します。

3. <json_path>で指定された要素がBIGINTに変換できない場合、NULLを返します。

4. この動作は「cast + json_extract」と一致しており、以下と等価です：

   CAST(JSON_EXTRACT(<json_object>, <json_path>) as BIGINT)

例

1. 通常のパラメータ

   SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id');

   +-------------------------------------------------------------------------+
   | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id') |
   +-------------------------------------------------------------------------+
   |                                                         122222222222223 |
   +-------------------------------------------------------------------------+

2. パスが存在しない場合

   SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id2');

   +--------------------------------------------------------------------------+
   | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id2') |
   +--------------------------------------------------------------------------+
   |                                                                     NULL |
   +--------------------------------------------------------------------------+

3. NULLパラメータ

   SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', NULl);

   +-----------------------------------------------------------------------+
   | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', NULl) |
   +-----------------------------------------------------------------------+
   |                                                                  NULL |
   +-----------------------------------------------------------------------+

   SELECT json_extract_bigint(NULL, '$.id2');

   +------------------------------------+
   | json_extract_bigint(NULL, '$.id2') |
   +------------------------------------+
   |                               NULL |
   +------------------------------------+

4. BIGINTへの変換ができない場合

   SELECT json_extract_bigint('{"id": 123, "name": "doris"}','$.name');

   +--------------------------------------------------------------+
   | json_extract_bigint('{"id": 123, "name": "doris"}','$.name') |
   +--------------------------------------------------------------+
   |                                                         NULL |
   +--------------------------------------------------------------+