Fonction JSON_EXTRACT_ARRAY_ELEMENT_TEXT

La fonction JSON_EXTRACT_ARRAY_ELEMENT_TEXT renvoie un élément de tableau JSON dans le tableau le plus externe d'une chaîne JSON, à l'aide d'un index de base zéro. Le premier élément d'un tableau est à la position 0. Si l'index est négatif ou hors limites, JSON_EXTRACT_ARRAY_ELEMENT_TEXT renvoie une chaîne vide. Si l'argument null_if_invalid a la valeur true et que la chaîne JSON n'est pas valide, la fonction renvoie NULL au lieu de renvoyer une erreur.

Pour plus d'informations, consultez Fonctions JSON.

Syntaxe

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

Arguments

json_string

Chaîne JSON au bon format.

pos

Nombre entier représentant l'index de l'élément de tableau à renvoyer, à l'aide d'un index de tableau de base zéro.

null_if_invalid

Valeur booléenne qui spécifie s'il faut renvoyer NULL quand la chaîne JSON en entrée n'est pas valide au lieu de renvoyer une erreur. Pour renvoyer NULL si la chaîne JSON n'est pas valide, spécifiez true (t). Pour renvoyer une erreur si la chaîne JSON n'est pas valide, spécifiez false (f). La valeur par défaut est false.

Type de retour

Chaîne VARCHAR représentant l'élément de tableau JSON référencé par pos.

Exemple

L'exemple suivant renvoie un élément de tableau à la position 2, qui est le troisième élément d'un index de tableau de base zéro :

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

L'exemple suivant renvoie une erreur, car la chaîne JSON n'est pas valide.

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'exemple suivant définissant null_if_invalid sur la valeur true, l'instruction renvoie NULL au lieu de renvoyer une erreur en cas de chaîne JSON non valide.

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