Skip to main content

从二进制文件安装

下载并解压 EloqSQL 压缩包​

EloqSQL 兼容 RHEL 9、Ubuntu 20.04、22.04 和 24.04。请从这里下载适合您操作系统的压缩包。

成功下载对应的二进制文件后，在目录中解压它。

cd ${HOME}
tar -zxvf eloqsql-0.4.14-ubuntu24-amd64.tar.gz

准备 EloqSQL 配置文件​

EloqSQL 使用配置文件来自定义设置。以下是如何配置 EloqSQL 在本地机器上运行的示例。

注意：将 ip 字段设置为 127.0.0.1 将阻止外部访问 EloqSQL。如果您想从其他机器访问 EloqSQL，建议将 ip 设置为服务器的实际 IP 地址。

另外请注意，如果在配置文件中没有指定用户值，EloqSQL 会自动为其参数设置合理的默认值。因此，如果您对某个参数有疑问，可以不在配置文件中指定它。

cd ${HOME}
touch my-config.cnf

使用以下示例设置编辑 my-config.cnf：

[mariadb]
plugin_maturity=experimental
max_connections=500
skip-log-bin
thread_stack=16M
port=3316
socket=/tmp/mysqld3316.sock
plugin_load_add=ha_eloq
eloq
eloq_kv_storage=cass
eloq_cass_hosts=127.0.0.1
eloq_cass_user=cassandra
eloq_cass_password=cassandra
eloq_local_ip=127.0.0.1:8000
eloq_ip_list=127.0.0.1:8000

引导 EloqSQL 服务器​

初始化数据库：

export INSTALL_DIR=${HOME}/install
export DATA_DIR=${HOME}/eloqdata
${INSTALL_DIR}/scripts/mysql_install_db --defaults-file=${HOME}/my-config.cnf \
                                       --basedir=${INSTALL_DIR} \
                                       --datadir=${DATA_DIR} \
                                       --plugin-dir=${INSTALL_DIR}/lib/plugin

启动 EloqSQL 服务器​

EloqSQL 的 mysqld 可执行二进制文件安装在 ${INSTALL_DIR}/bin 目录中。使用以下命令在本地机器上启动服务器。

${INSTALL_DIR}/bin/mysqld --defaults-file=${HOME}/my-config.cnf --datadir=${DATA_DIR}

连接到 EloqSQL 服务器​

EloqSQL 兼容 Redis 协议。我们已经包含了一个 mysql 客户端供您使用，但任何 MariaDB/MySQL 客户端都可以连接到 EloqSQL。您可以通过执行 sudo apt-get install mysql-client（在 Ubuntu 上）等命令获取官方的 mysql-client。请使用配置文件 my-config.cnf 中相同的 IP 和端口连接到 EloqSQL。

sudo ${INSTALL_DIR}/bin/mysql -u root -S /tmp/mysqld3316.sock

设置集群​

设置 EloqSQL 集群非常简单。只需在不同的机器上启动多个 EloqSQL 实例，每个实例都提供一个在集群部分中列出节点的配置文件。

例如，假设我们要在 192.168.1.20、192.168.1.21 和 192.168.1.22 上设置一个 3 台服务器的集群：

[mariadb]
# eloq_ip_list 应包含集群中的所有 eloqsql 节点。
# 确保它们与每个节点配置文件的 [mariadb] 部分中指定的 ip:port 匹配。
eloq_ip_list=192.168.1.20:6379,192.168.1.21:6379,192.168.1.22:6379