ISJSON (Transact-SQL)

Berlaku untuk:yes SQL Server 2016 (13.x) dan yang lebih baru Ya Azure SQL Database Ya Azure SQL Managed Instance ya Azure Synapse Analytics

Menguji apakah string berisi JSON yang valid.

Ikon tautan topikKonvensi Sintaks Transact-SQL

Sintaks

ISJSON ( expression [, json_type_constraint] )  

Argumen

ekspresi
String yang akan diuji.

json_type_constraint

Menentukan jenis JSON untuk memeriksa input. Nilai yang valid adalah VALUE, ARRAY, OBJECT, atau SCALAR. Diperkenalkan dalam Pratinjau SQL Server 2022 (16.x).

Catatan

Argumen json_type_constraint tidak didukung di Azure Synapse Analytics

Mengembalikan nilai

Mengembalikan 1 jika string berisi JSON yang valid; jika tidak, mengembalikan 0. Mengembalikan null jika ekspresi null. Jika pernyataan menghilangkan json_type_constraint, fungsi akan menguji apakah input adalah objek atau array JSON yang valid dan mengembalikan 1 jika tidak, ia mengembalikan 0. Jika json_type_constraint ditentukan, maka fungsi memeriksa jenis JSON sebagai berikut:

Nilai Deskripsi
VALUE Pengujian untuk nilai JSON yang valid. Ini bisa berupa objek JSON, array, angka, string atau salah satu dari tiga nilai harfiah (false, true, null)
ARRAY Pengujian untuk array JSON yang valid
OBJECT Pengujian untuk objek JSON yang valid
SKALAR Pengujian untuk skalar JSON yang valid – angka atau string

Nilai json_type_constraint SCALAR dapat digunakan untuk menguji dokumen JSON sesuai IETF RFC 8259 yang hanya berisi nilai skalar JSON di tingkat atas. Dokumen JSON yang tidak berisi nilai skalar JSON di tingkat atas sesuai dengan IETF RFC 4627.

Tidak mengembalikan kesalahan.

Keterangan

ISJSON tidak memeriksa keunikan kunci pada tingkat yang sama.

Contoh

Contoh 1

Contoh berikut menjalankan blok pernyataan secara kondisional jika nilai @param parameter berisi JSON yang valid.

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

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

Contoh 2

Contoh berikut mengembalikan baris di mana kolom json_col berisi JSON yang valid.

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

Contoh: 3

Contoh berikut mengembalikan baris di mana kolom json_col berisi nilai JSON SCALAR yang valid di tingkat atas.

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

Contoh 4

Contoh berikut mengembalikan 1 karena input adalah nilai JSON yang valid - true.

SELECT ISJSON('true', VALUE)

Contoh 5

Contoh berikut mengembalikan 0 karena input adalah nilai JSON yang tidak valid.

SELECT ISJSON('test string', VALUE)

Contoh 6

Contoh berikut mengembalikan 1 karena input adalah skalar JSON yang valid sesuai dengan RFC 8259.

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

Lihat juga

Data JSON (SQL Server)