首頁 > 軟體

SQL Server中JSON函數的用法詳解

2022-05-21 19:00:12

SQL Server 2005開始支援XML資料型別,提供原生的XML資料型別、XML索引及各種管理或輸出XML格式的函數。

隨著JSON的流行,SQL Server 2016開始支援JSON資料型別,不僅可以直接輸出JSON格式的結果集,還能讀取JSON格式的資料。

官方檔案:https://docs.microsoft.com/zh-cn/sql/relational-databases/json/json-data-sql-server?view=sql-server-2017

下面是我們熟悉的SELECT及輸出格式,後面對JSON的演示基於此SQL:

一、 將查詢結果輸出JSON格式

1、FOR JSON AUTO:SELECT語句的結果以JSON輸出。

要將SELECT語句的結果以JSON輸出,最簡單的方法是在後面加上FOR JSON AUTO:

2、FOR JSON AUTO,Root(’’) :為JOSN加上根節點

若要為FOR JSON加上Root Key,可以用ROOT選項來自定義ROOT 節點的名稱:

3、FOR JSON PATH輸出:可通過列別名來定義JSON物件的層次結構

若要自定義輸出JSON格式的結構時,必須使用JSONPATH。

  • FOR JSON Auto,自動按照查詢語句中使用的表結構來建立巢狀的JSON子陣列,類似於For Xml Auto特性。
  • FOR JSON Path,通過列名或者列別名來定義JSON物件的層次結構,列別名中可以包含“.”,JSON的成員層次結構將會與別名中的層次結構保持一致。
    這個特性非常類似於早期SQL Server版本中的For Xml Path子句,可以使用斜線來定義xml的層次結構。

4、FOR JSON PATH+ROOT輸出:為JOSN加上根節點

5、INCLUDE_NULL_VALUES:值null的欄位需要顯示出現。

為NULL的資料在輸出JSON時,會被忽略,若想要讓NULL的欄位也顯示出來,可以加上選項INCLUDE_NULL_VALUES,該選項也適用於AUTO。

6、列的別名,可以增加帶有層級關係的節點。

比如下面的SQL,增加了一個“SN”節點,把欄位SERNUM和CLIMAT放在裡面:

演示範例:

select TOP (2) id,  Plies, Createtime from [dbo].[B3PliesData] ORDER BY ID  ;
--1178    3    2020-07-21 14:33:18.480
--1179    3    2020-07-21 14:36:27.457

select TOP (2) id,  Plies as [myObject.Plies], Createtime as [myObject.Createtime] from [dbo].[B3PliesData]  ORDER BY ID for json auto;
--[{"id":1178,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:33:18.480"},{"id":1179,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:36:27.457"}]

select TOP (2) id,  Plies, Createtime from [dbo].[B3PliesData]  ORDER BY ID for json auto ,root('myRoot') ;
--{"myRoot":[{"id":1178,"Plies":3,"Createtime":"2020-07-21T14:33:18.480"},{"id":1179,"Plies":3,"Createtime":"2020-07-21T14:36:27.457"}]}

select TOP (2) id,  Plies as [myObject.Plies], Createtime as [myObject.Createtime]  from [dbo].[B3PliesData]   ORDER BY ID for json path;
--[{"id":1178,"myObject":{"Plies":3,"Createtime":"2020-07-21T14:33:18.480"}},{"id":1179,"myObject":{"Plies":3,"Createtime":"2020-07-21T14:36:27.457"}}]

select TOP (2) id,  Plies, Createtime,null as mynull from [dbo].[B3PliesData]  ORDER BY ID  for json path,root('myRoot');
--{"myRoot":[{"id":1178,"Plies":3,"Createtime":"2020-07-21T14:33:18.480"},{"id":1179,"Plies":3,"Createtime":"2020-07-21T14:36:27.457"}]}

select TOP (2) id,  Plies, Createtime,null as mynull from [dbo].[B3PliesData]  ORDER BY ID for json path,root('myRoot'),include_null_values;
--{"myRoot":[{"id":1178,"Plies":3,"Createtime":"2020-07-21T14:33:18.480","mynull":null},{"id":1179,"Plies":3,"Createtime":"2020-07-21T14:36:27.457","mynull":null}]}

二、 解析JSON格式的資料

1、使用OPENJSON()函數:

2、通過WITH選項,自定義輸出列:

