JSON_EXTRACT_PATH_TEXT 函数 - Amazon Redshift
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

JSON_EXTRACT_PATH_TEXT 函数

JSON_EXTRACT_PATH_TEXT 函数返回 JSON 字符串中的一系列路径元素引用的键/值对的值。JSON 路径最深可嵌套至 5 层。路径元素区分大小写。如果 JSON 字符串中不存在路径元素,JSON_EXTRACT_PATH_TEXT 将返回 NULL

如果 null_if_invalid 参数设置为 true 并且 JSON 字符串无效,函数将返回 NULL 而不是返回错误。

有关其他 JSON 函数的信息,请参阅 JSON 函数。有关使用 JSON 的更多信息,请参阅从 JSON 格式数据执行的 COPY 操作

语法

JSON_EXTRACT_PATH_TEXT('json_string', 'path_elem' [,'path_elem'[, …] ] [, null_if_invalid ] )

参数

json_string

格式正确的 JSON 字符串。

path_elem

JSON 字符串中的路径元素。需要一个路径元素。可指定额外的路径元素,最深五层。

null_if_invalid

(可选)一个 BOOLEAN 值,指定在输入 JSON 字符串无效时是否返回 NULL,而不返回错误。要在 JSON 无效时返回 NULL,请指定 truet)。要在 JSON 无效时返回错误,请指定 false (f)。默认为 false

在 JSON 字符串中,Amazon Redshift 将 \n 识别为换行符,将 \t 识别为制表符。要加载反斜杠,请使用反斜杠 ( \\ ) 对其进行转义。有关更多信息,请参阅在 JSON 中转义字符

返回类型

VARCHAR

表示路径元素引用的 JSON 值的 VARCHAR 字符串。

示例

要返回路径 'f4', 'f6' 的值,请使用以下示例。

SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}}','f4', 'f6'); +------------------------+ | json_extract_path_text | +------------------------+ | star | +------------------------+

要因为 JSON 无效而返回错误,请使用以下示例。

SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}','f4', 'f6'); ERROR: invalid json object {"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}

要将 null_if_invalid 设置为 true,以便语句在 JSON 无效返回 NULL,而不是返回错误,请使用以下示例。

SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}','f4', 'f6',true); +------------------------+ | json_extract_path_text | +------------------------+ | NULL | +------------------------+

要返回路径 'farm', 'barn', 'color' 的值,其中检索到的值位于第三级,请使用以下示例。为更便于阅读,此示例使用 JSON lint 工具进行格式化。

SELECT JSON_EXTRACT_PATH_TEXT('{ "farm": { "barn": { "color": "red", "feed stocked": true } } }', 'farm', 'barn', 'color'); +------------------------+ | json_extract_path_text | +------------------------+ | red | +------------------------+

要因为缺少 'color' 元素而返回 NULL,请使用以下示例。此示例使用 JSON lint 工具进行格式化。

SELECT JSON_EXTRACT_PATH_TEXT('{ "farm": { "barn": {} } }', 'farm', 'barn', 'color'); +------------------------+ | json_extract_path_text | +------------------------+ | NULL | +------------------------+

如果 JSON 有效,则尝试提取缺失的元素将返回 NULL

要返回路径 'house', 'appliances', 'washing machine', 'brand' 的值,请使用以下示例。

SELECT JSON_EXTRACT_PATH_TEXT('{ "house": { "address": { "street": "123 Any St.", "city": "Any Town", "state": "FL", "zip": "32830" }, "bathroom": { "color": "green", "shower": true }, "appliances": { "washing machine": { "brand": "Any Brand", "color": "beige" }, "dryer": { "brand": "Any Brand", "color": "white" } } } }', 'house', 'appliances', 'washing machine', 'brand'); +------------------------+ | json_extract_path_text | +------------------------+ | Any Brand | +------------------------+