다음을 통해 공유


ISJSON(Transact-SQL)

적용 대상: Microsoft Fabric의 Microsoft Fabric Warehouse에 있는 SQL Server 2016(13.x) 이상 Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics SQL 분석 엔드포인트

문자열에 유효한 JSON이 포함되어 있는지 테스트합니다.

Transact-SQL 구문 표기 규칙

구문

ISJSON ( expression [, json_type_constraint] )  

인수

expression

테스트할 문자열입니다.

json_type_constraint

입력을 체크 인할 JSON 형식을 지정합니다. 유효한 값은 VALUE, ARRAY, OBJECT 또는 SCALAR입니다. SQL Server 2022(16.x)에서 도입되었습니다.

참고 항목

인수 json_type_constraint는 Azure Synapse Analytics 전용 풀에서 지원되지 않습니다

반환 값

문자열에 유효한 JSON이 포함되어 있으면 1을(를) 반환하고 그렇지 않으면 0을(를) 반환합니다. expression이 null이면 NULL을(를) 반환합니다.

문이 json_type_constraint를 생략하면 함수는 입력이 유효한 JSON 개체 또는 배열인지 테스트하여 유효하면 1을(를), 유효하지 않으면 0을(를) 반환합니다.

json_type_constraint가 지정된 경우 함수는 다음과 같이 JSON 형식을 확인합니다.

설명
VALUE 유효한 JSON 값에 대한 테스트입니다. JSON 개체, 어레이, 숫자, 문자열 또는 세 가지 리터럴 값(false, true, null) 중 하나일 수 있습니다
ARRAY 유효한 JSON 어레이 테스트
OBJECT 유효한 JSON 개체 테스트
SCALAR 유효한 JSON 스칼라 테스트 - 숫자 또는 문자열

json_type_constraint 값 SCALAR를 사용하면 최상위 수준의 JSON 스칼라 값만 포함하는 IETF RFC 8259 준수 JSON 문서를 테스트할 수 있습니다. 최상위 수준의 JSON 스칼라 값이 없는 JSON 문서는 IETF RFC 4627을 준수합니다.

오류를 반환하지 않습니다.

설명

ISJSON은(는) 동일한 수준에서 키의 고유성을 확인하지 않습니다.

예제

예 1

다음 예제에서는 매개 변수 값 @param에 유효한 JSON이 포함되어 있으면 조건부로 명령문 블록을 실행합니다.

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

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

예제 2

다음 예제는 json_col 열에 유효한 JSON이 포함된 행을 반환합니다.

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

예제 3

다음 예제는 json_col 열에 유효한 최상위 수준의 JSON SCALAR가 포함된 행을 반환합니다.

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

예제 4

다음 예제에서는 입력이 유효한 JSON 값(true)이므로 1을 반환합니다.

SELECT ISJSON('true', VALUE)

예제 5

다음 예제에서는 입력이 유효하지 않은 JSON 값이므로 0을 반환합니다.

SELECT ISJSON('test string', VALUE)

예제 6

다음 예제에서는 입력이 RFC 8259에 따른 유효한 JSON 스칼라이므로 1을 반환합니다.

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