从零个或更多表达式中构造 JSON 数组文本。
JSON_ARRAY ( [ <json_array_value> [,...n] ] [ <json_null_clause> ] )
<json_array_value> ::= value_expression
<json_null_clause> ::=
NULL ON NULL
| ABSENT ON NULL
json_array_value 是定义 JSON 数组中元素值的表达式。
json_null_clause 可用于控制 JSON_OBJECT 函数在 value_expression 为 NULL 时的行为。 在生成 JSON 数组中的元素值时,选项 NULL ON NULL 将 SQL NULL 值转换为 JSON 空值。 如果值为 NULL,选项 ABSENT ON NULL 将省略 JSON 数组中的元素。 此选项的默认设置为 ABSENT ON NULL。
有关 JSON_ARRAY
函数输出内容的详细信息,请参阅以下文章:
FOR JSON 如何将 SQL Server 数据类型转换为 JSON 数据类型 (SQL Server)
JSON_ARRAY
函数使用 FOR JSON
本文中描述的规则,在 JSON 数组输出中把 SQL 数据类型转换成 JSON 类型。
FOR JSON 如何转义特殊字符和控制字符 (SQL Server)
JSON_ARRAY
函数按照这篇 FOR JSON
文章中描述的方式在 JSON 输出中转义特殊字符和表示控制字符。
返回 nvarchar(max) 类型的有效 JSON 数组字符串。
以下示例返回空 JSON 数组。
SELECT JSON_ARRAY();
以下示例返回具有四个元素的 JSON 数组。
SELECT JSON_ARRAY('a', 1, 'b', 2)
["a",1,"b",2]
以下示例返回具有三个元素的 JSON 数组,因为其中一个输入值为 NULL。 由于省略 json_null_clause 且该选项的默认值为 ABSENT ON NULL,所以其中一个输入的 NULL 值不会被转换为 JSON 空值。
SELECT JSON_ARRAY('a', 1, 'b', NULL)
["a",1,"b"]
以下示例返回具有四个元素的 JSON 数组。 指定 NULL ON NULL 选项是为了让输入中的任意 SQL NULL 值在 JSON 数组中转换为 JSON 空值。
SELECT JSON_ARRAY('a', 1, NULL, 2 NULL ON NULL)
["a",1,null,2]
以下示例返回具有两个元素的 JSON 数组。 一个元素包含 JSON 字符串,另一个元素包含 JSON 对象。
SELECT JSON_ARRAY('a', JSON_OBJECT('name':'value', 'type':1))
["a",{"name":"value","type":1}]
以下示例返回具有三个元素的 JSON 数组。 一个元素包含 JSON 字符串,另一个元素包含 JSON 对象,而另一个元素包含 JSON 数组。
SELECT JSON_ARRAY('a', JSON_OBJECT('name':'value', 'type':1), JSON_ARRAY(1, null, 2 NULL ON NULL))
["a",{"name":"value","type":1},[1,null,2]]
以下示例返回 JSON 数组,其输入指定为变量或 SQL 表达式。
DECLARE @id_value nvarchar(64) = NEWID();
SELECT JSON_ARRAY(1, @id_value, (SELECT @@SPID));
[1,"4BEA4F9F-D169-414F-AF99-9270FDB2EA62",55]
以下示例返回查询中每行的 JSON 数组。
SELECT s.session_id, JSON_ARRAY(s.host_name, s.program_name, s.client_interface_name)
FROM sys.dm_exec_sessions AS s
WHERE s.is_user_process = 1;
session_id
["WIN16-VM","Microsoft SQL Server Management Studio - Query",".Net SqlClient Data Provider"]
["WIN16-VM","Microsoft SQL Server Management Studio - Query",".Net SqlClient Data Provider"]
["WIN19-VM","SQLServerCEIP",".Net SqlClient Data Provider"]
JSON 数据 (SQL Server)