在處理 MySQL 中的 JSON 數據時，我們經常需要檢查一個 JSON 文檔是否包含特定的值。這時，JSON_CONTAINS 函數就顯得非常有用。

JSON_CONTAINS函數介紹

JSON_CONTAINS 是 MySQL 提供的一個 JSON 函數，用于測試一個 JSON 文檔是否包含特定的值。如果包含則返回 1，否則返回 0。該函數接受三個參數：

1. target: 待搜索的目標 JSON 文檔。
2. candidate: 在目標 JSON 文檔中要搜索的值。
3. path（可選）： 路徑表達式，指示在哪里搜索候選值。

一般的使用語法為：

JSON_CONTAINS(target, candidate[, path])

JSON_CONTAINS函數實例演示

假設我們有一個名為 products 的表，其中包含了一些產品信息：

CREATE TABLE products (id INT AUTO_INCREMENT PRIMARY KEY,details JSON
);INSERT INTO products (details)
VALUES 
('{"name": "Product 1", "tags": ["tag1", "tag2", "tag3"]}'),
('{"name": "Product 2", "tags": ["tag1", "tag4"]}');

現在，我們想要找出所有包含 "tag1" 標簽的產品。我們可以利用 JSON_CONTAINS 函數來實現這個需求：

SELECT * FROM products WHERE JSON_CONTAINS(details->'$.tags', '"tag1"');

JSON_CONTAINS函數的路徑參數

JSON_CONTAINS 函數提供了一個可選的 path 參數，用于指定應在 JSON 文檔的哪個部分搜索候選值。這個參數的值應該是一個 JSON 路徑表達式。

SELECT * FROM products WHERE JSON_CONTAINS(details, '"red"', '$.metadata.color');

在這條查詢中，$.metadata.color 是路徑表達式，表示我們要在 details JSON 文檔的 metadata.color 段中搜索 "red" 值。

JSON_CONTAINS函數的兩種使用方式比較

雖然 JSON_CONTAINS(details, '"red"', '$.metadata.color') 和 JSON_CONTAINS(details->'$.metadata.color', '"red"') 在大多數情況下的結果是相同的，但是它們在某些特殊場景下的處理策略是有區別的。

1. details->'$.metadata.color' 這種寫法先從 details 字段的 metadata.color 部分取出值，然后以此為基礎進行 JSON_CONTAINS 操作。如果你想在獲取的 JSON 片段上進行進一步的操作，這種方式會更方便。

2. JSON_CONTAINS(details, '"red"', '$.metadata.color') 直接在 details 字段中執行了 JSON_CONTAINS，在查找過程中指定了路徑。它是一個單獨的表達式，不能直接用于進一步提取或操作 JSON 數據。但如果你只是簡單地檢查指定路徑下是否包含特定值，那么這種方法就足夠了。

實際使用哪種方式，取決于你的具體需求和場景。

總的來說，JSON_CONTAINS 是一個功能強大的函數，使我們能夠以靈活、高效的方式在 MySQL 中處理 JSON 數據。希望本文能幫助你更好地理解和使用這個函數。