JSON_EXTRACT_PATH_TEXT 函数 - Amazon Redshift
语法参数返回类型示例
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

JSON_EXTRACT_PATH_TEXT 函数

JSON_EXTRACT_PATH_TEXT 返回 JSON 字符串中的一系列路径元素引用的 key:value 对的值。JSON 路径最深可嵌套至 5 层。路径元素区分大小写。如果 JSON 字符串中不存在路径元素，JSON_EXTRACT_PATH_TEXT 将返回空字符串。如果 null_if_invalid 参数设置为 true 并且 JSON 字符串无效，函数将返回 NULL 而不是返回错误。

有关更多信息，请参阅JSON 函数。

Syntax

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

Arguments

json_string

格式正确的 JSON 字符串。

path_elem

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

null_if_invalid

一个布尔值，指定在输入 JSON 字符串无效时是否返回 NULL 而不返回错误。要在 JSON 无效时返回 NULL，请指定 true (t)。要在 JSON 无效时返回错误，请指定 false (f)。默认为 false。

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

返回类型

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

Example

以下示例返回路径 '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');
 
An error occurred when executing the SQL command:
select json_extract_path_text('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}','f4', 'f6')

以下示例将 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
-------------------------------