SQL Server 2016 JSON原生辅助实例证实

发布时间:2019-02-02  栏目:SQL  评论:0 Comments

背景

Microsoft SQL Server
对于数据平台的开发者来说尤为友好。比如曾经原生辅助XML很多年了,在这么些方向下,方今也能在SQLServer2016中动用内置的JSON。尤其对于部分大数据很数据接口的分析环节来说那显示格外有价值。与大家明日所做诸如在SQL中利用CLR或者自定义的函数来解析JSON相相比,新的放权JSON会大大升高质量,同时优化了编程以及增删查改等措施。

   
那么是不是代表大家可以屏弃XML,然后先河选择JSON?当然不是,那取决数量输出处理的目标。假如有一个外表的经过XML与外部交互数据的劳务并且内外的架构是千篇一律的,那么应该是接纳XML数据类型以及原生的函数。假如是本着微型服务架构或者动态元数据和多少存储,那么久应该利用流行的JSON函数。

背景

Microsoft SQL Server
对于数据平台的开发者来说更是友好。比如曾经原生协理XML很多年了,在那个主旋律下,近年来也能在SQLServer2016中采用内置的JSON。尤其对于部分大数量很数据接口的辨析环节来说那显得非凡有价值。与大家现在所做诸如在SQL中选择CLR或者自定义的函数来解析JSON相相比,新的松开JSON会大大升高质量,同时优化了编程以及增删查改等办法。

   
那么是还是不是代表我们得以扬弃XML,然后初阶利用JSON?当然不是,那取决数量输出处理的目的。如若有一个外表的通过XML与外表交互数据的劳务并且内外的架构是同等的,那么应该是接纳XML数据类型以及原生的函数。借使是指向微型服务架构或者动态元数据和数量存储,那么久应该利用新型的JSON函数。

实例

    当使用查询那个早已有一定架构的JSON的多少表时,使用“FOR
JSON

提醒在你的T-SQL脚本前面,用那种办法以便于格式化输出。一下实例我动用了SQLServer
2016 Worldwide Importers sample
database,可以在GitHub上一向下载下来(下载地址)。看一下视图Website.customers。咱俩询问一个数额并格式化输出JSON格式:

SELECT [CustomerID]
      ,[CustomerName]
      ,[CustomerCategoryName]
      ,[PrimaryContact]
      ,[AlternateContact]
      ,[PhoneNumber]
      ,[FaxNumber]
      ,[BuyingGroupName]
      ,[WebsiteURL]
      ,[DeliveryMethod]
      ,[CityName]

 ,DeliveryLocation.ToString() as DeliveryLocation
      ,[DeliveryRun]
      ,[RunPosition]
  FROM [WideWorldImporters].[Website].[Customers]
  WHERE CustomerID=1
  FOR JSON AUTO

  

 

请留意大家有一个地理数据类型列(DeliveryLocation),那亟需引入四个重大的浮动方案(标黄):

第一,要求转移一个string字符,否则就会报错:

FOR JSON cannot serialize CLR objects. Cast CLR types explicitly into one of the supported types in FOR JSON queries.

附带,JSON采纳键值对的语法由此必须指定一个别名来转换数据,如若失利会冒出上边的不当:

Column expressions and data sources without names or aliases cannot be formatted as JSON text using FOR JSON clause. Add alias to the unnamed column or table.

确认了那几个,改写的格式化输出如下:

[
    {
        "CustomerID": 1,
        "CustomerName": "Tailspin Toys (Head Office)",
        "CustomerCategoryName": "Novelty Shop",
        "PrimaryContact": "Waldemar Fisar",
        "AlternateContact": "Laimonis Berzins",
        "PhoneNumber": "(308) 555-0100",
        "FaxNumber": "(308) 555-0101",
        "BuyingGroupName": "Tailspin Toys",
        "WebsiteURL": "http://www.tailspintoys.com",
        "DeliveryMethod": "Delivery Van",
        "CityName": "Lisco",
        "DeliveryLocation": "POINT (-102.6201979 41.4972022)",
        "DeliveryRun": "",
        "RunPosition": ""
    }
]

  

 

