一、引言

在企业数字化转型的浪潮中，数据集成成为了关键挑战。作为分布式数据库的领军者， OceanBase 不仅具备强大的分布式能力，还能通过 DBLink 技术与传统 Oracle 数据库实现无缝对接。

最近因为业务需要，要在 OceanBase 中通过 DBLink 直接查询远端 Oracle 数据库的数据。本以为是一条 CREATE DATABASE LINK 就能搞定的事，结果却踩了不少的坑。本文将完整复盘这次排错过程，并提炼出关键知识点，希望能帮助你避开同样的坑。

二、准备工作

1. 权限检查

创建 DBLink 的用户需要具备相应权限：

-- 授予普通用户创建 DBLink 的权限
grant create database link to username;

2. 环境配置

OceanBase 本身是自研数据库，要访问 Oracle，必须借助 Oracle 官方提供的 OCI（Oracle Call Interface）驱动。OCI 是一套 C 语言 API，负责与 Oracle 服务端通信。OceanBase 的 DBLink 底层会动态加载 libclntsh.so 来建立连接。于是从 ORACLE官网下载客户端，本着装新不装旧的原则选了19.27的客户端，没想到就踩了第一个坑。

坑一： V4.2.1及之后版本x86环境选用ORACLE 12.2客户端，arm环境选用ORACLE19.10客户端

--在所有Observer上安装ORACLE客户端

[root@localhost ~]# rpm -ivh oracle-instantclient1 9 .2 7 *

Preparing... ################################# [100%]

Updating / installing...

1:oracle-instantclient1 9 .2 7 -basic-1 9 ################################# [ 50%]

2:oracle-instantclient1 9 .2 7 -sqlplus-################################# [100%]

--将lib文件全部拷贝至

[root@localhost lib]# cd /usr/lib/oracle/19.27/client64/lib

[root@localhost lib]# mkdir -p /home/admin/oceanbase/lib/

[root@localhost lib]# scp -r * /home/admin/oceanbase/lib/

[root@localhost lib]# cd /home/admin/oceanbase/

[root@localhost oceanbase]# chown -R admin:admin lib

--在admin用户下配置环境变量

export LD_LIBRARY_PATH=/home/admin/oceanbase/lib:$LD_LIBRARY_PATH

在 oracle上创建测试表

SQL> insert into test_link values (1,'zhangsan');

1 row created.

SQL> insert into test_link values (2,'lisi');

1 row created.

SQL> commit;

Commit complete.

在 oceanbase上创建dblink

obclient [LINK_TEST]> CREATE DATABASE LINK dblink_name CONNECT TO user@oracle IDENTIFIED BY remote_password OCI HOST 'ip:port/oracle_service_name';

Query OK, 1 row affected (0.905 sec)

使用说明：

dblink_name：DBLink 的名称，长度不超过 128 个字符。

user：远端 Oracle 数据库的用户名。

oracle：连接 Oracle 数据库时，该值始终为 oracle。

remote_password：远端 Oracle 数据库用户的登录密码。密码中如果有 @#! 等除数字、字母以外的其他特殊字符时，需要使用双引号将密码括起来避免报语法出错。

OCI：表示指定访问的远端数据库的类型为 Oracle。如果不指定该参数，则默认访问的远端数据库类型为 OceanBase。

ip：指定远端 Oracle 数据库实例的 IP 地址。

port：指定远端 Oracle 数据库实例的端口号。

oracle_service_name：远端 Oracle 数据库服务的名称。

连接测试