开源软件名称：

mysql_redis

开源软件地址：

https://gitee.com/josinli/mysql_redis

开源软件介绍：

MySQL-Redis

1、什么是 MySQL-Redis ?

MySQL-Redis是一款可以在 MySQL 中操作 Redis 的一个UDF(MySQL用户自定义函数插件)，不能独立运行，需要依赖于 MySQL

2、支持系统

mysql_redis可以在支持标准C99编译器的操作系统上编译，但是hiredis-vip与Redis的支持环境限制了mysql_redis的适用范围

3、MySQL-Redis 可以操作 Redis 集群吗？

可以的， MySQL-Redis可以操作单例或者集群Redis，操作的唯一的区别就是MySQL函数不一样而已

4、性能怎么样？

性能这个取决于网络，实例操作Redis速度很快。因为使用C语言开发

5、使用场景 ?

可以使用在需要 Redis和MySQL数据一致性的地方。

6、MySQL-Redis 函数

RedisConnect("127.0.0.1", 6379)
单例Redis连接，第二个参数可以省略，默认端口 6379
对应SQL代码：
```
SELECT RedisConnect("127.0.0.1", 6379);
```
RedisClusterConnect
Redis集群连接
对应SQL代码：
```
SELECT RedisClusterConnect("127.0.0.1:6379,127.0.0.2:6379");
```
多个机器之间采用,隔开
RedisConnectFree
对应 RedisConnect()的连接释放
操作完成后，如果需要手动释放，需要调用本方法，目前暂未实现连接池，后续版本实现
对应SQL代码：
```
SELECT RedisConnectFree();
```
RedisClusterConnectFree
对应 RedisClusterConnect()的连接释放
操作完成后，如果需要手动释放，需要调用本方法，目前暂未实现连接池，后续版本实现
使用方法：
```
SELECT RedisClusterConnectFree();
```

RedisSet

设置键值对的快捷方法

对应SQL代码：

SELECT RedisSet("a", 1); -- 等同于 Redis中的语句： SET a 1

RedisClusterSet
设置键值对的集群方法方法，参数等同于 RedisSet函数，见上面
RedisExecCommand
执行Redis语句，包含三个或者两个参数，如下SQL：
三个参数的SQL方法：
```
SELECT RedisExecCommand("SET", "a", 1);
```
两个参数的SQL方法：
```
SELECT RedisExecCommand("SELECT", 1);
```
RedisClusterExecCommand
集群操作方法，参数等同于上面单例：RedisExecCommand
RedisRawCommand
执行Redis语句，由用户提供一个完整的Redis语句
SQL代码如下：
```
SELECT RedisRawCommand("SET Hello World");
```
RedisClusterRawCommand
集群模式的RedisClusterRawCommand方法，参数等同于单例的 RedisRawCommand
RedisListIndex
获取 Redis List数据结构的某一项，第一项表示 Redis数据结构，第二项表示索引值，如：
```
SELECT RedisListIndex(RedisRawCommand("LRANGE score_lists 0 10"), 1);
```

RedisListJoin

将 Redis List数据结构的所有项通过第二个参数合并为一个字符串，如：

SELECT RedisListJoin(RedisRawCommand("LRANGE score_lists 0 10"), "-");// 假设 Redis List score_lists结构如下：// 0 1 2// 那么合并结果：// 0-1-2

7、返回值

1：

RedisSET 、 RedisClusterSet 、RedisConnect 、RedisConnectFree 、 RedisClusterConnect 、 RedisClusterConnectFree 成功的情况下返回 1，否则SQL语句错误

2：

RedisExecCommand 、 RedisClusterExecCommand 、RedisRawCommand 、RedisClusterRawCommand、RedisListIndex 、RedisListJoin 返回字符串，具体如下：

OK
在执行 Redis SET命令的时候返回 "OK"表示成功，否则就表示错误信息
其他字符串
执行GET 命令的时候返回具体值

8、怎么安装 ?

前提条件：

电脑安装 Redis 、MySQL(开发机器MySQL 5.7.22)、hiredis-vip

hiredis-vip仓库地址

准备好前提条件后，开始MySQL-Redis插件的编译安装过程

git clone 代码库

git clone  https://gitee.com/josinli/mysql_redis.git

修改 CMakeLists.txt 文件，因为代码库采用 CMake编译系统：

cmake_minimum_required(VERSION 3.13)project(udf_redis C)set(CMAKE_C_STANDARD 99)include_directories(    .    /usr/local/mysql/include/      # 把这行更改为您系统安装mysql的头文件目录    /usr/local/include/hiredis-vip # 把这行更改为您系统安装hiredis-vip的头文件目录)link_directories(    /usr/local/lib                 # 把这行更改为您系统的 hiredis-vip的lib安装目录)add_library(udf_redis SHARED mysql_redis.c mysql_redis.h)target_link_libraries(udf_redis hiredis_vip)

更改完成后，执行下面的操作
```
cd buildcmake ..make 
```
可以看到build目录生成了库文件 libudf_redis.so 或者 libudf_redis.dylib
进入您的MySQL，执行如下SQL语句找到您的MySQL插件目录：
```
SHOW VARIABLES LIKE 'plugin_dir%';
```
拷贝上面第四步中的 libudf_redis.so 或者 libudf_redis.dylib 到第五步中的目录中
针对您的系统，Linux系统拷贝 create_function_linux.sql 或者 OSX系统拷贝 create_function_osx.sql 并执行
重启您的MySQL，开始在SQL中愉快的体验Redis吧!