範例演示:

-------------1、-------------
declare @json as varchar(8000)
set @json='[
{"id":1178,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:33:18.480"},
{"id":1179,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:36:27.457"}]'
select * from openjson(@json);
--key    value    type
--0    {"id":1178,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:33:18.480"}    5
--1    {"id":1179,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:36:27.457"}    5

-------------2、-------------
declare @json1 as varchar(8000)
set @json1='[
{"id":1178,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:33:18.480"},
{"id":1179,"myObject.Plies":3,"myObject.Createtime":"2020-07-21T14:36:27.457"}]
'
select * from openjson(@json1)
with(
id varchar(10) '$.id',
Plies  int '$."myObject.Plies"',
Createtime datetime '$."myObject.Createtime"'
);
--id    Plies    Createtime
--1178    3    2020-07-21 14:33:18.480
--1179    3    2020-07-21 14:36:27.457

-------------3、-------------
declare @json2 as varchar(8000)
set @json2='{"myRoot":[
{"id":1178,"myObject":{"Plies":3,"Createtime":"2020-07-21T14:33:18.480"}},
{"id":1179,"myObject":{"Plies":3,"Createtime":"2020-07-21T14:36:27.457"}}
]}'

select * from openjson(@json2,'$.myRoot')
with(
id varchar(10) ,
Plies  int '$.myObject.Plies',
Createtime datetime '$.myObject.Createtime'
);
--id    Plies    Createtime
--1178    3    2020-07-21 14:33:18.480
--1179    3    2020-07-21 14:36:27.457

三、JSON函數

declare @param nvarchar(max);

set @param = N'{  
     "info":{    
       "type":1,  
       "address":{    
         "town":"Bristol",  
         "county":"Avon",  
         "country":"England"  
       },  
       "tags":["Sport", "Water polo"]  
    },  
    "type":"Basic"  
 }';

1、ISJSON:測試字串是否包含有效 JSON。

print iif(isjson(@param) > 0, 'OK', 'NO');

返回:OK

2、JSON_VALUE :從 JSON 字串中提取標量值。

print json_value(@param, '$.info.address.town');
print json_value(@param, '$.info.tags[1]');

返回:Bristol,Water polo

3、JSON_QUERY :從 JSON 字串中提取物件或陣列。返回型別為 nvarchar(max) 的 JSON 片段

print json_query(@param, '$.info');
{    
       "type":1,  
       "address":{    
         "town":"Bristol",  
          "county":"Avon",  
          "country":"England"  
        },  
        "tags":["Sport", "Water polo"]  
}

4、JSON_MODIFY :更新 JSON 字串中屬性的值,並返回已更新的 JSON 字串。

print json_modify(@param, '$.info.address.town', 'London');

返回:

{  
     "info":{    
       "type":1,  
       "address":{    
         "town":"London",  
         "county":"Avon",  
          "country":"England"  
        },  
        "tags":["Sport", "Water polo"]  
     },  
     "type":"Basic"  
  }

範例演示:

declare @param nvarchar(max);
set @param=N'{  
     "info":{    
       "type":1,  
       "address":{    
         "town":"Bristol",  
         "county":"Avon",  
         "country":"England"  
       },  
       "tags":["Sport", "Water polo"]  
    },  
    "type":"Basic"  
 }';

print iif(isjson(@param)>0, 'OK', 'NO');
print json_query(@param);
print json_value(@param, '$.info.address.town');
print json_value(@param, '$.info.tags[1]');
print json_query(@param, '$.info');
print json_query('["2020-1-8","2020-1-9"]');
print json_modify(@param, '$.info.address.town', 'London');

四、注意事項

SQL2016 中的新增的內建JSON進行了簡單介紹,主要有如下要點:

  • JSON能在SQLServer2016中高效的使用,但是JSON並不是原生資料型別;
  • 如果使用JSON格式必須為輸出結果是表示式的提供別名;
  • JSON_VALUE 和 JSON_QUERY  函數轉移和獲取Varchar格式的資料,因此必須將資料轉譯成你需要的型別。
  • 在計算列的幫助下查詢JSON可以使用索引進行優化。

到此這篇關於SQL Server使用JSON函數的文章就介紹到這了。希望對大家的學習有所幫助,也希望大家多多支援it145.com。


IT145.com E-mail:sddin#qq.com