外部链接 | 达梦技术文档

外部链接对象（LINK）是 DM 中的一种特殊的数据库实体对象，它记录了远程数据库的连接和路径信息，用于建立与远程数据的联系。通过多台数据库主库间的相互通讯，用户可以透明地操作远程数据库的数据，使应用程序看起来只有一个大型数据库。用户远程数据库中的数据请求，都被自动转换为网络请求，并在相应结点上实现相应的操作。用户可以建立一个数据库链接，以说明一个对象在远程数据库中的访问路径。这个链接可以是公用的（数据库中所有用户使用），也可以是私有的（只能被某个用户使用）。

用户可以通过外部链接对远程数据库的表进行查询和增删改操作，以及本地调用远程的存储过程。

16.1 创建外部链接

创建一个外部链接。

语法格式

CREATE [OR REPLACE] [PUBLIC] LINK <外部链接名> CONNECT ['<连接库类型>'] WITH <登录名> IDENTIFIED BY <登录口令> USING '<外部连接串>' [<OPTION子句>];
<连接库类型> ::= 
	DAMENG | 
	ORACLE | 
	ODBC | 
	DPI
<外部链接串>::=
	<DAMENG外部链接串>| 
	<ORACLE外部链接串> | 
	<ODBC外部链接串> | 
	<DPI外部链接串>
<DAMENG外部链接串>::=[<连接类型>;]<服务器列表>
<连接类型>::= 
	PRIMARY FIRST |
	STANDBY FIRST |
	PRIMARY ONLY |
	STANDBY ONLY
<服务器列表>::=
  	<服务器地址> |
	<服务器地址>{,<服务器地址>}
<服务器地址>::=
	<实例IP地址>/<实例端口号> |
	<MAL IP地址>/<MAL端口号> |
	<实例名>
<ORACLE外部链接串>::= 
    <tsn_name> |
	<description>|
	<IP地址>/<服务名> 
<description>::=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=<IP地址>)(PORT=<端口号>)))(CONNECT_DATA=(SERVICE_NAME=<服务名>)))
<ODBC外部链接串>::= <ODBC数据源DSN>
<DPI外部链接串>::= <IP地址>:<端口号> | <服务名>
<OPTION子句>:: =(<option项>{, <option项>})
<option项>:: =
	LOCAL_CODE=<选项值> |
	CONVERT_MODE=<选项值> |
	BYTES_IN_CHAR=<选项值> |
	DB_TYPE=<选项值>|
	DATA_CHARSET=<选项值>

参数

OR REPLACE 使用 OR REPLACE 选项的好处是，如果系统中已经有同名的数据库链接名，服务器会自动用新的代码覆盖原来的代码。如果不使用 OR REPLACE 选项，当创建的新外部链接名称与系统中已有的外部链接名称同名时，服务器会报错；
PUBLIC 此链接对象是否能够被创建者之外的用户引用；
< 外部链接名 > 数据库链接的名称；
< 连接库类型 > 目前只支持 DAMENG、ORACLE、ODBC 或 DPI，默认为 DAMENG；
< 登录名 > 登录用户名称；
< 登录口令 > 登录用户口令；
< 连接类型 > 当 DBLINK 连接到多机环境时，可以设定 < 连接类型 > 和指定多台 < 服务器地址 >。< 连接类型 > 用来指定 DBLINK 将采用何种优先级别连接到 < 服务器列表 > 中的机器，共四种连接类型：PRIMARY FIRST 为主机优先连接；STANDBY FIRST 为备机优先连接；PRIMARY ONLY 为只连主机；STANDBY ONLY 为只连备机。缺省为 PRIMARY FIRST。< 连接类型 > 为可选项，一旦指定了 < 连接类型 >，则必须指定 < 服务器地址 > 数大于等于 2；
<DAMENG 外部链接串 > 支持三种格式，分别对应目标节点在 dmmal.ini 中的配置项，具体如下：
- < 实例 IP 地址 >/< 实例端口号 > 对应 mal_inst_host/mal_inst_port。
- <MAL IP 地址 >/<MAL 端口号 > 对应 mal_host/mal_port。
- 实例名对应 mal_inst_name。
<ORACLE 外部链接串 > 可以使用配置的网络服务名 tsn_name(网络服务名需要配置)，或者连接描述符 description（连接描述符是网络连接目标特殊格式的描述，它包括网络协议、主库 IP 地址、端口号和服务名），或者 <IP 地址 >/< 服务名 >；
<ODBC 外部链接串 >DSN 需要用户手动配置；
<DPI 外部链接串 > 仅支持通过 DPI 接口访问远程达梦数据库，不需要进行额外配置；
<option 项 > 目前所支持的选项与取值如下：

