贡献者介绍

李人瑞，本科毕业于中国矿业大学数据科学与大数据技术专业，现就读于苏州大学，攻读大数据技术与工程专业的研究生学位。

在参与2023年12月于无锡举行的OpenAtom Techathon极限24小时编程马拉松活动中，李人瑞第一次接触了OpenTenBase，学习了相关的基础知识。后续，他作为小队队长参加了开放原子开源大赛OpenTenBase开源核心贡献挑战赛，对OpenTenBase进行Oracle语法适配，并获得了开源贡献奖。

案例背景

OpenTenBase是腾讯云数据库团队在PostgreSQL基础上研发的企业级分布式HTAP开源数据库，具有高扩展性、商业数据库语法兼容、分布式HTAP引擎、多级容灾和多维度资源隔离等能力，成功应用在金融、政府、电信、医疗、航天等行业的核心业务系统。

本案例主要关注Oracle语法中的select xxx from 主表 partition（子表）。通过对OpenTenBase中的语法表进行修改，实现了案例功能，并编写了相应的回归测试内容以验证修改的有效性。

技术实现

1. 系统部署

在这个案例中，使用VMware Workstation创建了两台虚拟机，系统为CentOS 7（1511）。考虑到CentOS 7目前已停止维护，后续对此案例的实现可以使用OpenTenBase推荐的操作系统，如TencentOS 2, TencentOS 3, OpenCloudOS, Ubuntu。虚拟机的硬件设备设置如图一。

图 1 虚拟机的硬件设备设置

2. OpenTenBase部署

OpenTenBase的部署可以参考官方文档https://docs.opentenbase.org/guide/01-quickstart/。下面，通过源码编译的方式，在两台虚拟机上部署OpenTenBase。

首先，在虚拟机上安装相关依赖。

图2 相关依赖安装

在OpenTenBase集群中的所有系统上创建opentenbase用户，之后的有关opentenbase的步骤都要切换到opentenbase用户下再进行操作。

之后，下载源码并进行编译安装（这里使用GitHub，也可以使用AtomGit和Gitee网址）

1. cd ${SOURCECODE_PATH}
2. rm -rf ${INSTALL_PATH}/opentenbase_bin_v2.0
3. chmod +x configure*
4. ./configure –prefix=${INSTALL_PATH}/opentenbase_bin_v2.0 –enable-user-switch –with-openssl –with-ossp-uuid CFLAGS=-g
5. make clean
6. make -sj
7. make install
8. chmod +x contrib/pgxc_ctl/make_signature
9. cd contrib
10. make -sj
11. make install （完成安装）
12. 上述代码中的两个参数如下所示
13. ${SOURCECODE_PATH}=/data/opentenbase/OpenTenBase
14. ${INSTALL_PATH}=/data/opentenbase/install

下面以两台服务器上搭建1GTM主，1GTM备，2CN主（CN主之间对等，因此无需备CN），2DN主，2DN备的集群，该集群为具备容灾能力的最小配置。

集群规划如下：

禁用SELinux和防火墙：

1.vi /etc/selinux/config
2.systemctl disable firewalld
3.systemctl stop firewalld

执行vi /etc/selinux/config后，将文件中SELINUX=enforcing修改为SELINUX=disabled，如下图所示

禁用防火墙流程如图所示。

配置机器间的ssh互信：

1.su opentenbase
2.ssh-keygen -t rsa
3.ssh-copy-id -i ~/.ssh/id_rsa.pub destination-user@destination-server

对于两台机器组成的集群，第三行代码（ssh-copy-id）在每台机器上要执行两次，即对本机和另一台机器进行ssh配置，详细内容见图4。

之后，在集群中的所有机器上进行配置环境变量：

1.[opentenbase@localhost ~]$ vim ~/.bashrc
2.export OPENTENBASE_HOME=/data/opentenbase/install/opentenbase_bin_v2.0
3.export PATH=$OPENTENBASE_HOME/bin:$PATH
4.export LD_LIBRARY_PATH=$OPENTENBASE_HOME/lib:${LD_LIBRARY_PATH}
5.export LC_ALL=C

图3 配置环境变量

图4 配置ssh互信

之后，初始化pgxc_ctl.conf文件：

1.[opentenbase@localhost ~]$ mkdir /data/opentenbase/pgxc_ctl 2.[opentenbase@localhost ~]$ cd /data/opentenbase/pgxc_ctl
3.[opentenbase@localhost ~/pgxc_ctl]$ vim pgxc_ctl.conf

图5 初始化pgxc_ctl.conf文件

pgxc_ctl.conf文件可以复制官网快速入门文档中的内容，主要修改其中的IP地址，如图5红色部分所示。

在一个节点配置好配置文件后，需要预先将二进制包部署到所有节点所在的机器上，这个可以使用pgxc_ctl工具，执行deploy all命令来完成。

图6 使用pgxc_ctl进行文件分发

