SQL Server（00）：JSON 函數

      SQL Server 2005開始支持XML數據類型，提供原生的XML數據類型、XML索引及各種管理或輸出XML格式的函數。隨着JSON的流行，SQL Server2016開始支持JSON數據類型，不僅可以直接輸出JSON格式的結果集，還能讀取JSON格式的數據。

下面是我們熟悉的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放在里面：

二、 解析JSON格式的數據

1、使用OPENJSON()函數：

2、通過WITH選項，自定義輸出列：

三、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 字符串中提取對象或數組。

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

四、注意事項

SQL2016 中的新增的內置JSON進行了簡單介紹，主要有如下要點：

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