Amazon Redshift
数据库开发人员指南 (API Version 2012-12-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

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 函数

语法

Copy
json_extract_array_element_text('json string', pos [, null_if_invalid ] )

参数

json_string

格式正确的 JSON 字符串。

pos

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

null_if_invalid

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

返回类型

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

示例

以下示例返回位于位置 2 的数组元素:

Copy
select json_extract_array_element_text('[111,112,113]', 2); json_extract_array_element_text ------------------------------- 113

在以下示例中,因为 JSON 无效,所以返回错误。

Copy
select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1); An error occurred when executing the SQL command: select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1)

以下示例将 null_if_invalid 设置为 true,因此语句在 JSON 无效时返回 NULL 而不是返回错误。

Copy
select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1,true); json_extract_array_element_text -------------------------------

本页内容: