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

MariaDB 的 JSON_SCHEMA_VALID() 函数用来检查 JSON 数据的结构和内容是否符合特定的标准。

发布于

在现代的数据库管理和数据交换中，JSON 数据的使用变得越来越普遍。为了确保 JSON 数据的结构和内容符合特定的标准，MariaDB 提供了 JSON_SCHEMA_VALID() 函数。本文将介绍这个函数的基本用法，并通过实例演示如何验证 JSON 数据是否符合预定义的 JSON Schema。

语法

JSON_SCHEMA_VALID() 函数的基本语法如下：

JSON_SCHEMA_VALID(schema, document)
  • schema 是一个字符串，表示 JSON Schema。
  • document 是一个字符串，表示要验证的 JSON 文档。

函数返回 1（如果 JSON 文档符合 Schema）或 0（如果不符合）。

实例

验证简单的 JSON 对象

假设我们有一个简单的 JSON Schema 和一个 JSON 对象，我们需要验证这个对象是否符合 Schema。

SET @schema = '{"type": "object", "properties": {"name": {"type": "string"}}}';
SET @document = '{"name": "Alice"}';
SELECT JSON_SCHEMA_VALID(@schema, @document);

输出结果为：

1

验证复杂的 JSON 对象

对于更复杂的 JSON 对象，我们也可以进行验证。

SET @schema = '{"type": "object", "properties": {"name": {"type": "string"}, "age": {"type": "number", "minimum": 18}}}';
SET @document = '{"name": "Bob", "age": 20}';
SELECT JSON_SCHEMA_VALID(@schema, @document);

输出结果为：

1

验证不符合 Schema 的 JSON 对象

如果 JSON 对象不符合 Schema，函数将返回 0。

SET @document = '{"name": "Charlie", "age": 17}';
SELECT JSON_SCHEMA_VALID(@schema, @document);

输出结果为：

0

从表中查询并验证 JSON 数据

首先，我们创建一个表并插入数据。

CREATE TABLE user_profiles (id INT, profile JSON);
INSERT INTO user_profiles VALUES (1, '{"name": "Alice", "age": 25}');

然后，我们可以验证表中的 JSON 数据是否符合 Schema。

SELECT id, JSON_SCHEMA_VALID(@schema, profile) AS is_valid FROM user_profiles;

输出结果为：

+------+----------+
| id   | is_valid |
+------+----------+
|    1 |        1 |
+------+----------+

验证数组类型的 JSON 数据

我们也可以验证数组类型的 JSON 数据。

SET @schema = '{"type": "array", "items": {"type": "string"}}';
SET @document = '["apple", "banana", "cherry"]';
SELECT JSON_SCHEMA_VALID(@schema, @document);

输出结果为：

1

相关函数

结论

JSON_SCHEMA_VALID() 函数是一个强大的工具，用于验证 JSON 数据是否符合预定义的 Schema。通过上述实例，我们可以看到它在实际应用中的重要性和实用性。无论是简单的对象验证，还是复杂的结构验证，JSON_SCHEMA_VALID() 都能提供准确的验证结果，帮助我们确保数据的质量和一致性。在处理 JSON 数据时，它是一个不可或缺的函数。