ISJSON (Transact-SQL)

S’applique à : point de terminaison d’analytique SQL Server 2016 (13.x) et ultérieur Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics SQL Analytics dans Microsoft Fabric Warehouse

Teste si une chaîne contient des données JSON valides.

Conventions de la syntaxe Transact-SQL

Syntaxe

ISJSON ( expression [, json_type_constraint] )  

Arguments

expression

Chaîne à tester.

json_type_constraint

Spécifie le type JSON à vérifier dans l’entrée. Les valeurs valides sont VALUE, ARRAY, OBJECT ou SCALAR. Introduite dans SQL Server 2022 (16.x).

Remarque

L’argument json_type_constraint n’est pas pris en charge dans les pools dédiés Azure Synapse Analytics

Valeur retournée

Renvoie 1 si la chaîne contient des données JSON valides ; sinon, renvoie 0. Renvoie NULL si expression est null.

Si l’instruction omet json_type_constraint, la fonction teste si l’entrée est un objet JSON ou un tableau valide et retourne 1 sinon, elle retourne 0.

Si json_type_constraint est spécifié, la fonction vérifie le type JSON comme suit :

Valeur Description
VALUE Teste une valeur JSON valide. Il peut s’agir d’un objet, d’un tableau, d’un numéro, d’une chaîne JSON ou d’une des trois valeurs littérales (false, true, null)
ARRAY Teste un tableau JSON valide
OBJECT Teste un objet JSON valide
SCALAR Teste un scalaire JSON valide – numéro ou chaîne

La valeur SCALAR json_type_constraint peut être utilisée pour tester le document JSON conforme RFC 8259 IETF qui contient uniquement une valeur scalaire JSON au niveau supérieur. Un document JSON qui ne contient pas de valeur scalaire JSON au niveau supérieur conforme à IETF RFC 4627.

Ne renvoie pas d’erreurs.

Notes

ISJSON ne vérifie pas l’unicité des clés au même niveau.

Exemples

Exemple 1

L’exemple suivant exécute un bloc d’instructions de manière conditionnelle si la valeur de paramètre @param contient des données JSON valides.

DECLARE @param <data type>
SET @param = <value>

IF (ISJSON(@param) > 0)  
BEGIN  
     -- Do something with the valid JSON value of @param.  
END

Exemple 2

L’exemple suivant retourne des lignes dans lesquelles la colonne json_col contient un JSON valide.

SELECT id, json_col
FROM tab1
WHERE ISJSON(json_col) = 1 

Exemple 3

L’exemple suivant retourne des lignes dans lesquelles la colonne json_col contient une valeur SCALAR JSON valide au niveau supérieur.

SELECT id, json_col
FROM tab1
WHERE ISJSON(json_col, SCALAR) = 1 

Exemple 4

L’exemple suivant retourne 1, car l’entrée est une valeur JSON valide - true.

SELECT ISJSON('true', VALUE)

Exemple 5

L’exemple suivant retourne 0, car l’entrée est une valeur JSON non valide.

SELECT ISJSON('test string', VALUE)

Exemple 6

L’exemple suivant retourne 1, car l’entrée est une valeur scalaire JSON valide, conformément au RFC 8259.

SELECT ISJSON('"test string"', SCALAR)