如何在SQL Server 2016及以上版本中解析JSON数据?

浅墨君_7222

浅墨君_7222

2026-09-13

332人浏览

原创

应直接使用openjson而非自定义函数;其默认返回key、value、type三列,with子句可映射强类型结构;注意json_value仅取标量、json_query取对象/数组;兼容级别须≥130,存储用nvarchar(max)。

如何在sql server 2016及以上版本中解析json数据?

直接用 OPENJSON,别写自定义函数——SQL Server 2016+ 原生支持已足够可靠,性能远超 CLR 或 T-SQL 手动解析。

OPENJSON 默认行为返回三列:key、value、type

不带 WITH 子句时,OPENJSON 把 JSON 对象每个属性或数组每个元素展开成一行,固定返回三列:

  • key:对象中字段名,或数组中索引(字符串形式,如 "0"、"1")
  • value:该字段/元素的值(始终为 nvarchar(max))
  • type:值类型编号(0=string,1=int,2=real,3=bool,4=array,5=object,6=null)

常见错误:直接 SELECT * FROM OPENJSON(@json) 后想用 WHERE value = 25 ——会失败,因为 value 是字符串,需显式转换,比如 CAST(value AS int)。

用 WITH 子句定义结构化输出

这才是生产环境正确用法:OPENJSON 配合 WITH 能把嵌套 JSON 映射成强类型列,避免手动 JSON_VALUE 拼接。

关键点:

  • WITH 中路径以 $ 开头,$.skills[0] 表示数组首项,$.address.city 表示嵌套对象字段
  • 列类型必须明确指定,如 name nvarchar(50) '$.name';若 JSON 中该字段为 null,对应列值也为 null(不报错)
  • 数组需用 OPENJSON(json_col, '$.array_path') 显式指定路径,再在 WITH 中映射子项

示例:解析 { "id": 1, "name": "Alice", "tags": ["dev", "sql"] }

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
SELECT id, name, tag
FROM OPENJSON(@json)
WITH (
  id int '$.id',
  name nvarchar(50) '$.name'
) AS hdr
CROSS APPLY OPENJSON(@json, '$.tags') 
  WITH (tag nvarchar(20) '$') AS tags;

JSON_VALUE 和 JSON_QUERY 的分工要清楚

JSON_VALUE 提取标量值(string/int/bool),JSON_QUERY 提取子对象或数组(保持 JSON 结构)——混用会导致意外截断或类型错误。

典型陷阱:

  • 对数组字段误用 JSON_VALUE:如 JSON_VALUE(@json, '$.skills') 返回 null,因为 skills 是数组,不是标量;必须用 JSON_QUERY
  • 对深层嵌套对象漏掉中间层级:如 JSON_VALUE(@json, '$.user.profile.age') 在 profile 为 null 时直接返回 null,不会报错,但可能掩盖数据缺失问题
  • JSON_QUERY 返回结果仍是 nvarchar(max),不能直接参与数值计算,需先用 OPENJSON 展开

兼容性级别和存储格式容易被忽略

OPENJSON 和所有 JSON 函数要求数据库兼容性级别 ≥ 130(即 SQL Server 2016+)。哪怕你连的是 SQL Server 2025,如果数据库是从旧版本升级而来且未手动升级兼容级别,JSON 功能仍不可用。

检查方式:SELECT compatibility_level FROM sys.databases WHERE name = DB_NAME();

升级命令:ALTER DATABASE CURRENT SET COMPATIBILITY_LEVEL = 150;(根据实际版本选 130/140/150/160/170)

另外,JSON 数据仍建议存为 nvarchar(max),SQL Server 2025 新增的 json 类型目前仅限 Azure SQL 和预览版,本地 SQL Server 2019/2022 不支持,强行使用会报错 Invalid data type 'json'。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json json处理 json数组

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

1975

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2662

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

916

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

2959

7

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

4451

4

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

20

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

0

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

0

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.5万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.7万人学习