本来也得以利用JSON作为输入型DML语句,例如INSERT/UPDATE/DELETE
语句中采纳“OPENJSON”。因而可以在具有的多寡操作上投入JSON提醒。

如若不打听数据结构或者想让其越发灵敏,那么可以将数据存储为一个JSON格式的字符类型,改列的档次可以使NVARCHAR
类型。Application.People 表中的CustomFields
列就是卓绝群伦那种情形。可以用如下语句看一下报表格式那几个列的情节:

declare @json nvarchar(max)

SELECT @json=[CustomFields]
FROM [WideWorldImporters].[Application].[People]
where PersonID=8

select * from openjson(@json)

  

 

结果集在表格结果中的呈现:

图片 1

 

用另一种方式来询问那条记下,前提是必要精通在JSON数据结构和关键的名字,使用JSON_VALUE
JSON_QUERY
函数:

  SELECT
       JSON_QUERY([CustomFields],'$.OtherLanguages') as OtherLanguages,
       JSON_VALUE([CustomFields],'$.HireDate') as HireDate,
       JSON_VALUE([CustomFields],'$.Title') as Title,
       JSON_VALUE([CustomFields],'$.PrimarySalesTerritory') as PrimarySalesTerritory,
       JSON_VALUE([CustomFields],'$.CommissionRate') as CommissionRate
  FROM [WideWorldImporters].[Application].[People]
  where PersonID=8

  

 

在表格结果集中显示表格格式的结果:

图片 2

 

本条地方最关心就是查询条件和添加索引。设想一下大家打算去询问所有二〇一一年过后雇佣的人,你能够运作上面的查询语句:

SELECT personID,fullName,JSON_VALUE(CustomFields,'$.HireDate') as hireDate
FROM [WideWorldImporters].[Application].[People]
where IsEmployee=1
and year(cast(JSON_VALUE(CustomFields,'$.HireDate') as date))>2011

  

 

切记JSON_VALUE
重回一个单纯的文本值(nvarchar(4000))。需求更换重返值到一个时间字段中,然后分别年来筛选查询条件。实际施行布署如下:

图片 3

 

为了注脚怎么样对JSON内容创造索引,需求创立一个计算列。为了举例表达,Application.People
表标记版本,并且参与总括列,当系统版本为ON的时候不帮忙。大家那里运用Sales.Invoices表,其中ReturnedDeliveryData
中插入json数据。接下来获取数据,感受一下:

SELECT TOP 100 [InvoiceID]
      ,[CustomerID]
      ,JSON_QUERY([ReturnedDeliveryData],'$.Events')
  FROM [WideWorldImporters].[Sales].[Invoices]

  

 

察觉结果集第二个event都是“Ready for collection”:

图片 4

 

接下来拿走二零一六年5月的发票数量:

SELECT [InvoiceID]
      ,[CustomerID]
      ,CONVERT(datetime, CONVERT(varchar,JSON_VALUE([ReturnedDeliveryData],'$.Events[0].EventTime')),126)
  FROM [WideWorldImporters].[Sales].[Invoices]
  WHERE CONVERT(datetime, CONVERT(varchar,JSON_VALUE([ReturnedDeliveryData],'$.Events[0].EventTime')),126)
       BETWEEN '20160301' AND '20160331'

  

实质上履行安排如下:

图片 5

 

    参与一个计算列叫做“ReadyDate”, 准备好集合表明式的结果:

ALTER TABLE [WideWorldImporters].[Sales].[Invoices]
ADD ReadyDate AS CONVERT(datetime, CONVERT(varchar,JSON_VALUE([ReturnedDeliveryData],'$.Events[0].EventTime')),126)

  

 

尔后,重新履行查询,不过利用新的总结列作为基准:

SELECT [InvoiceID]
      ,[CustomerID]
      ,ReadyDate
  FROM [WideWorldImporters].[Sales].[Invoices]
  WHERE ReadyDate BETWEEN '20160301' AND '20160331'

  

 

举办布置是平等的,除了SSMS提出的缺失索引:

图片 6

 

由此,依据提议在测算列上建立索引来协助查询,建立目录如下:

