一、编译安装mysql_fdw
在编译opengauss时,configure中指定--enable-mysql-fdw,就可以一起把mysql_fdw编译出来,并且make install时也会安装相关文件和库,但是,有个前提,就是编译机器上要安装mariadb-libs,mariadb-devel:
sudo yum install mariadb-libs
sudo yum install mariadb-devel
按照官网文档,还要安装mariadb-shared,但是,我的yum仓里没有,后来发现主要是缺少libmariadb.so这个库,我试过可行的方法是下载源码编译:
git clone https://gitee.com/mirrors/mariadb.git
这是mariadb server的完整代码,不过没有必要编译mariadb server,在它的目录下有个libmariadb目录,到这个目录下执行:
mkdir build_dir
cd build_dir
cmake ..
make
然后在build_dir/libmariadb目录下生成了libmariadb.so,将它复制到opengauss/lib目录下,上面的操作,在每个节点上都要这么作。其中libmariadb.so可以在复制到安装包里,安装分发时就有了。
二、opengauss上mysql_fdw的使用
首先需要创建extension
CREATE EXTENSION MYSQL_FDW;
然后创建server:
CREATE SERVER mysql_server_test FOREIGN DATA WRAPPER mysql_fdw OPTIONS (HOST '172.32.148.154', PORT '3306');
这一步创建名称为mysql_server_test的server,server代表一个远程mysql服务器,其中包含了连接mysql服务器的IP和端口。
然后创建user mapping,在创建user mapping 以前:
在opengauss/bin目录下创建usermapping.key.cipher文件。每个节点都要做这个操作,也可以在安装时先创建到opengauss/bin,再打包分发,就是所有节点共用一份。
gs_guc generate -o usermapping -S default -D $GAUSSHOME/bin
CREATE USER MAPPING FOR postgres SERVER mysql_server_test OPTIONS (username 'root', password '123');
这是创建opengauss用户到mysql_server_test所指的远程mysql服务器的用户映射,映射的是本地的postgres用户到mysql服务器上的root用户,还要包括root用户密码。
然后创建外部表,即远程mysql上的表到opengauss本地表的映射:
create foreign table mysql_t1(id int,name varchar(64), hiredate timestamp, resume text) server mysql_server_test options(dbname 'dev',table_name 't1');
这条件语句创建了一个名为mysql_t1的外部表,它的列名和类型定义,应该与远程mysql表一一对应或兼容(对于mysql_fdw列名必须相同)。
语句的后半部分,指定了mysql_t1要映射到哪个远程mysql服务器(mysql_server_test),和哪个schema(dev)的哪个表(t1)。
mysql侧t1表的定义:
在mysql中,database和schema是相同的概念,create database和create schema是一个效果,show databases和show schemas得到的也是相同的结果。
查询mysql外表
对于mysql_fdw,创建外表时不需要指定options(key 'true'),实际上mysql_fdw并不支持创建外表时对列指定options,只要mysql侧定义了主键,opengauss侧就可以增删改查,因此mysql_fdw关键是mysql侧定义表时要有主键。
三、查看opengauss上的外表信息
\dew+ 查看所有wrapper信息:
\des+ 查所有wrapper的server信息:
\deu+ 查看所有user mapping信息
\det+ 查看所有外表: