File _service:obs_scm:README.md of Package greatsql

# 关于 GreatSQL

GreatSQL 数据库是一款 **开源免费** 数据库，可在普通硬件上满足金融级应用场景，具有 **高可用**、**高性能**、**高兼容**、**高安全** 等特性，可作为 MySQL 或 Percona Server for MySQL 的理想可选替换。

最新版本：GreatSQL 8.0.32-26。

## 下载GreatSQL

- [下载 GreatSQL 最新版本](https://gitee.com/GreatSQL/GreatSQL/releases/GreatSQL-8.0.32-26)
- [下载 GreatSQL 历史版本](https://gitee.com/GreatSQL/GreatSQL/releases/)

# GreatSQL核心特性

### [高可用](https://greatsql.cn/docs/5-enhance/5-2-ha.html)

针对 MGR 及主从复制进行了大量改进和提升工作，支持 地理标签、仲裁节点、读写动态 VIP、快速单主模式、智能选主 等特性，并针对 流控算法、事务认证队列清理算法、节点加入&退出机制、recovery机制 等多个 MGR 底层工作机制算法进行深度优化，进一步提升优化了 MGR 的高可用保障及性能稳定性。

- 支持 [地理标签](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-zoneid.html) 特性，提升多机房架构数据可靠性。
- 支持 [仲裁节点](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-arbitrator.html) 特性，用更低的服务器成本实现更高可用。
- 支持 [读写动态 VIP](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-vip.html) 特性，高可用切换更便捷，更快实现读负载均衡。支持 [当主节点切换时，主动关闭当前活跃连接](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-kill-conn-after-switch.html)，缩短应用端不可用时长。。
- 支持 [快速单主模式](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-fast-mode.html)，在单主模式下更快，性能更高。
- 支持 [智能选主](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-election-mode.html) 特性，高可用切换选主机制更合理。
- 优化 [流控算法](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-new-fc.html)，使得事务更平稳，避免剧烈抖动。
- 支持 [记录 MGR 网络通信开销超过阈值的事件](https://greatsql.cn/docs/5-enhance/5-2-ha-mgr-request-time.html)，用于进一步分析和优化。
- 支持自动选择从最新事务数据的成员节点复制数据，可有效提升 Clone 速度，提高 MGR 的服务可靠性。
- 在主从复制中，从节点向主节点发起 Binlog 读取请求时支持限速控制。
- 优化了 [asynchronous connection failover](https://dev.mysql.com/doc/refman/8.0/en/replication-asynchronous-connection-failover.html) 中的故障检测效率，降低主从复制链路断开的时间，提高整体可用性。
- 支持在跨机房容灾场景中的 [主主双向复制防止回路](https://greatsql.cn/docs/5-enhance/5-2-ha-repl-server-mode.html) 机制。
- 优化了 MGR 节点加入、退出时可能导致性能剧烈抖动的问题。
- 解决了个别节点上磁盘空间爆满时导致MGR集群整体被阻塞的问题。
- 优化了 MGR 事务认证队列清理算法，高负载下不复存在每 60 秒性能抖动问题。
- 解决了 MGR 中长事务造成无法选主的问题。
- 修复了 MGR recovery 过程中长时间等待的问题。

更多信息详见文档：[高可用](https://greatsql.cn/docs/5-enhance/5-2-ha.html)。

### [高性能](https://greatsql.cn/docs/5-enhance/5-1-highperf.html)
相对 MySQL 及 Percona Server For MySQL 的性能表现更稳定优异，支持 Rapid 引擎、事务无锁化、并行 LOAD DATA、异步删除大表、线程池、非阻塞式 DDL、NUMA 亲和调度优化 等特性，在 TPC-C 测试中相对 MySQL 性能提升超过 30%，在 TPC-H 测试中的性能表现是 MySQL 的十几倍甚至上百倍。

- 支持 [大规模并行、基于内存查询、高压缩比的高性能 Rapid 引擎](https://greatsql.cn/docs/5-enhance/5-1-highperf-rapid-engine.html)，可将数据分析性能提升几个数量级。
- 优化 InnoDB 事务系统，实现了大锁拆分及无锁化等多种优化方案，OLTP 场景整体性能提升约 20%。
- 支持 [并行 LOAD DATA](https://greatsql.cn/docs/5-enhance/5-1-highperf-parallel-load.html)，适用于频繁导入大批量数据的应用场景，性能可提升约 20 多倍；对于无显式定义主键的场景亦有优化提升。
- 支持 [异步删除大表](https://greatsql.cn/docs/5-enhance/5-1-highperf-async-purge-big-table.html)，提高 InnoDB 引擎运行时性能的稳定性。
- 支持 [线程池](https://greatsql.cn/docs/5-enhance/5-1-highperf-thread-pool.html)，降低了线程创建和销毁的代价，保证高并发下，性能稳定不会明显衰退。
- 支持 [非阻塞式 DDL](https://greatsql.cn/docs/5-enhance/5-1-highperf-nonblocking-ddl.html)，可以避免数据库因为必须尽快完成 DDL 操作而导致业务请求大量被阻塞的问题。
- 支持 [NUMA 亲和性优化](https://greatsql.cn/docs/5-enhance/5-1-highperf-numa-affinity.html)，通过 NUMA 亲和性调度优化，将前端用户线程和后台线程绑定到固定 NUMA 节点上以提升线程处理性能。

更多信息详见文档：[高性能](https://greatsql.cn/docs/5-enhance/5-1-highperf.html)。

### [高兼容](https://greatsql.cn/docs/5-enhance/5-3-easyuse.html)

GreatSQL 实现 100% 完全兼容 MySQL 及 Percona Server For MySQL 语法，支持大多数常见 Oracle 语法，包括 [数据类型兼容](https://greatsql.cn/docs/5-enhance/5-3-easyuse.html#数据类型兼容)、[函数兼容](https://greatsql.cn/docs/5-enhance/5-3-easyuse.html#函数兼容)、[SQL 语法兼容](https://greatsql.cn/docs/5-enhance/5-3-easyuse.html#sql语法兼容)、[存储程序兼容](https://greatsql.cn/docs/5-enhance/5-3-easyuse.html#存储程序兼容) 等众多兼容扩展用法。

更多信息详见文档：[高兼容](https://greatsql.cn/docs/5-enhance/5-3-easyuse.html)。

### [高安全](https://greatsql.cn/docs/5-enhance/5-4-security.html)

GreatSQL 支持逻辑备份加密、CLONE 备份加密、审计、表空间国密加密、敏感数据脱敏、存储登录历史等多个安全提升特性，进一步保障业务数据安全，更适用于金融级应用场景。

- 支持 [mysqldump 逻辑备份加密](https://greatsql.cn/docs/5-enhance/5-4-security-mysqldump-encrypt.html)，提供了利用 mysqldump 逻辑备份的安全加密需求。
- 支持 [Clone 备份加密](https://greatsql.cn/docs/5-enhance/5-4-security-clone-encrypt.html)，提供了利用 Clone 物理备份的安全加密需求。
- 支持 [审计功能](https://greatsql.cn/docs/5-enhance/5-4-security-audit.html)，及时记录和发现未授权或不安全行为。
- 支持 [InnoDB 表空间国密加密算法](https://greatsql.cn/docs/5-enhance/5-4-security-innodb-tablespace-encrypt.html)，确保重要数据的加密安全。
- 支持 [基于函数和策略的两种数据脱敏](https://greatsql.cn/docs/5-enhance/5-4-security-data-masking.html) 工作方式，保障敏感用户数据查询结果保密性。
- 支持 [存储登录历史](https://greatsql.cn/docs/5-enhance/5-4-security-last-login.html)，便于管理员查询，进一步提升数据库安全性。

通过上述多个安全提升特性，进一步保障业务数据安全。更多信息详见文档：[高安全](https://greatsql.cn/docs/5-enhance/5-4-security.html)。

### [其他](https://greatsql.cn/docs/5-enhance/5-5-others.html)
- 支持 [Clone 在线全量热备、增备及恢复](https://greatsql.cn/docs/5-enhance/5-5-clone-compressed-and-incrment-backup.html)，结合 Binlog 可实现恢复到指定时间点。此外，Clone 备份还支持压缩功能。

## 安装GreatSQL

### 安装 jemalloc（推荐）

运行 GreatSQL 时如果有 jemalloc 支持，则数据库进程的内存分配会更稳定、高效，因此建议安装 jemalloc（非必须）。采用类似下面的方法安装 jemalloc 软件包：

```
# 先安装 epel 源
$ yum install -y epel-release

# 再安装jemalloc
$ yum -y install jemalloc jemalloc-devel
```

也可以把自行安装的动态库so文件路径加到系统配置文件中，例如：

```
$ cat /etc/ld.so.conf
/usr/local/lib64/
```

而后执行下面的操作加载libjemalloc库，并确认是否已存在

```
$ ldconfig

$ ldconfig -p | grep libjemalloc
        libjemalloc.so.1 (libc6,x86-64) => /usr/local/lib64/libjemalloc.so.1
        libjemalloc.so (libc6,x86-64) => /usr/local/lib64/libjemalloc.so
```

如果无法通过 yum 直接安装 jemalloc，可以自行下载 RPM 包，地址：[https://centos.pkgs.org/8/epel-x86_64/jemalloc-5.2.1-2.el8.x86_64.rpm.html](https://centos.pkgs.org/8/epel-x86_64/jemalloc-5.2.1-2.el8.x86_64.rpm.html)

### 安装 GreatSQL

执行下面的命令安装GreatSQL

```
#首先，查找GreatSQL
$ yum search GreatSQL
...
greatsql.src : GreatSQL: a high performance, highly reliable, easy to use, and high security database
greatsql-client.x86_64 : GreatSQL - Client
greatsql-debuginfo.x86_64 : Debug information for package greatsql
greatsql-debugsource.x86_64 : Debug sources for package greatsql
greatsql-devel.x86_64 : GreatSQL - Development header files and libraries
greatsql-icu-data-files.x86_64 : GreatSQL packaging of ICU data files
greatsql-mysql-config.x86_64 : GreatSQL config
greatsql-mysql-router.x86_64 : GreatSQL MySQL Router
greatsql-server.x86_64 : GreatSQL: a high performance, highly reliable, easy to use, and high security database that can be used to replace MySQL or Percona
                        : Server.
greatsql-shared.x86_64 : GreatSQL - Shared libraries
greatsql-test.x86_64 : Test suite for the GreatSQL

#然后安装
$ yum install -y --allowerasing greatsql-client greatsql-devel greatsql-icu-data-files greatsql-server greatsql-shared
```

安装完成后，GreatSQL会自行完成初始化，可以再检查是否已加入系统服务或已启动：
```
$ systemctl status mysqld
● mysqld.service - MySQL Server
   Loaded: loaded (/usr/lib/systemd/system/mysqld.service; enabled; vendor preset: disabled)
...
     Docs: man:mysqld(8)
           http://dev.mysql.com/doc/refman/en/using-systemd.html
  Process: 1137698 ExecStartPre=/usr/bin/mysqld_pre_systemd (code=exited, status=0/SUCCESS)
 Main PID: 1137732 (mysqld)
   Status: "Server is operational"
    Tasks: 39 (limit: 149064)
   Memory: 336.7M
   CGroup: /system.slice/mysqld.service
           └─1137732 /usr/sbin/mysqld
...
```

## my.cnf参考

RPM方式安装后的GreatSQL默认配置不是太合理，建议参考下面这份my.cnf文档：

- [my.cnf for GreatSQL 8.0.32-26](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/my.cnf-example-greatsql-8.0.32-26)

调整文档中关于`datadir`目录配置等相关选项，默认 `datadir=/var/lib/mysql` 通常都会改掉，例如替换成 `datadir=/data/GreatSQL`，修改完后保存退出，
替换原来的 `/etc/my.cnf`，然后重启GreatSQL，会重新进行初始化。
```
# 新建 /data/GreatSQL 空目录，并修改目录所有者
$ mkdir -p /data/GreatSQL
$ chown -R mysql:mysql /data/GreatSQL

# 重启mysqld服务，即自行完成重新初始化
$ systemctl restart mysqld
```

## 登入GreatSQL
首次登入GreatSQL前，需要先找到初始化时随机生成的root密码：
```
$ grep root /data/GreatSQL/error.log
[Note] [MY-010454] [Server] A temporary password is generated for root@localhost: dt_)MtExl594
```

其中的 **dt_)MtExl594** 就是初始化时随机生成的密码，在登入GreatSQL时输入该密码：
```
$ mysql -uroot -p'dt_)MtExl594'
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 8.0.32-26

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> \s
ERROR 1820 (HY000): You must reset your password using ALTER USER statement before executing this statement.
mysql>
```

首次登入立刻提醒该密码已过期，需要修改，执行类似下面的命令修改即可：
```
mysql> ALTER USER USER() IDENTIFIED BY 'GreatSQL-8032~%';
Query OK, 0 rows affected (0.02 sec)
```
之后就可以用这个新密码再次登入GreatSQL了。

## 创建新用户、测试库&表，及写入数据
修改完root密码后，应尽快创建普通用户，用于数据库的日常使用，减少超级用户root的使用频率，避免误操作意外删除重要数据。
```
#创建一个新用户GreatSQL，只允许从192.168.0.0/16网络连入，密码是 GreatSQL-2024
mysql> CREATE USER GreatSQL@'192.168.0.0/16' IDENTIFIED BY 'GreatSQL-2024';
Query OK, 0 rows affected (0.06 sec)

#创建一个新的用户库，并对GreatSQL用户授予读写权限
mysql> CREATE DATABASE GreatSQL;
Query OK, 1 row affected (0.03 sec)

mysql> GRANT ALL ON GreatSQL.* TO GreatSQL@'192.168.0.0/16';
Query OK, 0 rows affected (0.03 sec)
```

切换到普通用户GreatSQL登入，创建测试表，写入数据：
```
$ mysql -h192.168.1.10 -uGreatSQL -p'GreatSQL-2024'
...
# 切换到GreatSQL数据库下
mysql> use GreatSQL;
Database changed

# 创建新表
mysql> CREATE TABLE t1(id INT PRIMARY KEY);
Query OK, 0 rows affected (0.07 sec)

# 写入测试数据
mysql> INSERT INTO t1 SELECT RAND()*1024;
Query OK, 1 row affected (0.05 sec)
Records: 1  Duplicates: 0  Warnings: 0

# 查询数据
mysql> SELECT * FROM t1;
+-----+
| id  |
+-----+
| 203 |
+-----+
1 row in set (0.00 sec)
```
成功。

## 版本历史

戳此查看 [GreatSQL 版本历史](https://greatsql.cn/docs/1-docs-intro/1-2-release-history.html)。

## QA测试
GreatSQL 8.0.32-25 已经在 openEuler 24.03 LTS 环境下通过 QA 测试，表明 GreatSQL 与 openEuler 开源操作系统完全兼容，功能齐全，测试完备。

相关测试报告详见：[openEuler-24.03-LTS-GreatSQL测试报告](https://gitee.com/openeuler/QA/blob/master/Test_Result/openEuler_24.03_LTS/openEuler-24.03-LTS-GreatSQL%E6%B5%8B%E8%AF%95%E6%8A%A5%E5%91%8A.md)。

GreatSQL 8.0.25-16 已经在 openEuler 20.03 (LTS-SP2) 环境下通过 MTR 回归测试，表明 GreatSQL 与 openEuler 开源操作系统完全兼容，功能齐全，测试完备。

相关MTR测试报告详见：[GreatSQL 8.0.25-16通过MTR回归测试](https://gitee.com/src-openeuler/greatsql/blob/master/greatsql-802516-mtr-passed.md)。

## 更多使用文档
---
- [GreatSQL MGR FAQ](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/GreatSQL-FAQ.md)
- [在Linux下源码编译安装GreatSQL](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/build-greatsql-with-source.md)
- [在openEuler环境下快速编译GreatSQL RPM包](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/build-greatsql-rpm-under-openeuler.md)
- [利用Ansible安装GreatSQL并构建MGR集群](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/install-greatsql-with-ansible.md)
- [在Docker中部署GreatSQL并构建MGR集群](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/install-greatsql-with-docker.md)
- [利用GreatSQL部署MGR集群](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/using-greatsql-to-build-mgr-and-node-manage.md)
- [MySQL InnoDB Cluster+GreatSQL部署MGR集群](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/mysql-innodb-cluster-with-greatsql.md)
- [利用systemd管理MySQL单机多实例](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/docs/build-multi-instance-with-systemd.md)

## 专栏文章
- [深入浅出MGR专栏文章](https://gitee.com/GreatSQL/GreatSQL-Doc/blob/master/deep-dive-mgr)，深入浅出MGR相关知识点、运维管理实操，配合「实战MGR」视频内容食用更佳。

## 相关资源
- [GreatSQL用户手册](https://gitee.com/GreatSQL/GreatSQL-Manual)，最新版本GreatSQL用户手册
- [GreatSQL-Docker](https://gitee.com/GreatSQL/GreatSQL-Docker)，在Docker中运行GreatSQL
- [GreatSQL-Ansible](https://gitee.com/GreatSQL/GreatSQL-Ansible)，利用Ansible一键安装GreatSQL并完成MGR集群部署

## GreatSQL vs MySQL

GreatSQL 8.0.32-26 基于 Percona Server for MySQL 8.0.32 版本，它在 MySQL 8.0.32 基础上做了大量的改进和提升以及众多新特性，详情请见：[**Percona Server for MySQL feature comparison**](https://docs.percona.com/percona-server/8.0/feature-comparison.html)，这其中包括线程池、审计、数据脱敏等 MySQL 企业版才有的特性，以及 performance_schema 提升、information_schema 提升、性能和可扩展性提升、用户统计增强、PROCESSLIST 增强、Slow Log 增强等大量改进和提升，这里不一一重复列出。

## 许可/Licensing

GreatSQL 致力于保持开源的开放性。GreatSQL 采用 GPLv2 协议。

## 温馨提示

[如果您在使用 GreatSQL，请告诉我们，将有机会获得精美礼品和免费技术支持](https://wj.qq.com/s2/11543483/9e09/)。

## 问题反馈
---
- [问题反馈 gitee](https://gitee.com/GreatSQL/GreatSQL-Doc/issues)

## 联系我们
---

扫码关注微信公众号

![输入图片说明](https://images.gitee.com/uploads/images/2021/0802/141935_2ea2c196_8779455.jpeg "greatsql社区-wx-qrcode-0.5m.jpg")