Добавление корневого узла в выходные данные JSON с параметром ROOT (SQL Server)

Область применения: SQL Server 2016 (13.x) и более поздних версий База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics (только бессерверный пул SQL)

Чтобы добавить один элемент верхнего уровня к выходным данным JSON предложения FOR JSON , укажите параметр ROOT .

Если не указать параметр ROOT , выходные данные JSON не будут содержать корневой элемент.

Примеры

В приведенной ниже таблице показаны выходные данные предложения FOR JSON с параметром ROOT и без него.

Примеры в этой таблице предполагают, что необязательный аргумент RootName пуст. Если указать имя для корневого элемента, это значение заменит значение root в примерах.

Без параметра ROOT

{  
   <<json properties>>  
}  

[  
   <<json array elements>>  
]  

С параметром ROOT

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

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

Вот другой пример предложения FOR JSON с параметром ROOT . В этом примере указывается значение необязательного аргумента RootName .

Запрос

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

Результат

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

Результат (без параметра 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"
    }
}]

Дополнительные сведения о JSON в SQL Server и базе данных SQL Azure

Видео Майкрософт

Наглядные инструкции по встроенной поддержке JSON в SQL Server и базе данных SQL Azure см. в следующих видео.

• JSON as a bridge between NoSQL and relational worlds (JSON как мост между NoSQL и реляционными решениями)

См. также

Предложение FOR (Transact-SQL)