Menambahkan Node Akar ke Output JSON dengan Opsi ROOT

Berlaku untuk: SQL Server 2016 (13.x) dan versi yang lebih baru Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics (hanya kumpulan SQL tanpa server)Titik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft FabricSQL database di Microsoft Fabric

Untuk menambahkan elemen tingkat atas tunggal ke output JSON dari klausa FOR JSON, tentukan opsi ROOT.

Jika Anda tidak menentukan opsi ROOT, output JSON tidak menyertakan elemen akar.

Examples

Tabel berikut menunjukkan output klausa FOR JSON dengan dan tanpa opsi ROOT.

Contoh dalam tabel berikut mengasumsikan bahwa argumen RootName opsional kosong. Jika Anda memberikan nama untuk elemen akar, nilai ini menggantikan nilai root dalam contoh.

Tanpa opsi ROOT:

{  
   <<json properties>>  
}  

[  
   <<json array elements>>  
]  

Dengan opsi ROOT:

{   
  "root": {  
   <<json properties>>  
 }  
}  

{   
  "root": [  
   << json array elements >>  
  ]  
}  

Berikut adalah contoh lain dari klausa FOR JSON dengan opsi ROOT. Contoh ini menentukan nilai untuk argumen RootName opsional.

Query

SELECT TOP 5   
       BusinessEntityID As Id,  
       FirstName, LastName,  
       Title As 'Info.Title',  
       MiddleName As 'Info.MiddleName'  
   FROM Person.Person  
   FOR JSON PATH, ROOT('info')

Result

{
    "info": [{
        "Id": 1,
        "FirstName": "Ken",
        "LastName": "Sánchez",
        "Info": {
            "MiddleName": "J"
        }
    }, {
        "Id": 2,
        "FirstName": "Terri",
        "LastName": "Duffy",
        "Info": {
            "MiddleName": "Lee"
        }
    }, {
        "Id": 3,
        "FirstName": "Roberto",
        "LastName": "Tamburello"
    }, {
        "Id": 4,
        "FirstName": "Rob",
        "LastName": "Walters"
    }, {
        "Id": 5,
        "FirstName": "Gail",
        "LastName": "Erickson",
        "Info": {
            "Title": "Ms.",
            "MiddleName": "A"
        }
    }]
}

Hasil (tanpa root)

[{
    "Id": 1,
    "FirstName": "Ken",
    "LastName": "Sánchez",
    "Info": {
        "MiddleName": "J"
    }
}, {
    "Id": 2,
    "FirstName": "Terri",
    "LastName": "Duffy",
    "Info": {
        "MiddleName": "Lee"
    }
}, {
    "Id": 3,
    "FirstName": "Roberto",
    "LastName": "Tamburello"
}, {
    "Id": 4,
    "FirstName": "Rob",
    "LastName": "Walters"
}, {
    "Id": 5,
    "FirstName": "Gail",
    "LastName": "Erickson",
    "Info": {
        "Title": "Ms.",
        "MiddleName": "A"
    }
}]

Pelajari selengkapnya tentang JSON di SQL Database Engine

Untuk pengenalan visual dukungan JSON bawaan, lihat video berikut ini:

• JSON sebagai jembatan antara NoSQL dan dunia relasional

Konten terkait

• SELECT - Klausul FOR (Transact-SQL)