Delen via

Een hoofdknooppunt toevoegen aan JSON-uitvoer met de ROOT-optie

  • Artikel

van toepassing op: SQL Server 2016 (13.x) en latere versies Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics (alleen serverloze SQL-pool)SQL Analytics-eindpunt in Microsoft FabricWarehouse in Microsoft Fabric

Als u één element op het hoogste niveau wilt toevoegen aan de JSON-uitvoer van de FOR JSON-component, geeft u de optie ROOT op.

Als u de optie ROOT niet opgeeft, bevat de JSON-uitvoer geen hoofdelement.

Voorbeelden

In de volgende tabel ziet u de uitvoer van de FOR JSON-voorwaarde met en zonder de ROOT-optie.

In de voorbeelden in de volgende tabel wordt ervan uitgegaan dat het optionele argument RootName leeg is. Als u een naam opgeeft voor het hoofdelement, vervangt deze waarde de waarde root in de voorbeelden.

Zonder de optie ROOT:

{  
   <<json properties>>  
}  

[  
   <<json array elements>>  
]

Met de optie ROOT:

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

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

Hier is een ander voorbeeld van een FOR JSON-clausule met de ROOT-optie. In dit voorbeeld wordt een waarde opgegeven voor het optionele argument RootName.

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')

resultaat

{
    "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"
        }
    }]
}

resultaat (zonder wortelmap)

[{
    "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"
    }
}]

Meer informatie over JSON in de SQL Database Engine

Zie de volgende video's voor een visuele inleiding tot de ingebouwde JSON-ondersteuning:

Verwante inhoud