20 Star 105 Fork 15

Josin / mysql_redis

加入 Gitee
与超过 800 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README.md

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:

RedisSETRedisClusterSetRedisConnectRedisConnectFreeRedisClusterConnectRedisClusterConnectFree 成功的情况下返回 1,否则SQL语句错误

2:

RedisExecCommandRedisClusterExecCommandRedisRawCommandRedisClusterRawCommandRedisListIndexRedisListJoin 返回字符串,具体如下:

  • OK

    在执行 Redis SET命令的时候返回 "OK"表示成功,否则就表示错误信息

  • 其他字符串

    执行GET 命令的时候 返回具体值

8、怎么安装 ?

前提条件:

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

hiredis-vip仓库地址

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

  1. git clone 代码库

    git clone  https://gitee.com/josinli/mysql_redis.git
  2. 修改 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)
  3. 更改完成后,执行下面的操作

    cd build
    cmake ..
    make 
  4. 可以看到build目录生成了库文件 libudf_redis.so 或者 libudf_redis.dylib

  5. 进入您的MySQL,执行如下SQL语句找到您的MySQL插件目录:

    SHOW VARIABLES LIKE 'plugin_dir%';
  6. 拷贝上面第四步中的 libudf_redis.so 或者 libudf_redis.dylib 到第五步中的目录中

  7. 针对您的系统,Linux系统拷贝 create_function_linux.sql 或者 OSX系统拷贝 create_function_osx.sql 并执行

  8. 重启您的MySQL,开始在SQL中愉快的体验Redis吧!

简介

在SQL中操作Redis或者Redis集群,达到Redis与MySQL的数据一致性 展开 收起
C 等 2 种语言
BSD-3-Clause-Clear
取消

发行版

暂无发行版

mysql_redis

贡献者

全部

近期动态

加载更多
不能加载更多了
C
1
https://gitee.com/josinli/mysql_redis.git
git@gitee.com:josinli/mysql_redis.git
josinli
mysql_redis
mysql_redis
release

搜索帮助