ISJSON (Transact-SQL)

Artículo
05/23/2023

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento de Microsoft Fabric

Prueba si una cadena contiene un valor JSON válido.

Convenciones de sintaxis de Transact-SQL

Sintaxis

ISJSON ( expression [, json_type_constraint] )

Argumentos

expression
Cadena que se va a comprobar.

json_type_constraint

Especifica el tipo JSON para comprobar en la entrada. Los valores válidos son VALUE, ARRAY, OBJECT o SCALAR. Introducido en SQL Server 2022 (16.x).

Nota

El argumento json_type_constraint no se puede usar en grupos dedicados de Azure Synapse Analytics

Valor devuelto

Devuelve 1 si la cadena contiene un valor JSON válido; en caso contrario, devuelve 0. Devuelve null si expression es null. Si la instrucción omite json_type_constraint, la función comprueba si la entrada es un objeto o matriz JSON válidos y devuelve 1; de lo contrario, devuelve 0. Si se especifica json_type_constraint, la función comprueba el tipo JSON de la siguiente manera:

Valor	Descripción
VALOR	Comprueba si hay un valor JSON válido. Puede ser un objeto JSON, una matriz, un número, una cadena o uno de los tres valores literales (false, true, null)
ARRAY	Pruebas de una matriz JSON válida
OBJECT	Pruebas de un objeto JSON válido
SCALAR	Pruebas de un valor escalar JSON válido: número o cadena

El valor SCALAR json_type_constraint puede utilizarse para comprobar si un documento JSON conforme a la RFC 8259 del IETF contiene solo un valor escalar JSON en el nivel superior. Un documento JSON que no contiene un valor escalar JSON en el nivel superior se ajusta a la RFC 4627 del IETF.

No devuelve errores.

Observaciones

ISJSON no comprueba la unicidad de las claves en el mismo nivel.

Ejemplos

Ejemplo 1

En el siguiente ejemplo se ejecuta un bloque de instrucciones de forma condicional si el valor del parámetro @param contiene un valor JSON válido.

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

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

Ejemplo 2

En el ejemplo siguiente, se devuelven las filas en las que la columna json_col contiene JSON válido.

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

Ejemplo 3

En el ejemplo siguiente, se devuelven las filas en las que la columna json_col contiene un valor SCALAR JSON válido en el nivel superior.

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

Ejemplo 4

En el ejemplo siguiente se devuelve 1, ya que la entrada es un valor JSON válido: true.

SELECT ISJSON('true', VALUE)

Ejemplo 5

En el ejemplo siguiente se devuelve 0, ya que la entrada es un valor JSON no válido.

SELECT ISJSON('test string', VALUE)

Ejemplo 6

En el ejemplo siguiente se devuelve 1, ya que la entrada es un valor escalar JSON válido según RFC 8259.

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

Consulte también

Datos JSON (SQL Server)