Funzione JSON_EXTRACT_ARRAY_ELEMENT_TEXT

JSON_EXTRACT_ARRAY_ELEMENT_TEXT restituisce un elemento di array JSON nell'array più esterno di una stringa JSON, utilizzando un indice con base zero. Il primo elemento in un array è in posizione 0. Se l'indice è negativo o non vincolato, JSON_EXTRACT_ARRAY_ELEMENT_TEXT restituisce una stringa vuota. Se l'argomento null_if_invalid è impostato su true e la stringa JSON non è valida, la funzione restituisce NULL invece di restituire un errore.

Per ulteriori informazioni, consultare Funzioni JSON.

Sintassi

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

Argomenti

json_string

Una stringa JSON correttamente formattata.

pos

Un integer che rappresenta l'indice dell'elemento array da restituire, utilizzando un indice di array con base zero.

null_if_invalid

Un valore booleano che specifica se restituire NULL se la stringa JSON di input non è valida invece di restituire un errore. Per restituire NULL se JSON non è valido, specificare true (t). Per restituire un errore se JSON non è valido, specificare false (f). Il valore predefinito è false.

Tipo restituito

Una stringa VARCHAR che rappresenta l'elemento dell'array JSON a cui fa riferimento pos.

Esempio

L'esempio seguente restituisce un elemento array alla posizione 2, che è il terzo elemento di un indice di array a base zero:

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

L'esempio seguente restituisce un errore perché JSON non è valido.

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)

L'esempio seguente imposta null_if_invalid su vero, in modo che l'istruzione restituisce NULL invece di restituire un errore per JSON non valido.

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