JSON_EXTRACT_ARRAY_ELEMENT_TEXT 函數

該 JSON_EXTRET_ARRAY_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

整數，代表要傳回之陣列元素的索引 (採用以零開始的陣列索引)。

null_if_invalid

布林值，指定輸入 JSON 字串無效時是否傳回 Null，而非傳回錯誤。若要在 JSON 無效時傳回 Null，請指定 true (t)。若要在 JSON 無效時傳回錯誤，請指定 false (f)。預設值為 false。

傳回類型

VARCHAR 字串，代表 pos 所參考的 JSON 陣列元素。

範例

下列範例傳回位置 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);
 
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，而非傳回錯誤。

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