人大金仓数据库mysql_fdw扩展的使用

金仓数据库mysql_fdw扩展的使用

关键字：

dblink、外部表、kingbaseES、mysql 、人大金仓

mysql_fdw介绍

mysql_fdw是KingbaseES的一个扩展插件，提供了一个外部数据包装器，可以方便高效的访问Mysql数据库。

mysql_fdw的使用步骤

使用mysql_fdw主要包括以下步骤：

1. 创建扩展 (CREATE EXTENSION)，需要先安装mysql_fdw扩展；
2. 创建服务 (CREATE SERVER)，创建一个外部服务器对象，用来表示想要连接的远程数据库。
3. 创建用户映射 (CREATE USER MAPPING)，每一个用户映射都代表着你允许一个数据库用户访问一个外部服务器。
4. 创建与访问表对应的外表 (CREATE FOREIGN TABLE)，然后即可通过该外表访问存储在它对应的mysql数据库中的数据，当权限允许时，也可以使用insert、update或者delete语句修改远程表。

mysql_fdw使用展示

使用mysql_fdw需要用户具有superuser（超级用户）的权限，且必须有密码登录，KingbaseKES已经默认已经安装了mysql_fdw扩展，不需要个人再独自安装。

1. 初始化数据，登录mysql数据库，建立一个用于测试的表并插入数据。

登录mysql命令：

./mysql -h host -P port -u username -p password

例如：

./mysql -h 192.168.45.183 -P 3306 -u guangtong -p

1. kes中创建mysql_fdw

同fdw相关的系统视图包括sys_extension、sys_foreign_data_wrapper、sys_foreign_server、sys_user_mappings、sys_foreign_table。在创建扩展前，可以先搜索是否已经创建过扩展，防止创建失败。

1. 创建服务

使用create server创建一个外部服务器对象，它用来表示想要连接的远程数据库，指定除了user和password之外的连接信息作为该服务器的选项（options），必选项为host(服务器ip地址)，服务器端口号（port）,（其他更具体信息可以参考KingbaseES产品手册）。同时，需要提供创建外部服务依赖的外部数据包装器（mysql_fdw）。

1. 创建用户映射

定义一个用户到外部服务器的映射，可以理解为当前用户依赖指定的外部映射用来访问外部服务器上的数据库。

options包括：

• username: 连接MySQL数据库的用户名；
• password：对应连接用户的密码。

（5）创建与访问表对应的外表

使用CREATE FOREIGN TABLE创建一个ksql用户到外部mysql服务器的一个用户表映射，options包括：

• dbname: MySQL数据库的数据库名；
• table_name: MySQL数据库中的表名，默认与外表名相同；
• max_blob_size: 最大的blob size，超过64KB后将被截断，取值范围为0-64KB（默认值为64K）；
• fetch_size: 同server的参数，默认值为100。

注意：外部表的列必须匹配被引用的远程表，且必须使用mysql_fdw可以转换的数据类型定义kes列，可以参考表1.1。

表1.1 mysql_fdw支持的类型转换

参考资料

KingbaseES产品手册