alibaba /AliSQL
AliSQL is a MySQL branch originated from Alibaba Group. Fetch document from Release Notes at bottom.
★ 5,993⑂ 905👁 460⑃ 19● 163▤ 12
+0
日增长
5,993
stars
905
forks
460
watchers
19
prs
163
issues
12
releases
README
AliSQL
阿里巴巴开源 MySQL 分支,集成 DuckDB 分析引擎与原生向量索引
基于 MySQL 8.0.44,由阿里云数据库团队维护
特性 •
快速开始 •
文档 •
路线图 •
贡献
简体中文 | English
AliSQL 简介
AliSQL 是阿里云数据库团队维护的开源 MySQL 分支。本版本基于 MySQL 8.0.44,增加 DuckDB 分析型存储引擎、HNSW 向量索引、Native Flashback、Binlog 实时复制(BRR)和 Binlog 优化,并保留 MySQL 客户端协议。
2026-10-16 更新新增 BRR,并将内嵌 DuckDB 源码升级到 v1.5.2-dev736,增加可选的自增列与后台 Checkpoint 支持。
分析性能参考
随附的 TPC-H SF100 测试结果 中,DuckDB 的多项查询在该测试环境下相比 InnoDB 加速超过 200 倍
原生向量索引
VECTOR(N) 类型和 HNSW 索引支持最高 16,383 维向量
兼容 MySQL 客户端
应用通过 MySQL 协议连接,可继续使用现有 MySQL 客户端和驱动
核心特性
| 特性 | 描述 | 状态 |
|------|------|------|
| DuckDB 存储引擎 | 面向分析表的列式执行与存储,支持自动压缩 | 已发布 |
| 向量索引 (VIDX) | 原生向量存储与 ANN 搜索,基于 HNSW 算法,支持余弦和欧氏距离 | 已发布 |
| Native Flashback | 使用 AS OF TIMESTAMP 和保留的 Undo 快照查询 InnoDB 历史数据 | 已发布 |
| 大事务优化 | Binlog Cache Free Flush 减少 InnoDB 大事务提交阶段的 Binlog I/O 放大 | 已发布 |
| Binlog 持久化优化 | Persist Binlog Into Redo V2 在保留崩溃恢复能力的同时降低同步 Binlog I/O | 已发布 |
| Binlog 实时复制(BRR) | 在提交前传输符合条件的大事务,并可在从库提前执行受支持的 DDL 和事务 | 已发布,默认关闭 |
| DDL 优化 | Instant DDL、并行 B+树构建、非阻塞锁机制 | 规划中 |
| RTO 优化 | 加速崩溃恢复,缩短实例启动时间 | 规划中 |
Free Flush 面向 DuckDB Mode 未开启时符合条件的 InnoDB 大事务;开启 DuckDB Mode 后,提交使用专用的 DuckDB 路径。BRR 复用 Free Flush Cache 文件,不代表提交时一定走 Free Flush。
快速开始
方式一:从源码构建
bash
克隆仓库
git clone https://github.com/alibaba/AliSQL.git
cd AliSQL
构建(release 模式)
sh build.sh -t release -d ~/alisql
安装
make install
方式二:搭建 DuckDB 分析节点
详细指南: 如何搭建 DuckDB 节点
初始化并启动服务
bash
初始化数据目录
~/alisql/bin/mysqld --initialize-insecure --datadir=~/alisql/data
为下方示例启用 DuckDB 并启动服务
~/alisql/bin/mysqld --datadir=~/alisql/data --duckdb_mode=ON
使用示例
使用 DuckDB 进行数据分析
sql
-- 创建使用 DuckDB 引擎的分析表
CREATE TABLE sales_analytics (
sale_date DATE,
product_id INT,
revenue DECIMAL(10,2),
quantity INT
) ENGINE=DuckDB;
-- 使用 DuckDB 执行分析聚合
SELECT
DATE_FORMAT(sale_date, '%Y-%m') as month,
SUM(revenue) as total_revenue,
COUNT() as transactions
FROM sales_analytics
GROUP BY month
ORDER BY total_revenue DESC;
使用向量搜索构建 AI 应用
sql
-- 向量功能默认关闭,向量索引要求使用 RC 隔离级别
SET GLOBAL vidx_disabled = OFF;
SET SESSION transaction_isolation = 'READ-COMMITTED';
-- 创建包含向量列的表
CREATE TABLE embeddings (
id INT PRIMARY KEY,
content TEXT,
embedding VECTOR(3)
) ENGINE=InnoDB;
INSERT INTO embeddings VALUES
(1, '第一篇文档', VEC_FROMTEXT('[0.1,0.2,0.3]')),
(2, '第二篇文档', VEC_FROMTEXT('[0.2,0.1,0.4]'));
-- 创建 HNSW 索引以加速 ANN 搜索
CREATE VECTOR INDEX idx_embedding ON embeddings(embedding) DISTANCE=COSINE;
-- 使用余弦距离查找相似项
SELECT id, content,
VEC_DISTANCE_COSINE(
embedding, VEC_FROMTEXT('[0.1,0.2,0.3]')
) AS distance
FROM embeddings
ORDER BY distance
LIMIT 10;
构建选项
| 选项 | 描述 | 默认值 |
|------|------|--------|
| -t release\|debug | 构建类型 | debug |
| -d | 安装目录 | /usr/local/alisql 可写时使用该目录,否则为 $HOME/alisql |
| -g asan\|tsan | 启用内存/线程检测器 | 禁用 |
| -c | 启用代码覆盖率 (gcov) | 禁用 |
前置依赖: CMake 3.x+、Python 3、GCC 7+ 或 Clang 5+
路线图
2025 Q4 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━Top issues
#124Error during DuckDB node deployment18 comments · 2026-02-05#129mysqld crash at Dir_Walker::is_directory for debug builds4 comments · 2026-03-25#157Corrupt database file3 comments · 2026-06-27#138cannot be converted from type 'varchar(6000(bytes))' to type 'mediumtext'3 comments · 2026-04-07#146部分配置情况下开启主从复制线程会导致服务hang住2 comments · 2026-05-09#123Does it work with strict mode = off?2 comments · 2026-02-04#170Deployment Architecture Issues1 comments · 2026-07-21#156VECTOR INDEX with M=200 returns farthest candidates on 1D monotonic vectors1 comments · 2026-05-29
Discussions
Latest release
AliSQL-8.0.44-3 AliSQL-8.0.44-3 2026-10-16AliSQL 8.0.44-3 Prebuilt AliSQL binaries for Linux x86_64 and aarch64 (glibc 2.17). Binary Packages | Platform | Package | | --- | --- | | Linux x86_64 | alisql-8.0.44-3-linux-glibc2.17-x86_64.tar.xz | | Linux aarch64 | alisql-8.0.44-3-linux-glibc2.17-aarch64.tar.xz | Docker Image The linux/amd64 and linux/arm64 image is built after both binary packages are published. - Image: songhuaxiong/alisql:8.0.44-3 - Build status: GitHub Actions bash docker pull songhuaxiong/alisql:8.0.44-3 Changelog English changelog | Chinese changelog This update adds binlog realtime replication (BRR),