- 类别:
转换函数、 半结构化和结构化数据函数 (类型转换)
TO_JSON¶
将 VARIANT 值转换为包含该值的 JSON 表示形式的字符串。如果输入为 NULL,则结果也是 NULL。
语法¶
TO_JSON( <expr> )
实参¶
expr
保存有效 JSON 信息的 VARIANT 类型的表达式。
返回¶
返回值的类型为 VARCHAR
。
使用说明¶
如果输入为 NULL,则输出也是 NULL。如果输入是包含 JSON null 的 VARIANT,则返回值是字符串
'"null"'
(即放在双引号内的单词“null”)。下面的示例部分包含一个示例。JSON 对象(也称为“字典”或“哈希”)是一组 无序 的键值对。
TO_JSON
生成字符串时,该字符串中键值对的顺序是不可预测的。
TO_JSON
和PARSE_JSON
(几乎)是相反或互逆的函数。PARSE_JSON
函数接受一个字符串作为输入,并返回一个 JSON 兼容的 VARIANT。TO_JSON
函数接受一个 JSON 兼容的 VARIANT 并返回一个字符串。
如果 X 是包含有效 JSON 的字符串,则以下内容(从概念上讲)为真:
X = TO_JSON(PARSE_JSON(X));
例如,以下情况(从概念上讲)为真:
'{"pi":3.14,"e":2.71}' = TO_JSON(PARSE_JSON('{"pi":3.14,"e":2.71}'))
但是,这些函数并不完全互逆,因为:
空字符串和只有空格的字符串不会互逆。例如,
PARSE_JSON('')
的返回值为 NULL,但TO_JSON(NULL)
的返回值不是''
。TO_JSON
生成的字符串中键值对的顺序是不可预测的。TO_JSON
生成的字符串可以比传递给PARSE_JSON
的字符串具有更少的空格。
例如,以下是等效的 JSON,但不是等效的字符串:
{"pi": 3.14, "e": 2.71}
{"e":2.71,"pi":3.14}
示例¶
这是 TO_JSON
和 PARSE_JSON
的简短示例:
CREATE TABLE jdemo1 (v VARIANT); INSERT INTO jdemo1 SELECT PARSE_JSON('{"food":"bard"}');SELECT v, v:food, TO_JSON(v) FROM jdemo1; +------------------+--------+-----------------+ | V | V:FOOD | TO_JSON(V) | |------------------+--------+-----------------| | { | "bard" | {"food":"bard"} | | "food": "bard" | | | | } | | | +------------------+--------+-----------------+
以下示例显示了 PARSE_JSON
和 TO_JSON
的 NULL 处理:
SELECT TO_JSON(NULL), TO_JSON('null'::VARIANT), PARSE_JSON(NULL), PARSE_JSON('null'); +---------------+--------------------------+------------------+--------------------+ | TO_JSON(NULL) | TO_JSON('NULL'::VARIANT) | PARSE_JSON(NULL) | PARSE_JSON('NULL') | |---------------+--------------------------+------------------+--------------------| | NULL | "null" | NULL | null | +---------------+--------------------------+------------------+--------------------+
以下示例演示了 PARSE_JSON
、TO_JSON
和 TO_VARIANT
之间的关系:
创建一个表并添加 VARCHAR、泛型 VARIANT 和 JSON 兼容 VARIANT 数据。INSERT 语句插入一个 VARCHAR 值,UPDATE 语句生成一个对应于该 VARCHAR 的 JSON 值。
CREATE or replace TABLE jdemo2 (varchar1 VARCHAR, variant1 VARIANT, variant2 VARIANT); INSERT INTO jdemo2 (varchar1) VALUES ('{"PI":3.14}'); UPDATE jdemo2 SET variant1 = PARSE_JSON(varchar1);该查询表明
TO_JSON
和PARSE_JSON
在概念上是互逆函数:SELECT varchar1, PARSE_JSON(varchar1), variant1, TO_JSON(variant1), PARSE_JSON(varchar1) = variant1, TO_JSON(variant1) = varchar1 FROM jdemo2; +-------------+----------------------+--------------+-------------------+---------------------------------+------------------------------+ | VARCHAR1 | PARSE_JSON(VARCHAR1) | VARIANT1 | TO_JSON(VARIANT1) | PARSE_JSON(VARCHAR1) = VARIANT1 | TO_JSON(VARIANT1) = VARCHAR1 | |-------------+----------------------+--------------+-------------------+---------------------------------+------------------------------| | {"PI":3.14} | { | { | {"PI":3.14} | True | True | | | "PI": 3.14 | "PI": 3.14 | | | | | | } | } | | | | +-------------+----------------------+--------------+-------------------+---------------------------------+------------------------------+但是,这些功能并不完全是互逆的;键值对的空格或顺序差异可能会阻止输出与输入匹配。例如:
SELECT TO_JSON(PARSE_JSON('{"b":1,"a":2}')), TO_JSON(PARSE_JSON('{"b":1,"a":2}')) = '{"b":1,"a":2}', TO_JSON(PARSE_JSON('{"b":1,"a":2}')) = '{"a":2,"b":1}' ; +--------------------------------------+--------------------------------------------------------+--------------------------------------------------------+ | TO_JSON(PARSE_JSON('{"B":1,"A":2}')) | TO_JSON(PARSE_JSON('{"B":1,"A":2}')) = '{"B":1,"A":2}' | TO_JSON(PARSE_JSON('{"B":1,"A":2}')) = '{"A":2,"B":1}' | |--------------------------------------+--------------------------------------------------------+--------------------------------------------------------| | {"a":2,"b":1} | False | True | +--------------------------------------+--------------------------------------------------------+--------------------------------------------------------+尽管
PARSE_JSON
和TO_VARIANT
都可以接受一个字符串并返回一个变体,但它们并不等效。下面的代码使用PARSE_JSON
更新一列,使用TO_VARIANT
更新另一列。(对列variant1
的更新是不必要的,因为它之前是使用相同的函数调用更新的;但是,下面的代码会再次更新它,以便您可以并排查看调用哪些函数来更新列)。UPDATE jdemo2 SET variant1 = PARSE_JSON(varchar1), variant2 = TO_VARIANT(varchar1);下面的查询显示
PARSE_JSON
的输出和TO_VARIANT
的输出不同。除了空格中的细微差异外,引号也存在显著差异。SELECT variant1, variant2, variant1 = variant2 FROM jdemo2; +--------------+-----------------+---------------------+ | VARIANT1 | VARIANT2 | VARIANT1 = VARIANT2 | |--------------+-----------------+---------------------| | { | "{\"PI\":3.14}" | False | | "PI": 3.14 | | | | } | | | +--------------+-----------------+---------------------+