# CREATE DATABASE LINK
#### 功能描述
创建DATABASE LINK对象。
#### 注意事项
- DATABASE LINK详细说明请参见《开发指南》中"特性使用指导 \> DATABASE LINK"章节。
- DATABASE LINK特性只能在A兼容模式数据库下使用。
- 禁止通过使用DATABASE LINK的方式连接初始用户，禁止初始用户创建、修改和删除DATABASE LINK对象。
- 创建DATABASE LINK对象时，不会对其是否可连接成功进行验证，如果创建过程中缺乏相关关键字，可能会在使用时报错。
- 升级未提交情况下无法创建使用DATABASE LINK。
- 连接GaussDB时，使用localhost、127.0.0.1或本机IP及对应端口可连接当前实例数据库。
 
#### 语法格式
```
CREATE [ PUBLIC ] DATABASE LINK dblink [ CONNECT TO { CURRENT_USER | 'user' IDENTIFIED BY 'password' } ] [name] [ USING ( {option 'value'} [, ...]) ];
```
当name为空时，连接GaussDB数据库option如下：
```
{ HOST | PORT | DBNAME | FETCH_SIZE }
```
当name为OCI时，连接Oracle数据库option如下：
```
{ DBSERVER | ISOLATION_LEVEL | MAX_LONG | STRIP_ZEROS | PREFETCH | LOB_PREFETCH | TIME_OUT | CASE_INSENSITIVE }
```
#### 参数说明
- **PUBLIC**
  指定创建对所有用户可见的公共数据库连接。如果未指定，则为私有的数据库连接，仅对当前用户可用。
  
- **dblink**
  创建的DATABASE LINK的名称。
  
- **user**
  创建的DATABASE LINK连接远程数据库使用的用户名。
  
- **password**
  创建的DATABASE LINK连接远程数据库使用的用户对应的密码。
  
- **CURRENT_USER**
  使用当前数据库初始用户名和空密码连接。
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  当前版本指定CURRENT_USER选项后，可正常创建DATABASE LINK，但该连接无法正常使用。
  
- **name**
  当前只支持OCI字符串或省略。指定OCI，则创建连接Oracle数据库；省略则创建连接GaussDB数据库。
  
- **USING ( {option 'value'} \[, ... \] )**
  可选，USING可选择指定要连接的数据库的IP地址、端口号、远程数据库名称等参数。
  连接GaussDB支持的options包括：
  - host：指定连接的数据库IP地址，不指定时默认为空。可以指定多个IP地址，以逗号（,）进行分隔，当前不支持密态数据库。
  
  - port：指定连接的端口号，不指定时默认为5432。
  
  - dbname：指定连接的数据库名称，不指定时默认为连接远程使用的用户名。
  
  - fetch_size：从远程每次获取数据量大小，取值范围\[0, 2147483647\]，默认值为100。
  
  
  连接Oracle数据库支持的options包括：
  - dbserver：指定连接Oracle数据库的实例信息，一般格式为\[ip\]:端口/实例名，当地址为IPv4地址时可省略"\[\]"符号，当地址为IPv6地址时不可省略"\[\]"符号。如果要使用SSL进行连接，需要指定TNS节点名，具体信息及须知请参见[CREATE DATABASE LINK](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0248.html)章节中的[SSL连接说明]。
  
  - isolation_level：指定通过DBLink开启Oracle数据库事务的隔离级别，默认为serializable，可选项有serializable、read_committed、read_only。
  
  - max_long：指定远程数据库表中long、long raw类型的列的最大长度，取值范围\[1, 1073741823\]。当前该参数为预置参数，暂不生效。
  
  - strip_zeros：连接远程数据库时，如果设置为yes/on/true，则会将字符串中的ASCII 0字符删除。
  
  - prefetch：连接远程数据库Scan时每次fetch的数据行数，取值范围\[1, 1000\]，默认值为50。
  
  - lob_prefetch：连接远程数据库Scan时lob类型每次fetch的字节大小，取值范围\[0, 536870912\]，默认值为1048576。当前该参数为预置参数，暂不生效。
  
  - time_out：连接远程数据库的执行超时时间，取值范围\[0, 2147483647\]。默认值为0，表示不会超时。
  
  - case_insensitive：指定连接远程数据库时大小写敏感开关，默认为off。使用DBLink查询Oracle数据库的表名、Schema名及列名时遵循如下规则：
    - 选项设置为on时：
      - DBLink会默认将表名及Schema名转为大写处理，查询时无需显式指定查询大写表名，默认查询远程数据库名称为大写的表及Schema。
      
      - 列名在本地数据库默认转成小写存储，无法使用双引号大写列名查询。
      
      - 无法查询远程数据库创建的小写及大小写混用的表名、Schema名及列名。
       
    
    - 选项设置为off时：
      - 大写表名、Schema名及列名，DBLink查询时需要使用双引号加大写查询。
      
      - 大小写混用的表名、Schema名及列名，DBLink查询时需要使用双引号加大小写混用查询。
      
      - 小写的表名、Schema名及列名，DBLink查询时可使用不带引号的默认查询或使用双引号加小写查询。
       
     
  
  
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  连接Oracle数据库使用SSL连接参考配置方法：
  1. GaussDB端客户自行安装的OCI客户端，sqlnet.ora中配置wallet路径及SSL相关属性，wallet路径为证书位置。具体格式如下：
     ```
     WALLET_LOCATION =
     (SOURCE =
     (METHOD = FILE)
     (METHOD_DATA =
     (DIRECTORY = /home/instantclient/wallet)
     )
     )
     -- 新增TCPS选项
     SQLNET.AUTHENTICATION_SERVICES= (TCPS, NTS, BEQ)
     SSL_CLIENT_AUTHENTICATION = TRUE
     SSL_CIPHER_SUITES = (SSL_RSA_WITH_AES_256_CBC_SHA, SSL_RSA_WITH_3DES_EDE_CBC_SHA)
     ```
     
  
  2. 在tnsnames.ora中配置TNS，与服务端TCPS协议对应的TNS一致。具体格式如下：
     ```
     ORA_SSL =
     (DESCRIPTION =
     (ADDRESS = (PROTOCOL = TCPS)(HOST = xxxx)(PORT = xxxx))
     (CONNECT_DATA =
     (SERVER = DEDICATED)
     (SERVICE_NAME = ORA)
     )
     )
     ```
     
  
  3. 创建DATABASE LINK时，DBSERVER选项指定配置的TNS名，对应[上一步]中的ORA_SSL。
  
  4. 连接Oracle数据库。 若首次连接Oracle数据库时，需保证tnsnames.ora文件存在。若tnsnames.ora文件不存在则需要正确配置并重启GaussDB数据库后才可正常使用DATABASE LINK连接。
     
    
 
