MySQL 中的 JSON_CONTAINS 函数详解

作者: adm 分类: mysql 发布时间: 2023-12-04

在处理 MySQL 中的 JSON 数据时,我们经常需要检查一个 JSON 文档是否包含特定的值。这时,JSON_CONTAINS 函数就显得非常有用。

JSON_CONTAINS函数介绍
JSON_CONTAINS 是 MySQL 提供的一个 JSON 函数,用于测试一个 JSON 文档是否包含特定的值。如果包含则返回 1,否则返回 0。该函数接受三个参数:

target: 待搜索的目标 JSON 文档。
candidate: 在目标 JSON 文档中要搜索的值。
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”‘) 在大多数情况下的结果是相同的,但是它们在某些特殊场景下的处理策略是有区别的。

details->’$.metadata.color’ 这种写法先从 details 字段的 metadata.color 部分取出值,然后以此为基础进行 JSON_CONTAINS 操作。如果你想在获取的 JSON 片段上进行进一步的操作,这种方式会更方便。

JSON_CONTAINS(details, ‘”red”‘, ‘$.metadata.color’) 直接在 details 字段中执行了 JSON_CONTAINS,在查找过程中指定了路径。它是一个单独的表达式,不能直接用于进一步提取或操作 JSON 数据。但如果你只是简单地检查指定路径下是否包含特定值,那么这种方法就足够了。

实际使用哪种方式,取决于你的具体需求和场景。

总的来说,JSON_CONTAINS 是一个功能强大的函数,使我们能够以灵活、高效的方式在 MySQL 中处理 JSON 数据。希望本文能帮助你更好地理解和使用这个函数。

如果觉得我的文章对您有用,请随意赞赏。您的支持将鼓励我继续创作!