parse_json

文字列を JSON 値に変換します。

構文

parse_json(string_expr)

パラメータ

string_expr: 文字列を表す式。STRING、VARCHAR、および CHAR データ型のみがサポートされています。

戻り値

JSON 値を返します。

注: 文字列が標準の JSON 値に解析できない場合、PARSE_JSON 関数は NULL を返します（例 5 を参照）。JSON の仕様については、RFC 7159 を参照してください。

例

例 1: 1 の STRING 値を 1 の JSON 値に変換します。

mysql> SELECT parse_json('1');
+-----------------+
| parse_json('1') |
+-----------------+
| "1"             |
+-----------------+

例 2: STRING データ型の配列を JSON 配列に変換します。

mysql> SELECT parse_json('[1,2,3]');
+-----------------------+
| parse_json('[1,2,3]') |
+-----------------------+
| [1, 2, 3]             |
+-----------------------+ 

例 3: STRING データ型のオブジェクトを JSON オブジェクトに変換します。

mysql> SELECT parse_json('{"star": "rocks"}');
+---------------------------------+
| parse_json('{"star": "rocks"}') |
+---------------------------------+
| {"star": "rocks"}               |
+---------------------------------+

例 4: NULL の JSON 値を構築します。

mysql> SELECT parse_json('null');
+--------------------+
| parse_json('null') |
+--------------------+
| "null"             |
+--------------------+

例 5: 文字列が標準の JSON 値に解析できない場合、PARSE_JSON 関数は NULL を返します。この例では、star が二重引用符 (") で囲まれていないため、PARSE_JSON 関数は NULL を返します。

mysql> SELECT parse_json('{star: "rocks"}');
+-------------------------------+
| parse_json('{star: "rocks"}') |
+-------------------------------+
| NULL                          |
+-------------------------------+

例 6: JSON キーに '.' が含まれている場合、例えば 'a.1'、それは '\' でエスケープするか、キーの値全体を二重引用符で囲んで単一引用符で囲む必要があります。

mysql> select parse_json('{"b":4, "a.1": "1"}')->"a\\.1";
+--------------------------------------------+
| parse_json('{"b":4, "a.1": "1"}')->'a\\.1' |
+--------------------------------------------+
| "1"                                        |
+--------------------------------------------+
mysql> select parse_json('{"b":4, "a.1": "1"}')->'"a.1"';
+--------------------------------------------+
| parse_json('{"b":4, "a.1": "1"}')->'"a.1"' |
+--------------------------------------------+
| "1"                                        |
+--------------------------------------------+

キーワード

parse_json, parse json