- カテゴリ:
半構造化データ関数 (解析)
PARSE_JSON¶
入力文字列を JSON ドキュメントとして解釈し、 VARIANT 値を生成します。
- こちらもご参照ください:
構文¶
PARSE_JSON( <expr> )
引数¶
式
文字列型の式(例:VARCHAR)で、有効な JSON 情報を保持しています。
戻り値¶
返される値は VARIANT
型で、 JSON ドキュメントが含まれています。
使用上の注意¶
この関数は、最大サイズ8 MB に圧縮された入力式をサポートします。
入力が NULL の場合、出力も NULLです。ただし、入力文字列が
'null'
の場合、 JSON null値として解釈されるため、結果は SQL NULLではなく、null
を含む有効な VARIANT 値になります。10進数を解析するとき、 PARSE_JSON は、123.45を DOUBLEではなく NUMBER(5、2)として処理することにより、表現の正確さを保持しようとします。ただし、科学表記法を使用した数値(1.2345e +02など)、または、範囲またはスケールの制限により固定小数点として保存できない数値は DOUBLE として保存されます。JSON は TIMESTAMP、 DATE、 TIME、または BINARY などの値をネイティブに表さないため、これらは文字列として表される必要があります。
JSONでは、オブジェクト(別名「辞書」または「ハッシュ」)は、キーと値のペアの 順序付けられていない セットです。
TO_JSON
およびPARSE_JSON
は(ほぼ)逆または相反関数です。PARSE_JSON
関数は入力として文字列を取り、 JSON互換のバリアントを返します。TO_JSON
関数は JSON互換バリアントを受け取り、文字列を返します。Xが有効な JSON を含む文字列である場合、次は(概念的に)trueです。X = TO_JSON(PARSE_JSON(X));
例えば、次は(概念的に)trueです。
'{"pi":3.14,"e":2.71}' = TO_JSON(PARSE_JSON('{"pi":3.14,"e":2.71}'))
ただし、関数は次の2つの理由で完全に相反しません。
TO_JSON
によって生成される文字列内のキーと値のペアの順序は予測できません。TO_JSON
によって生成された文字列には、PARSE_JSON
に渡される文字列よりも少ない空白を含めることができます。
次は同等の JSONですが、同等の文字列ではありません。
{"pi":3.14、「e」:2.71}
{"e":2.71,"pi":3.14}
例¶
これは、 PARSE_JSON
を呼び出して JSON として解析できる値を含む文字列を解析することにより、 VARIANT 列にさまざまな型のデータを保存する例を示しています。
テーブルを作成して入力します。
INSERT
ステートメントはPARSE_JSON
関数を使用します。create or replace table vartab (n number(2), v variant); insert into vartab select column1 as n, parse_json(column2) as v from values (1, 'null'), (2, null), (3, 'true'), (4, '-17'), (5, '123.12'), (6, '1.912e2'), (7, '"Om ara pa ca na dhih" '), (8, '[-1, 12, 289, 2188, false,]'), (9, '{ "x" : "abc", "y" : false, "z": 10} ') AS vals;データをクエリします。
select n, v, typeof(v) from vartab; +---+------------------------+------------+ | N | V | TYPEOF(V) | |---+------------------------+------------| | 1 | null | NULL_VALUE | | 2 | NULL | NULL | | 3 | true | BOOLEAN | | 4 | -17 | INTEGER | | 5 | 123.12 | DECIMAL | | 6 | 1.912000000000000e+02 | DOUBLE | | 7 | "Om ara pa ca na dhih" | VARCHAR | | 8 | [ | ARRAY | | | -1, | | | | 12, | | | | 289, | | | | 2188, | | | | false, | | | | undefined | | | | ] | | | 9 | { | OBJECT | | | "x": "abc", | | | | "y": false, | | | | "z": 10 | | | | } | | +---+------------------------+------------+