/*
The Query Processor estimates that implementing the following index could improve the query cost by 99.272%.
*/
CREATE NONCLUSTERED INDEX IX_Invoices_ReadyDate
ON [Sales].[Invoices] ([ReadyDate])
INCLUDE ([InvoiceID],[CustomerID])
GO

  

 

俺们重新履行查询证实执行安排:

图片 7

 

有了目录之后,大大提升了品质,并且询问JSON的快慢和表列是平等快的。

实例

    当使用查询这一个曾经有定点架构的JSON的数码表时,使用“FOR
JSON

提醒在您的T-SQL脚本后边,用这种措施以便于格式化输出。一下实例我利用了SQLServer
2016 Worldwide Importers sample
database,可以在GitHub上平素下载下来(下载地址)。看一下视图Website.customers。大家查询一个数量并格式化输出JSON格式:

SELECT [CustomerID]
      ,[CustomerName]
      ,[CustomerCategoryName]
      ,[PrimaryContact]
      ,[AlternateContact]
      ,[PhoneNumber]
      ,[FaxNumber]
      ,[BuyingGroupName]
      ,[WebsiteURL]
      ,[DeliveryMethod]
      ,[CityName]

 ,DeliveryLocation.ToString() as DeliveryLocation
      ,[DeliveryRun]
      ,[RunPosition]
  FROM [WideWorldImporters].[Website].[Customers]
  WHERE CustomerID=1
  FOR JSON AUTO

  

 

请留意大家有一个地理数据类型列(DeliveryLocation),那需求引入多少个主要的浮动方案(标黄):

首先,必要更换一个string字符,否则就会报错:

FOR JSON cannot serialize CLR objects. Cast CLR types explicitly into one of the supported types in FOR JSON queries.

说不上,JSON采取键值对的语法由此必须指定一个别名来转换数据,如果败北会现出上边的失实:

Column expressions and data sources without names or aliases cannot be formatted as JSON text using FOR JSON clause. Add alias to the unnamed column or table.

肯定了那几个,改写的格式化输出如下:

[
    {
        "CustomerID": 1,
        "CustomerName": "Tailspin Toys (Head Office)",
        "CustomerCategoryName": "Novelty Shop",
        "PrimaryContact": "Waldemar Fisar",
        "AlternateContact": "Laimonis Berzins",
        "PhoneNumber": "(308) 555-0100",
        "FaxNumber": "(308) 555-0101",
        "BuyingGroupName": "Tailspin Toys",
        "WebsiteURL": "http://www.tailspintoys.com",
        "DeliveryMethod": "Delivery Van",
        "CityName": "Lisco",
        "DeliveryLocation": "POINT (-102.6201979 41.4972022)",
        "DeliveryRun": "",
        "RunPosition": ""
    }
]

  

 

当然也足以使用JSON作为输入型DML语句,例如INSERT/UPDATE/DELETE
语句中应用“OPENJSON”。由此可以在享有的多少操作上参加JSON提醒。

倘使不打听数据结构或者想让其更为灵敏,那么可以将数据存储为一个JSON格式的字符类型,改列的体系可以使NVARCHAR
类型。Application.People 表中的CustomFields
列就是压倒元白那种景色。能够用如下语句看一下报表格式那么些列的内容:

declare @json nvarchar(max)

SELECT @json=[CustomFields]
FROM [WideWorldImporters].[Application].[People]
where PersonID=8

select * from openjson(@json)

  

 

结果集在报表结果中的呈现:

图片 8

 

用另一种艺术来查询那条记下,前提是内需精通在JSON数据结构和重大的名字,使用JSON_VALUE
JSON_QUERY
函数:

  SELECT
       JSON_QUERY([CustomFields],'$.OtherLanguages') as OtherLanguages,
       JSON_VALUE([CustomFields],'$.HireDate') as HireDate,
       JSON_VALUE([CustomFields],'$.Title') as Title,
       JSON_VALUE([CustomFields],'$.PrimarySalesTerritory') as PrimarySalesTerritory,
       JSON_VALUE([CustomFields],'$.CommissionRate') as CommissionRate
  FROM [WideWorldImporters].[Application].[People]
  where PersonID=8

  

 

在表格结果集中浮现表格格式的结果:

