MariaDB JSON_VALID() expliqué

Dans MariaDB, JSON_VALID() est une fonction intégrée qui vous permet de vérifier si une valeur est un document JSON valide ou non.

Vous passez la valeur en argument, et JSON_VALID() renvoie 1 s'il s'agit d'un document JSON valide, et 0 sinon.

Syntaxe

La syntaxe ressemble à ceci :

JSON_VALID(value)

Exemple

Voici un exemple pour illustrer.

SELECT JSON_VALID('{ "product" : "Cup" }');

Résultat :

+-------------------------------------+
| JSON_VALID('{ "product" : "Cup" }') |
+-------------------------------------+
|                                   1 |
+-------------------------------------+

Dans ce cas, l'argument est un document JSON valide.

Voici ce qui se passe si nous supprimons une partie du document :

SELECT JSON_VALID('{ "product" }');

Résultat :

+-----------------------------+
| JSON_VALID('{ "product" }') |
+-----------------------------+
|                           0 |
+-----------------------------+

Ce n'est plus un document JSON valide.

Tableaux

Les tableaux sont considérés comme un document JSON valide.

Exemple :

SELECT JSON_VALID('[ 1, 2, 3 ]');

Résultat :

+---------------------------+
| JSON_VALID('[ 1, 2, 3 ]') |
+---------------------------+
|                         1 |
+---------------------------+

Arguments nuls

Si l'argument est NULL , le résultat est NULL :

SELECT JSON_VALID(null);

Résultat :

+------------------+
| JSON_VALID(null) |
+------------------+
|             NULL |
+------------------+

Nombre de paramètres incorrect

Appel de JSON_VALID() sans argument génère une erreur :

SELECT JSON_VALID();

Résultat :

ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_VALID'

Il en va de même lorsque vous fournissez trop d'arguments :

SELECT JSON_VALID('a', 'b');

Résultat :

ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_VALID'