不用退出pgxc_ctl，输入并执行init all，进行集群的初始化。初始化之后，可以使用monitor all检查集群的运行情况。如图7所示，所有节点都正常运行。

图7 集群运行情况

之后，可以用访问PostgreSQL的方式，对OpenTenBase集群进行访问。

图8 访问OpenTenBase集群

3. Oracle语法适配

主要对语法表进行修改，以实现该案例中的语法适配。

其中，语法表gram.y位于OpenTenBase源文件的src/backend/目录下。

如图9所示，添加了红色框内的内容。通过对gram.y的内容进行分析，OpenTenBase之前已经有一部分关于partition的代码，所以直接添加了相关的语法，以达到目标。

图9 修改gram.y

为了验证修改的有效性，需要编写相应的回归测试内容。

其中，回归测试的相关内容位于OpenTenBase源文件的src/backend/目录下。

首先，创建用于回归测试的sql文件，文件路径为：src/test/regress/sql/select_partition.sql，内容为

– – PARTITION

CREATE TABLE t_base ( id serial, country text, task text, turnover numeric ) PARTITION BY LIST (country);

CREATE TABLE t_austria PARTITION OF t_base FOR VALUES IN (‘Austria’);

CREATE TABLE t_usa PARTITION OF t_base FOR VALUES IN (‘USA’);

CREATE TABLE t_ger_swiss PARTITION OF t_base FOR VALUES IN (‘Germany’, ‘Switzerland’);

CREATE TABLE t_rest PARTITION OF t_base DEFAULT;

INSERT INTO t_base (country, task, turnover) VALUES (‘Uganda’, ‘Some task’, 200);

INSERT INTO t_base (country, task, turnover) VALUES (‘USA’, ’taskUSA’, 2);

INSERT INTO t_base (country, task, turnover) VALUES (‘Austria’, ’taskAustria’, 1000);

INSERT INTO t_base (country, task, turnover) VALUES (‘Germany’, ’taskGermany’, 500);

INSERT INTO t_base (country, task, turnover) VALUES (‘Switzerland’, ’taskSwiss’, 700);

INSERT INTO t_rest (country, task, turnover) VALUES (‘Canada’, ’taskCanada’, 300);

select * from t_base partition (t_rest); select * from t_base partition (t_austria); select * from t_base partition (t_usa); select * from t_base partition (t_ger_swiss);

将上述代码与其理想输出写入文件中，这个文件的文件路径为：src/test/regress/expected/select_partition.out。注意，sql文件与out文件的文件名是一样的。

图10 out文件的内容

之后，将该测试内容添加进测试计划中，测试计划的文件路径为：

src/test/regress/parallel_schedule

图11 添加测试计划

修改之后，需要对OpenTenBase重新进行编译安装，并进行回归测试。

安装步骤：

1. cd ${SOURCECODE_PATH}
2. rm -rf ${INSTALL_PATH}/opentenbase_bin_v2.0
3. chmod +x configure*
4. ../configure --prefix=${INSTALL_PATH}/opentenbase_bin_v2.0 --enable-user-switch --with-openssl --with-ossp-uuid CFLAGS=-g
5. make check（回归测试）
6. make clean
7. make -sj
8. make install
9. chmod +x contrib/pgxc_ctl/make_signature
10. cd contrib
11. make -sj
12. make install（完成安装）

参数说明：

1. ${SOURCECODE_PATH}=/data/opentenbase/OpenTenBase
2. ${INSTALL_PATH}=/data/opentenbase/install

修改后的回归测试输出如图12，可见添加的测试内容成功运行，且没有引入其他的错误。

图12 回归测试输出

修改之后，需要对编译后的OpenTenBase重新进行集群搭建，可以参考官方文档与2. OpenTenBase部署部分。

完成以上部分，我们就实现了OpenTenBase对select xxx from 主表 partition（子表）这一语法的适配功能。

经验总结

本案例通过修改语法表的内容，实现了OpenTenBase对Oracle语法的适配。本次案例有以下几点经验可供借鉴：

1.可以查看语法表中已实现的内容，简单实现语法扩展。

2.修改内容后，要添加对应的回归测试内容，验证修改的有效性，且保证修改不引入更多的bug。

3.对于OpenTenBase源码修改任务，需要深入学习数据库知识，如编译器知识，语法知识等。

总的来说，本案例对OpenTenBase进行了简单的修改，如果需要适配更加复杂的内容，需要继续学习相应的数据库底层原理与知识。

我们目前正在积极征集OpenTenBase的用户使用案例，如果您有相关使用经验，欢迎提交给我们。也期待您加入OpenTenBase社区，跟我们共同推动项目发展！

官网： https://www.opentenbase.org/

贡献代码

• AtomGit

  https://atomgit.com/opentenbase/OpenTenBase

• GitHub

  https://github.com/OpenTenBase/OpenTenBase