图片 9

 

以此地点最关怀就是查询条件和添加索引。设想一下大家打算去查询所有二零一一年之后雇佣的人,你可以运作下边的查询语句:

SELECT personID,fullName,JSON_VALUE(CustomFields,'$.HireDate') as hireDate
FROM [WideWorldImporters].[Application].[People]
where IsEmployee=1
and year(cast(JSON_VALUE(CustomFields,'$.HireDate') as date))>2011

  

 

切记JSON_VALUE
重回一个十足的文本值(nvarchar(4000))。必要转移重返值到一个时日字段中,然后分别年来筛选查询条件。实际履行布置如下:

图片 10

 

为了求证怎么着对JSON内容成立索引,须求创设一个统计列。为了举例表达,Application.People
表标记版本,并且参估计算列,当系统版本为ON的时候不帮助。咱们那里运用Sales.Invoices表,其中ReturnedDeliveryData
中插入json数据。接下来获取数据,感受一下:

SELECT TOP 100 [InvoiceID]
      ,[CustomerID]
      ,JSON_QUERY([ReturnedDeliveryData],'$.Events')
  FROM [WideWorldImporters].[Sales].[Invoices]

  

 

发现结果集第三个event都是“Ready for collection”:

图片 11

 

然后拿走二零一六年2月的发票数额:

SELECT [InvoiceID]
      ,[CustomerID]
      ,CONVERT(datetime, CONVERT(varchar,JSON_VALUE([ReturnedDeliveryData],'$.Events[0].EventTime')),126)
  FROM [WideWorldImporters].[Sales].[Invoices]
  WHERE CONVERT(datetime, CONVERT(varchar,JSON_VALUE([ReturnedDeliveryData],'$.Events[0].EventTime')),126)
       BETWEEN '20160301' AND '20160331'

  

实际执行安顿如下:

图片 12

 

    出席一个统计列叫做“ReadyDate”, 准备好集合表明式的结果:

ALTER TABLE [WideWorldImporters].[Sales].[Invoices]
ADD ReadyDate AS CONVERT(datetime, CONVERT(varchar,JSON_VALUE([ReturnedDeliveryData],'$.Events[0].EventTime')),126)

  

 

之后,重新履行查询,不过利用新的总括列作为规范:

SELECT [InvoiceID]
      ,[CustomerID]
      ,ReadyDate
  FROM [WideWorldImporters].[Sales].[Invoices]
  WHERE ReadyDate BETWEEN '20160301' AND '20160331'

  

 

实施部署是一律的,除了SSMS提议的缺失索引:

图片 13

 

为此,根据指出在测算列上建立索引来扶助查询,建立目录如下:

/*
The Query Processor estimates that implementing the following index could improve the query cost by 99.272%.
*/
CREATE NONCLUSTERED INDEX IX_Invoices_ReadyDate
ON [Sales].[Invoices] ([ReadyDate])
INCLUDE ([InvoiceID],[CustomerID])
GO

  

 

咱俩重新履行查询求证执行布署:

图片 14

 

有了目录之后,大大提高了质量,并且询问JSON的速度和表列是一律快的。

总结:

本篇通过对SQL2016 中的新增的嵌入JSON举行了简短介绍,主要有如下要点:

 

  • JSON能在SQLServer2016中快速的使用,可是JSON并不是原生数据类型;
  • 若果利用JSON格式必须为出口结果是表达式的提供别名;
  • JSON_VALUE 和 JSON_QUERY 
    函数转移和获取Varchar格式的多少,因而必须将数据转译成你要求的品种。
  • 在总计列的提携下询问JSON可以使用索引举行优化。

总结:

本篇通过对SQL2016 中的新增的放权JSON举行了简便介绍,首要有如下要点:

 

  • JSON能在SQLServer2016中高速的选择,可是JSON并不是原生数据类型;
  • 万一利用JSON格式必须为出口结果是表明式的提供别名;
  • JSON_VALUE 和 JSON_QUERY 
    函数转移和获取Varchar格式的数码,由此必须将数据转译成你必要的档次。
  • 在盘算列的扶植下询问JSON可以拔取索引举行优化。

留下评论

网站地图xml地图