Función JSON_EXTRACT_ARRAY_ELEMENT_TEXT

La función JSON_EXTRACT_ARRAY_ELEMENT_TEXT devuelve un elemento de la matriz JSON en la matriz extrema de una cadena JSON utilizando un índice basado en cero. El primer elemento en una matriz está en posición 0. Si el índice es negativo o está fuera de límite, JSON_EXTRACT_ARRAY_ELEMENT_TEXT devuelve una cadena vacía. Si el argumento null_if_invalid está establecido en true y la cadena JSON no es válida, la función devuelve NULL en lugar de un error.

Para obtener más información, consulte Funciones JSON.

Sintaxis

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

Argumentos

json_string

Una cadena JSON con formato adecuado.

pos

Un valor entero que representa el índice del elemento de matriz que se devolverá, utilizando un índice de matriz basado en cero.

null_if_invalid

Un valor booleano que especifica que se devuelva NULL si la cadena JSON de entrada no es válida en lugar de devolver un error. Para devolver NULL si la cadena JSON no es válida, especifique true (t). Para devolver un error si la cadena JSON no es válida, especifique false (f). El valor predeterminado es false.

Tipo de retorno

Cadena VARCHAR que representa el elemento de matriz JSON al que se hace referencia en pos.

Ejemplo

El siguiente ejemplo devuelve el elemento de matriz en la posición 2, que es el tercer elemento de un índice de matriz basado en cero:

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

El siguiente ejemplo devuelve un error porque la cadena JSON no es válida.

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)

El siguiente ejemplo establece null_if_invalid en true, por lo que la instrucción devuelve NULL en lugar de devolver un error para indicar que la cadena JSON no es válida.

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