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

JSON_EXTRACT_ARRAY_ELEMENT_TEXT 函数

JSON_EXTRACT_ARRAY_ELEMENT_TEXT 函数返回 JSON 字符串的最外侧数组中的 JSON 数组元素(使用从零开始的索引)。数组中的第一个元素位于位置 0。如果索引为负或超出界限,JSON_EXTRACT_ARRAY_ELEMENT_TEXT 将返回空字符串。如果 null_if_invalid 参数设置为 true 并且 JSON 字符串无效,函数将返回 NULL 而不是返回错误。

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

语法

JSON_EXTRACT_ARRAY_ELEMENT_TEXT('json string', pos [, null_if_invalid ] )

参数

json_string

格式正确的 JSON 字符串。

pos

一个 INTEGER,表示要返回的数组元素的索引(使用从零开始的数组索引)。

null_if_invalid

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

返回类型

VARCHAR

表示 pos 引用的 JSON 数组元素的 VARCHAR 字符串。

示例

要返回位置 2 的数组元素(它是从零开始的数组索引的第三个元素),请使用以下示例:

SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('[111,112,113]', 2); +---------------------------------+ | json_extract_array_element_text | +---------------------------------+ | 113 | +---------------------------------+

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

SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('["a",["b",1,["c",2,3,null,]]]',1); ERROR: invalid json array object ["a",["b",1,["c",2,3,null,]]]

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

SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('["a",["b",1,["c",2,3,null,]]]',1,true); +---------------------------------+ | json_extract_array_element_text | +---------------------------------+ | NULL | +---------------------------------+