#### 示例
```
-- 前置条件。
gaussdb=#  CREATE USER local_user WITH SYSADMIN PASSWORD '********';
CREATE ROLE
gaussdb=#  SET ROLE local_user PASSWORD '********';
SET
-- 创建私有DBLink，host也可以是IPv6地址。
gaussdb=#  CREATE DATABASE LINK private_dblink CONNECT TO 'remote_user' IDENTIFIED BY '********' USING (host '***.***.***.***',port '*****',dbname 'remote_db');
CREATE DATABASE LINK
-- 创建公共DBLink，host也可以是IPv6地址。
gaussdb=#  CREATE PUBLIC DATABASE LINK public_dblink CONNECT TO 'remote_user' IDENTIFIED BY '********' USING (host '***.***.***.***',port '*****',dbname 'remote_db');
CREATE DATABASE LINK
-- 创建公共连接Oracle库的DBLink。
gaussdb=#  CREATE PUBLIC DATABASE LINK public_dblink_to_o CONNECT TO 'oracle_user' IDENTIFIED BY '********' OCI USING (dbserver '***.***.***.***/orcl', prefetch '100');
CREATE DATABASE LINK
-- 创建使用SSL连接Oracle库的DBLink。
gaussdb=#  CREATE PUBLIC DATABASE LINK public_dblink_SSL CONNECT TO 'oracle_user' IDENTIFIED BY '********' OCI USING (dbserver 'ORA_SSL');
CREATE DATABASE LINK
-- 清理环境。
gaussdb=#  DROP PUBLIC DATABASE LINK private_dblink;
DROP DATABASE LINK
gaussdb=#  DROP PUBLIC DATABASE LINK public_dblink;
DROP DATABASE LINK
gaussdb=#  DROP PUBLIC DATABASE LINK public_dblink_to_o;
DROP DATABASE LINK
gaussdb=# DROP PUBLIC DATABASE LINK public_dblink_SSL;
DROP DATABASE LINK
gaussdb=#  RESET ROLE;
RESET
gaussdb=#  DROP USER local_user;
DROP ROLE
```
#### 相关链接
[ALTER DATABASE LINK](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0185.html)，[DROP DATABASE LINK](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0305.html)