LOCAL_CODE：接口（DPI、OCI、JDBC 等接口）的字符集。若与服务器的字符集不一致，则需要进行转换。可取值为 UTF-8，GBK 或 GB18030。
CONVERT_MODE：表示字符转换过程中对不完整字符的处理规则：0 表示截断不完整字符，不报错；1 表示报错处理。
BYTES_IN_CHAR：整型数字，表示一个字符由多少个字节组成。
DB_TYPE：设置目标数据库类型，目前支持 SQLSERVER、MYSQL、PI、ORACLE、DAMENG，仅对 ODBC 类型的 DBLINK 有效。
DATA_CHARSET：设置接口返回给达梦服务器数据的实际字符集。取值为 UTF-8，GBK 或 GB18030。

图例

创建外部链接：

创建外部链接

外部链接串：

外部链接串

DAMENG 外部链接串：

dameng 外部链接串.jpg

服务器地址：

服务器地址

OPTION 子句：

OPTION 子句.png

option 项：

option 项.png

语句功能

创建一个外部链接。

使用说明

要创建到 DM 数据库的外部链接，必须首先配置 dmmal.ini，才能使用 LINK。DM 的连接串有两种格式：

INSTANCE_NAME:直接使用远程库的实例名（该实例名必须配置到 dmmal.ini 中）；

<IP 地址 >/< 端口号 >:其中端口号为 DM 外部链接服务器的 dmmal.ini 配置中的 MAL_PORT 端口号。

dmmal.ini 各配置项的值、前后顺序，必须保持完全一致。dmmal.ini 的详细配置可参考《DM8 系统管理员手册》，需要注意同时将 dm.ini 中的 MAL_INI 参数置为 1 以开启 MAL 系统。
要创建到 ORACLE 的外部链接，可以使用配置的网络服务名 <tsn_name>；如果没有配置 tsn_name，可以使用连接描述符 <description>或者 <IP 地址 >/< 服务名 > 作为连接串。
要创建到 ORACLE 的外部链接，需要在当前机器安装 ORACLE 的 OCI 接口，且需要保证 OCI 接口与 DM 版本在 32 位/64 位保持一致。
通过 LINK 对远程服务器所作的修改，由用户在本地服务器通过 commit 或 rollback 进行提交或回滚。
只支持普通用户，不支持 SSL 和 Kerberos 认证。
不支持连接自身实例的 LINK。
支持在 CREATE SCHEMA 中 CREATE LINK，但是不支持 CREATE PUBLIC LINK。
只有 DBA 和具有 CREATE LINK 权限的用户可以创建外部链接。
当 DBLINK 链接的是多机系统且指定了多台服务器时，若所连接的服务器发生宕机等意外情况导致无法对外提供服务时，DBLINK 将根据设定的 < 连接类型 >，在剩余的服务器中挑选合适的服务器进行连接。
DPI 外部链接串可以使用 DPI 接口能够识别的 IP 地址和端口号，也可以使用 dm_svc.conf 文件中配置的服务名。达梦服务器安装成功后自带 DPI 库，因此用户无需进行其他配置操作，即可使用 DPI 外部链接串链接到远程达梦服务器。

举例说明

例 1 使用 DM 数据库，创建一个连接到 IP 地址为 192.168.0.31，MAL_PORT 端口号为 5369 的 MAL 站点的外部链接，登录到此站点使用的用户名为 USER01，密码为 AAA123456，实例名为：DMSERVER。

CREATE PUBLIC LINK LINK1 CONNECT 'DAMENG' WITH USER01 IDENTIFIED BY AAA123456 USING '192.168.0.31/5369';

或

CREATE PUBLIC LINK LINK1 CONNECT WITH USER01 IDENTIFIED BY AAA123456 using 'DMSERVER';    //DMSERVER为实例名

例 2 使用 DM 数据库，创建一个连接到 IP 地址为 192.168.0.225 机器上的 oracle 数据库的外部链接。可以通过三种方式创建：一网络服务名 tsn_name；二连接描述符 description；三 <IP 地址 >/< 服务名 >。

（一）通过网络服务名创建

首先介绍 Oracle 网络服务名的配置方法。网络服务名配置成功才能创建 DBLINK

配置本地的 Oracle 网络服务名 ORCL，连接 225 机器上的 orcl 实例。详细步骤如下：

步骤一

图16.1.1 步骤一

步骤二

16.1.2 步骤二

步骤三

16.1.3 步骤三

步骤四

16.1.4 步骤四

其次，创建 dblink。

