SQL Server 中 `JSON_MODIFY` 的使用

SQL Server 中 JSON_MODIFY 的使用

Intro

SQL Server 從 2016 開始支持了一些 JSON操做，最近的項目裏也是好多地方字段直接存成了 JSON，須要瞭解一下怎麼在SQL Server 中操做 JSON.

JSON支持適用於 SQL Server 2016 及以上版本 和 Azure SQL Database。

最近在項目中不少地方字段都是存一個 JSON 字符串，尤爲是針對一些有不少不肯定的屬性的數據來講，這樣的信息咱們通常都放在一個 Extra 之類的字段保存一個 JSON 字符串，因爲不肯定性很大，頗有可能會遇到要修改這個 JSON 字符串結構的問題，在修改 JSON 對象的某一個值和修改 JSON 的結構時都會用到 JSON_MODIFY，今天就來介紹一下 JSON_MODIFY 的使用

示例

直接來看示例：

-- JSON_MODIFY 測試
DECLARE @testJsonValue NVARCHAR(100) = N'{"name":"John","skills":["C#","SQL"]}';
PRINT @testJsonValue;

-- 適用 append 在數組中追加元素
PRINT JSON_MODIFY(@testJsonValue, 'append $.skills', 'Azure');

-- 無效用法，這樣會把屬性更新爲字符串
PRINT JSON_MODIFY(@testJsonValue, '$.skills', '["C#","T-SQL","Azure"]');

-- 修改數組
PRINT JSON_MODIFY(@testJsonValue, '$.skills', JSON_QUERY('["C#","T-SQL","Azure"]'));
-- 修改數組某個元素
PRINT JSON_MODIFY(@testJsonValue, '$.skills[0]', 'CSharp');


-- 增長屬嵌套
PRINT JSON_MODIFY(@testJsonValue, '$.Likes', JSON_QUERY('{"Girl": "Alice"}'));
PRINT JSON_MODIFY(@testJsonValue, '$.Likes', JSON_QUERY('{"Animals": ["Dog","Cat"]}'));

-- 增長 bool 屬性
PRINT JSON_MODIFY(@testJsonValue, '$.ShowAwardsAfterQuizEnds', CONVERT(BIT, 'false'));
PRINT JSON_MODIFY(@testJsonValue, '$.ShowAwardsAfterQuizEnds', CONVERT(BIT, 1));

-- 增長 int 屬性
PRINT JSON_MODIFY(@testJsonValue, '$.TotalWinnersCount', CONVERT(INT, '20'));
PRINT JSON_MODIFY(@testJsonValue, '$.TotalWinnersCount', 20);

-- 刪除屬性
PRINT JSON_MODIFY(@testJsonValue, '$.name', NULL);

輸出結果以下圖：

More

注意：

• 若是要更新的字段沒有是一個 JSON 對象或是一個數組，那麼須要使用 JSON_QUERY ，不然更新的對應的屬性就成了字符串了。

• 若是是要刪除某一個屬性，把某一個屬性更新爲 NULL 便可

• 若是要增長一個 bool 類型的屬性，須要把對應的值轉換爲 BIT 類型

Reference

• https://docs.microsoft.com/en-us/sql/t-sql/functions/json-modify-transact-sql?view=sql-server-ver15
• https://docs.microsoft.com/en-us/sql/relational-databases/json/json-path-expressions-sql-server?view=sql-server-ver15