KDB_Database_Link 使用介绍

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

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

一、配置ODBC

1、安装

[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 文件内容如下：

[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"

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

二、连接kingbase

1、修改 shared_preload_libraries 参数

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

2、创建扩展

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

create extension kdb_database_link
create extension kingbase_fdw

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

#[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、创建数据链

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 增加相关条目

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、删除数据链

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

[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

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、验证数据访问