KDB_Database_Link 使用介绍

kdb_database_link 是 KingbaseES 为了兼容oracle 语法而开发的跨数据库访问扩展，可用于访问KingbaseES, Postgresql , Oracle 。以下分别介绍跨数据库访问KingbaseES 与Oracle 的配置过程。

 注意：database link 支持DML 操作 是从V8R6C4B0021 版本开始的，对于两端都是KingbaseES 数据库的，只需要源端是V8R6C4B0021 版本，目标端版本无要求（但必须保证ODBC 版本能够连接）。

一、配置ODBC

1、安装

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14

[root@dbhost02 etc]# yum install unixODBC.x86_64   [kb86@dbhost02 data86]$ isql --version unixODBC 2.3.1   [kb86@dbhost02 data86]$ odbcinst -j unixODBC 2.3.1 DRIVERS............: /usr/local/etc/odbcinst.ini SYSTEM DATA SOURCES: /usr/local/etc/odbc.ini FILE DATA SOURCES..: /usr/local/etc/ODBCDataSources USER DATA SOURCES..: /home/kingbase/.odbc.ini SQLULEN Size.......: 8 SQLLEN Size........: 8 SQLSETPOSIROW Size.: 8

如果设置了LD_LIBRARY_PATH环境变量，则实际生效的是/usr/local/etc/odbcinst.ini ，否则可能是 /etc/odbcinst.ini。

注意：由于不同版本之间存在差异，为了保证能读取正确的配置，强烈建议统一使用用户主目录下 .odbc.ini 文件。

2、配置

根据odbcinst -j 显示的路径，配置 odbcinst.ini 和 odbc.ini 文件。

odbcinst.ini 文件内容如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

[root@dbhost03 etc]# cat /usr/local/etc/odbcinst.ini # Example driver definitions   # Driver from the postgresql-odbc package # Setup from the unixODBC package [PostgreSQL] Description     = ODBC for PostgreSQL Driver          = /usr/lib/psqlodbcw.so Setup           = /usr/lib/libodbcpsqlS.so Driver64        = /usr/lib64/psqlodbcw.so Setup64         = /usr/lib64/libodbcpsqlS.so FileUsage       = 1     # Driver from the mysql-connector-odbc package # Setup from the unixODBC package [MySQL] Description     = ODBC for MySQL Driver          = /usr/lib/libmyodbc5.so Setup           = /usr/lib/libodbcmyS.so Driver64        = /usr/lib64/libmyodbc5.so Setup64         = /usr/lib64/libodbcmyS.so FileUsage       = 1   [KingbaseES V8R6 ODBC Driver] Description     = ODBC for KingbaseES Driver          = /opt/kb86/ES/V8/Interface/odbc/kdbodbcw.so Debug           = 1 CommLog         = 1

odbc.ini 文件内容如下（可选配置，主要用于isql 验证）：

[v8r6]
Description=KingbaseES
Driver=KingbaseES V8R6 ODBC Driver
Servername=localhost
Database=test02
Username=user02
Password=user02
Port=54321

 

3、isql 验证 (可选)

必须配置了 odbc.ini ，才能进行此步骤

[kb86@dbhost02 data86]$ isql v8r6
+---------------------------------------+
| Connected! |
| |
| sql-statement |
| help [tablename] |
| quit |
| |
+---------------------------------------+

SQL> 

4、验证驱动

验证kingbase自带的驱动 kdbodbcw.so，确保没有"not found"

?

1	ldd /opt/kb86/ES/V8/Interface/odbc/kdbodbcw.so

二、连接kingbase

1、修改 shared_preload_libraries 参数

需将kdb_database_link 加入 shared_preload_libraries 中，注意 kdb_database_link 必须放在最后，因为，与其他项间有依赖关系。

2、创建扩展

?

1	kdb_database_link 实际是在kingbase_fdw上层进行了包装，需要kingbase_fdw扩展。以system用户连接，创建组件：

