MariaDB JSON_LENGTH() 函数的基础用法与实例

MariaDB JSON_LENGTH() 函数是一个用于返回 JSON 值的长度的函数。它可以接受一个或两个参数，第一个参数是一个 JSON 值，第二个参数是一个可选的 JSON 路径，表示要返回的子值。该函数返回一个整数，表示指定的 JSON 值的长度。如果参数中有非 JSON 值，或者指定的路径不存在，那么该函数会返回 NULL。

语法

MariaDB JSON_LENGTH() 函数的语法如下：

JSON_LENGTH(json_val[, path])

其中：

json_val 是一个 JSON 值，可以是一个 JSON 字符串，也可以是一个 JSON 列。
path 是一个可选的 JSON 路径，表示要返回的子值。

实例

下面是一些使用 MariaDB JSON_LENGTH() 函数的实例。

返回一个标量值的长度

假设我们有一个标量值，比如 1：

SET @json = '1';

我们可以使用 MariaDB JSON_LENGTH() 函数，返回这个值的长度：

SELECT JSON_LENGTH(@json) AS result;

运行结果如下：

+--------+
| result |
+--------+
|      1 |
+--------+

这是因为一个标量值的长度总是 1。

返回一个数组的长度

假设我们有一个数组，比如 ["apple", "banana", "cherry"]：

SET @json = '["apple", "banana", "cherry"]';

我们可以使用 MariaDB JSON_LENGTH() 函数，返回这个数组的长度：

SELECT JSON_LENGTH(@json) AS result;

运行结果如下：

+--------+
| result |
+--------+
|      3 |
+--------+

这是因为一个数组的长度是它的元素个数。

返回一个对象的长度

假设我们有一个对象，比如 {"name": "Alice", "age": 18, "hobbies": ["reading", "music", "travel"]}：

SET @json = '{"name": "Alice", "age": 18, "hobbies": ["reading", "music", "travel"]}';

我们可以使用 MariaDB JSON_LENGTH() 函数，返回这个对象的长度：

SELECT JSON_LENGTH(@json) AS result;

运行结果如下：

+--------+
| result |
+--------+
|      3 |
+--------+

这是因为一个对象的长度是它的属性个数。

返回一个路径指定的子值的长度

假设我们有一个嵌套的 JSON 值，比如 [{"title": "The Catcher in the Rye", "author": "J.D. Salinger", "year": 1951}, {"title": "Nineteen Eighty-Four", "author": "George Orwell", "year": 1949}]：

SET @json = '[{"title": "The Catcher in the Rye", "author": "J.D. Salinger", "year": 1951}, {"title": "Nineteen Eighty-Four", "author": "George Orwell", "year": 1949}]';

我们可以使用 MariaDB JSON_LENGTH() 函数，返回这个 JSON 值中的第一个元素的长度：

SELECT JSON_LENGTH(@json, '$[0]') AS result;

运行结果如下：

+--------+
| result |
+--------+
|      3 |
+--------+

这是因为这个 JSON 值中的第一个元素是一个对象，它的长度是它的属性个数。

返回一个不存在的路径的长度

假设我们有一个 JSON 值，比如 {"title": "The Matrix", "rating": 8.7, "genres": ["Action", "Sci-Fi", "Thriller"], "year": 1999}：

SET @json = '{"title": "The Matrix", "rating": 8.7, "genres": ["Action", "Sci-Fi", "Thriller"], "year": 1999}';

我们可以使用 MariaDB JSON_LENGTH() 函数，尝试返回这个 JSON 值中的 director 属性的长度：

SELECT JSON_LENGTH(@json, '$.director') AS result;

运行结果如下：

+--------+
| result |
+--------+
|   NULL |
+--------+

这是因为这个 JSON 值中不存在 director 属性，所以该函数返回 NULL。

MariaDB JSON_LENGTH() 函数的基础用法与实例

语法

实例

返回一个标量值的长度

返回一个数组的长度

返回一个对象的长度

返回一个路径指定的子值的长度

返回一个不存在的路径的长度

相关函数

结论