SQL Server之JSON 函数详解

admin MsSQL 2022-02-09 18:34:36 SQL Server JSON"

SQL Server 2005开始支持XML数据类型，提供原生的XML数据类型、XML索引及各种管理或输出XML格式的函数。随着JSON的流行，SQL Server2016开始支持JSON数据类型，不仅可以直接输出JSON格式的结果集，还能读取JSON格式的数据。

1 概述

本篇文件将结合MSND简要分析Sqlserver中JSON函数，主要包括ISJSON,JSON_VALUE,JSON_MODIFY,JSON_QUERY。

2 具体内容

2.1 JSON 函数

使用本节中页面中描述的功能来验证或更改JSON文本或提取简单或复杂的值。

有关在SQL Server中内置JSON支持的更多信息，请参阅JSON数据（SQL Server）。

2.2 ISJSON

测试字符串是否包含有效的JSON。

2.2.1 例子

2.3 JSON_VALUE

从JSON字符串中提取标量值。

要从JSON字符串而不是标量值中提取对象或数组，请参阅JSON_QUERY（Transact-SQL）。有关JSON_VALUE和JSON_QUERY之间的差异的信息，请参阅比较JSON_VALUE和JSON_QUERY。

2.4 JSON_QUERY

从JSON字符串中提取对象或数组。

要从JSON字符串而不是对象或数组中提取标量值，请参阅JSON_VALUE（Transact-SQL）。有关JSON_VALUE和JSON_QUERY之间的差异的信息，请参阅比较JSON_VALUE和JSON_QUERY。

2.5 JSON_MODIFY

更新JSON字符串中的属性值，并返回更新的JSON字符串。

小结

3 参考文献

【01】https://docs.microsoft.com/zh-cn/sql/t-sql/language-elements/expressions-transact-sql

4 版权

感谢您的阅读，若有不足之处，欢迎指教，共同学习、共同进步。

以下是一些补充

下面是我们熟悉的SELECT及输出格式，后面对JSON的演示基于此SQL：

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进行了简单介绍，主要有如下要点：