MySQL 中的 JSON_CONTAINS 函数详解

在处理 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 数据。希望本文能帮助你更好地理解和使用这个函数。