?

1 2	create extension kdb_database_link create extension kingbase_fdw

   kdb_database_link 扩展创建后，会生成 $KINGBASE_DATA/sys_database_link.conf文件，类似于oracle 的tnsnames.ora 文件，用于配置服务名，在创建database link时使用。模板内容如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

#[oradb] #dbtype=Oracle #dbname=orcl #DriverName="Oracle12C ODBC Driver" #host=127.0.0.1 #port=1521   [svr42] dbtype=Kingbase dbname=test02 DriverName="KingbaseES V8R6 ODBC Driver" host=192.168.237.42 port=54321   #[PostgreSQL] #dbtype=Postgres #dbname=postgres #DriverName="PostgreSQL ODBC Driver" #host=127.0.0.1 #port=5432

3、创建数据链

?

1 2 3

create public database link to_svr42 connect to 'user_remote' identified by 'user_remote' using ( DriverName = 'KingbaseES V8R6 ODBC Driver' , Host = '192.168.237.42' , Port = 54321 , Dbname = 'test' , Dbtype = 'kingbase')   create public database link to_svr42 connect to 'user02' identified by 'user02' using 'svr42'          --或者修改sys_database_link.conf，配置正确的连接串。

数据链创建完后，会在pg_foreign_server 和 pg_user_mappings 增加相关条目

?

1 2 3 4 5 6 7 8 9 10

test=# select * from pg_user_mappings;                                                                   umid  | srvid |           srvname           | umuser |  usename   |                umoptions                -------+-------+-----------------------------+--------+------------+-----------------------------------------  16535 | 16534 | dblink_server_to_svr42_2200 |      0 | public     | {user=user_remote,password=user_remote} (2 rows)   test=# select * from pg_foreign_server;                                                                   oid  |           srvname           | srvowner | srvfdw | srvtype | srvversion |                srvacl                 |                  srvoptions                  -------+-----------------------------+----------+--------+---------+------------+---------------------------------------+----------------------------------------------  16534 | dblink_server_to_svr42_2200 |       10 |  16495 |         |            |                                       | {dbname=test,host=192.168.237.42,port=54321}

4、验证数据链

test=# select * from user02.t1@to_svr42;
 id 
----
(0 rows)

test=# insert into user02.t1@to_svr42 values(1);
INSERT 0 1
test=# update user02.t1@to_svr42 set id=2;
UPDATE 1
test=# select * from user02.t1@to_svr42;
 id 
----
  2
(1 row)

test=# delete from user02.t1@to_svr42; 
DELETE 1

5、删除数据链

?

1	drop database link public.to_svr42;

三、连接oracle

1、创建扩展

 如果要通过database link 连接访问oracle数据库，除了kdb_database_link外，还需要 oracle_fdw 插件。

create extension oracle_fdw;
create extension kdb_database_link；

2、配置sys_database_link.conf

?

1 2 3 4 5 6

[oradb] dbtype=Oracle dbname=SOGG DriverName="Oracle ODBC Driver" host=192.168.237.41 port=1521

3、配置odbc

修改 /usr/local/etc/odbcinst.ini ， 增加：

[Oracle ODBC Driver]
Description     = ODBC for Oracle
Driver          = /opt/kb86/ES/V8/Server/lib/libsqora.so.19.1

Note：具体配置ODBC 连接oracle 过程见：https://www.cnblogs.com/kingbase/p/14921071.html

4、创建database link

?

1 2 3 4

create public database link to_ora42 connect to 'USER02' identified by 'user02' using 'oradb'   create public database link to_ora42 connect to 'USER02' identified by 'user02' using ( DriverName = 'Oracle ODBC Driver' , Host = '192.168.237.41' , Port = 1521 , Dbname = 'SOGG' , Dbtype = 'oracle')

数据链创建后，可以在 字典表sys_database_link 与 pg_foreign_server 看到相关信息。

5、验证数据访问