开源数据库OceanBase源码解读(九):tableAPI和OB多模型

2024年 5月 7日 76.2k 0

开源数据库OceanBase源码解读(九):tableAPI和OB多模型-1

本文作者:竹翁(杨志丰),毕业于北京大学, OceanBase 内核研发总监。近十年来一直在阿里巴巴/蚂蚁金服自主研发分布式系统和数据库的从事研发工作。

在刚刚发布的 OceanBase 社区版 3.1.1 中,OceanBase 开放了一组新的 API 叫做 Table API 。Table API 以 API而非 SQL 的方式提供了一种新的访问 OceanBase 数据的接口。熟悉 MySQL 的同学,可以把它类比为 MySQL 的 sockethandler 。

不过 Table API 提供的能力更强大,它把 OceanBase 可靠和可扩展的分布式存储层能力直接提供给应用程序,提供了灵活(非关系模型)和轻量的数据访问接口(无连接状态),应用程序可以把 Table API 当做 key-value , Table-store , Hbase(我们提供了兼容 Hbase 的 API 和驱动)等多种数据模型的数据库来使用。在简单读写场景下,Table API 比 SQL 也有一定的性能优势(响应延时)。

这是 OceanBase 开放生态的重要举措,第三方系统可以相对容易的在 OceanBase 的 Table API 服务之上封装增值的数据服务。例如,我们在蚂蚁集团内部广泛部署的时序数据库 CeresDB 就是这么做的。

下面介绍一下 TableAPI 相关代码。

Table API模块通过 obrpc 协议提供数据服务,他的服务端口和 observer 的 rpc 端口一样。服务端的主体代码位于 src/observer/table/。

开源数据库OceanBase源码解读(九):tableAPI和OB多模型-2

上面文件中,叫做 xxx_processor 的,主要都是协议层的处理。

execute_processor 是单行操作的处理函数,batch_execute_processor 是批量多行操作的处理函数,query_processor 是扫描操作的处理函数。

主体的逻辑在 ob_table_service.h/cpp中。通过学习 Table API 的代码,可以快速学习 OceanBase 存储层、事务层对 SQL 层提供的接口。

开源数据库OceanBase源码解读(九):tableAPI和OB多模型-3

Table API 的 rpc 请求和结果的数据结构,定义在 src/share/table 中。从 ObTableOperation 类的定义中,可以看到 Table API 提供了单行的 insert, delete, insert or update(无索引时即 put ), replace, retrieve(get), increment, append,以及他们任意组合的批量操作。通过 ObTableQuery 接口,提供了范围扫描操作。

Table API 当前有 Java 和 Rust 两种语言的驱动,对某个分区的查询由客户端发送到 leader 副本所在的 observer上。如果发生了主备切换,需要驱动实现重试逻辑。

欢迎大家在 Table API 之上扩展更多应用。

附录:前八篇源码解读文章可供参考

1、OceanBase 数据库源码解读(一)引言

2、OceanBase 数据库源码解读(二)目录结构

3、OceanBase 源码解读(三)SQL 的一生

4、OceanBase 源码解读(四)分区的一生

5、OceanBase 源码解读(五)事务的一生

6、OceanBase 源码解读(六)租户的一生

7、OceanBase 源码解读(七)带你看透虚拟表

8、OceanBase 源码解读(八)OB高性能执行引擎

联系我们

欢迎广大 OceanBase 爱好者、用户和客户有任何问题联系我们反馈:

社区版官网论坛

社区版项目网站提 Issue

钉钉群:33254054

开源数据库OceanBase源码解读(九):tableAPI和OB多模型-4

相关文章

Oracle如何使用授予和撤销权限的语法和示例
Awesome Project: 探索 MatrixOrigin 云原生分布式数据库
下载丨66页PDF,云和恩墨技术通讯(2024年7月刊)
社区版oceanbase安装
Oracle 导出CSV工具-sqluldr2
ETL数据集成丨快速将MySQL数据迁移至Doris数据库

发布评论