介绍
MariaDB MaxScale的NoSQL协议模块是一个强大而独特的功能，它允许使用
MongoDB协议与MariaDB数据库进行交互。
以下是该模块的主要特点:
1.协议转换:
- 将MongoDB的查询语言和操作转换为SQL语句。
- 使得应用程序可以使用MongoDB的驱动程序与MariaDB/MySQL通信。
2.无缝集成:
- 允许现有的MongoDB应用程序直接连接到MariaDB/MySQL,无需修改应用程序代码。
- 简化了从MongoDB向MariaDB/MySQL的迁移过程。
MaxScale to MongoDB架构示意图应用场景
需求：希望实现一份数据同时写入 MongoDB 和 MySQL（用于运营分析），建立双写机制。以往在没有 MariaDB MaxScale 的情况下，这通常需要大量的代码重构。而如今，通过 MariaDB MaxScale 的 NoSQL 协议模块，能够实现将 MongoDB 中的数据无缝迁移至 MySQL，无需修改任何现有代码。
生产环境架构图安装与部署
1）下载与安装 MaxScale
代码语言：bash复制shell> wget https://dlm.mariadb.com/3843223/MaxScale/24.02.2/yum/centos/7/x86_64/maxscale-24.02.2-1.rhel.7.x86_64.rpm
shell> yum install maxscale-24.02.2-1.rhel.7.x86_64.rpm -y2）配置 MaxScale 支持 MongoDB协议
代码语言：txt复制环境： 192.168.176.204 - MaxScale
192.168.198.239 - MariaDB1.创建MaxScale配置文件
代码语言：bash复制shell> vim /etc/maxscale.cnf[maxscale]
threads=auto
admin_secure_gui=false
admin_host=0.0.0.0
[server1]
type=server
address=192.168.198.239
port=4309
#protocol=MySQLBackend
protocol=MariaDBBackend
[MariaDB-Monitor]
type=monitor
module=mariadbmon
servers=server1
user=admin
password=123456
monitor_interval=2s
[Read-Write-Service]
type=service
router=readwritesplit
servers=server1
user=admin
password=123456
enable_root_user=1
[Read-Write-Listener]
type=listener
service=Read-Write-Service
protocol=mariadbprotocol
port=4006
[MongoDB-Listener]
type=listener
service=Read-Write-Service
protocol=nosqlprotocol
nosqlprotocol.user=admin
nosqlprotocol.password=123456
#############################################
## 第一次要设置false，然后创建账号
## db.createUser({user:"admin",pwd:"123456",roles:[{role:"dbOwner",db:"test
"}]})
## 然后再修改为true，并重启maxscale
nosqlprotocol.authentication_required=false
nosqlprotocol.authorization_enabled=false
#############################################
port=17017注：
首次启动 MaxScale 服务时，需要将以下两个参数设置为 false：nosqlprotocol.authentication_required=false
nosqlprotocol.authorization_enabled=false
此操作的目的是先通过非认证模式登录 17017 端口，然后再创建应用所需的访问账号。
- 请确保后端MariaDB/MySQL服务启动正常，且已存在admin账号，权限为ALL
2.启动MaxScale
代码语言：bash复制shell> systemctl start maxscale
shell> systemctl status maxscale
● maxscale.service - MariaDB MaxScale Database Proxy
Loaded: loaded (/usr/lib/systemd/system/maxscale.service; enabled; vendo
r preset: disabled) Active: active (running) since Fri 2024-09-06 14:51:06 CST; 8h ago
Process: 130360 ExecStart=/usr/bin/maxscale (code=exited, status=0/SUCCES
S) Main PID: 130361 (maxscale)
CGroup: /system.slice/maxscale.service
└─130361 /usr/bin/maxscale3.创建Mongo连接账号，提供给应用程序访问使用
代码语言：bash复制shell> mongosh --port 17017在 test 数据库中创建账号 admin，密码为 123456，并赋予 dbOwner 权限：
代码语言：javascript复制use test
db.createUser({user:"admin",pwd:"123456",roles:[{role:"dbOwner",db:"test"}]})此命令将为 test 数据库创建一个具有 dbOwner 权限的管理员账号。
4.以认证模式登录 17017 端口
编译maxscale.cnf配置文件，将下面的参数值修改为true
nosqlprotocol.authentication_required=true
nosqlprotocol.authorization_enabled=true
注：需重启MaxScale服务生效。
代码语言：bash复制shell> systemctl restart maxscale5.连接MongoDB协议17017端口
代码语言：bash复制shell> mongosh mongodb://admin:123456@127.0.0.1:17017/test --authenticationDatabase test1.插入数据
代码语言：javascript复制db.t2.insert(
{"age": 45, "name": "中年大叔", "hobby": ["美食", "摩旅", "游泳", "电影", "实现50岁退休"], "address": "北京"}
)此时，你回到后端MariaDB/MySQL数据库里，已经发现t2表已经创建，表结构如下：
代码语言：javascript复制mysql> show create table t2G
*************************** 1. row ***************************
Table: t2
Create Table: CREATE TABLE `t2` (
`id` varchar(35) GENERATED ALWAYS AS (json_compact(json_extract(`doc`,'$.
_id'))) VIRTUAL, `doc` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL CHE
CK (json_valid(`doc`)), UNIQUE KEY `id` (`id`),
CONSTRAINT `id_not_null` CHECK (`id` is not null)
) ENGINE=InnoDB DEFAULT CHARSET=latin12.查询数据
代码语言：sql复制mysql> select * from t2G
*************************** 1. row ***************************
id: {"$oid":"66dab9b9fc7f8c8fff4a7bcf"}
doc: { "_id" : { "$oid" : "66dab9b9fc7f8c8fff4a7bcf" }, "age" : 45.0, "name" : "中年大叔", "hobby" : [ "美食", "摩旅", "游泳", "电影", "实现50岁退休" ]
, "address" : "北京" }1 row in set (0.00 sec)用MySQL的JSON函数查询数据
代码语言：sql复制mysql> SELECT
-> JSON_UNQUOTE(JSON_EXTRACT(doc, '$.name')) AS name,
-> JSON_EXTRACT(doc, '$.age') AS age,
-> JSON_EXTRACT(doc, '$.hobby') AS hobby
-> FROM t2;
-------------- ------ ---------------------------------------------------------------
| name | age | hobby |
-------------- ------ ---------------------------------------------------------------
| 中年大叔 | 45.0 | ["美食", "摩旅", "游泳", "电影", "实现50岁退休"] |
-------------- ------ ---------------------------------------------------------------
1 row in set (0.00 sec)至此大功告成。
总结
MariaDB MaxScale NoSQL协议模块的核心优势在于其卓越的适应性和效率。它巧妙地架起了NoSQL和SQL世界之间的桥梁，使得组织能够在不改变现有MongoDB应用代码的情况下，实现向MySQL的无缝过渡和双写操作。这一创新极大地简化了数据库基础架构，显著降低了维护成本和复杂性。
更为重要的是，这个模块释放了开发团队的生产力。通过消除处理复杂数据层转换的需求，开发人员可以将更多精力集中在核心业务逻辑的开发上。这不仅加快了项目交付速度，还提高了代码质量和创新能力。
