ISJSON (Transact-SQL)

Aplica-se a:yesSQL Server 2016 (13.x) e posteriores YesBanco de Dados SQL do Azure YesInstância Gerenciada de SQL do Azure yesAzure Synapse Analytics

Testa se uma cadeia de caracteres contém um JSON válido.

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

ISJSON ( expression [, json_type_constraint] )  

Argumentos

expressão
A cadeia de caracteres a ser testada.

json_type_constraint

Especifica o tipo JSON a ser verificado na entrada. Os valores válidos são VALUE, ARRAY, OBJECT ou SCALAR. Introduzido na versão prévia do SQL Server 2022 (16.x).

Retornar valor

Retornará 1 se a cadeia de caracteres contiver um JSON válido, caso contrário, retornará 0. Retornará nulo se a expressão for nula. Se a instrução omitir json_type_constraint, a função testará se a entrada for um objeto ou matriz JSON válida e retornará 1, caso contrário, ela retornará 0. Se o json_type_constraint for especificado, a função verificará o tipo JSON da seguinte maneira:

Valor Descrição
VALUE Testes para um valor JSON válido. Isso pode ser um objeto JSON, matriz, número, cadeia de caracteres ou um dos três valores literais (false, true, null)
ARRAY Testes para uma matriz JSON válida
OBJECT Testes para um objeto JSON válido
SCALAR Testes para um escalar JSON válido – número ou cadeia de caracteres

O valor SCALAR json_type_constraint pode ser usado para testar o documento JSON compatível com IETF RFC 8259 que contém apenas um valor escalar JSON no nível superior. Um documento JSON que não contém um valor escalar JSON no nível superior está em conformidade com o IETF RFC 4627.

Não retorna erros.

Comentários

ISJSON não verifica a exclusividade das chaves no mesmo nível.

Exemplos

Exemplo 1

O exemplo a seguir executará um bloco de instruções condicionalmente se o valor do parâmetro @param contiver um 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

Exemplo 2

O exemplo a seguir retorna linhas em que a coluna json_col contém um JSON válido.

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

Exemplo 3

O exemplo a seguir retorna linhas em que a coluna json_col contém um valor SCALAR JSON válido no nível superior.

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

Exemplo 4

O exemplo a seguir retorna 1, já que a entrada é um valor JSON válido – true.

SELECT ISJSON('true', VALUE)

Exemplo 5

O exemplo a seguir retorna 0, já que a entrada é um valor JSON inválido.

SELECT ISJSON('test string', VALUE)

Exemplo 6

O exemplo a seguir retorna 1, já que a entrada é um valor scalar JSON válido de acordo com RFC 8259.

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

Confira também

Dados JSON (SQL Server)