网络服务名配置成功后，就可以使用网络服务名 ORCL 或网络连接描述符创建 DBLINK。

  CREATE LINK LINK1 CONNECT 'ORACLE' WITH USER01 IDENTIFIED BY USER01 USING 'ORCL';

（二）通过连接描述符创建

  CREATE OR REPLACE LINK LINK1 CONNECT 'ORACLE' WITH USER01 IDENTIFIED BY USER01 USING '(DESCRIPTION =

  (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.0.225)(PORT = 1521)))

  (CONNECT_DATA = (SERVICE_NAME = orcl) )

 )';

（三）通过 <IP 地址 >/< 服务名 > 创建

CREATE LINK LINK1 CONNECT 'ORACLE' WITH USER01 IDENTIFIED BY USER01 USING '192.168.0.225/orcl';

例 3 使用 DM 数据库，创建一个连接到实例名为 ORCL 的外部链接，登录到此站点使用的用户名为 USER01，设置登录口令为 USER01，设置使用本地字符集为 UTF-8，字符集转换模式为 1。

CREATE LINK LINK1 CONNECT 'ORACLE' WITH USER01 IDENTIFIED BY USER01 USING 'ORCL' OPTION (LOCAL_CODE='UTF-8', CONVERT_MODE=1);

16.2 删除外部链接

删除一个外部链接。

语法格式

  DROP [PUBLIC] LINK [IF EXISTS] [<模式名>.]<外部链接名>;

参数

1．< 模式名 > 指明被操作的外部链接属于哪个模式，缺省为当前模式；

2．< 外部链接名 > 指明被操作的外部链接的名称。

图例

删除外部链接

语句功能

删除一个外部链接。

使用说明

删除不存在的外部链接会报错。若指定 IF EXISTS 关键字，删除不存在的外部链接，不会报错；
只有链接对象的创建者和 DBA 拥有该对象的删除权限。

举例说明

删除外部链接 LINK1。

  DROP LINK LINK1;

16.3 使用外部链接

通过外部链接，可以对远程服务器的对象进行查询或进行增删改操作，可以调用远程的过程。

使用外部链接进行查询或增删改的语法格式与普通格式基本一致，唯一的区别在于指定外部链接表时需要使用如下格式作为表或视图的引用：

  [TABLENAME | VIEWNAME] @链接名

举例说明

使用外部链接查询 LINK1 上的远程表进行查询

  SELECT * FROM SYSOBJECTS@LINK1;

或对远程表进行插入数据：

  INSERT INTO T1@LINK1 VALUES(1,2,3);

也可以查询本地表或其他链接的表对远程表进行操作，如

  UPDATE T1@LINK1 SET C1 = C1+1 WHERE C2 NOT IN (SELECT ID FROM LOCAL_TABLE);

  DELETE FROM T1@LINK1 WHERE C1 IN (SELECT ID FROM T2@LINK2);

使用外部链接，可以调用远程的存储过程或函数，使用中有以下约束：

参数数据类型为 SQL 类型，不允许为 DMSQL 程序类型；
参数数据类型不允许为复合类型。

其使用方式为：

  [CALL] [<模式名>.][<包名>.]<过程/函数名> [@] <外部链接名>(<参数列>);

使用限制

外部链接的使用有以下限制：

DM-DM 的同构外部链接不支持 MPP 环境，DM 与异构数据库的外部链接支持 MPP 环境；
增删改不支持 INTO 语句；
不支持使用游标进行增删改操作；
不支持操作远程表的复合类型列；
DBLINK 理论上不支持 LOB 类型列的操作，但支持简单的增删改语句中使用常量来对 LOB 类型列进行操作。
DBLINK 的本地库和远程库的大小写敏感参数 CASE_SENSITIVE 应保持一致，若不一致，应用需要保证 SQL 语句书写符合远程库的规范；
DBLINK 的本地库和远程库的字符集编码应一致，否则可能导致字符串操作出错；
DM-DM 类型的 DBLINK 暂不支持远程函数调用。

另外，DM 连接异构数据库的外部链接还有如下使用限制：

数据类型以 DM 为基础，不支持 DM 没有的数据类型；
语法以 DM 的语法为标准，不支持 DM 不兼容的语法；
主键更新，如果是涉及到多个服务器的语句，不能保证更新操作一定成功；
使用 CREATE VIEW view_name(view_col_name) AS SELECT ITEM FROM T@LINK 方式创建的查询远程对象的本地视图，对于异构库，不能保证操作一定成功。对于查询异构库远程对象的本地视图，最好采用 CREATE VIEW AS SELECT ITEM AS alias_name FROM T@LINK 方式创建。