# ALTER DATABASE LINK
#### 功能描述
修改DATABASE LINK对象。
#### 注意事项
- DATABASE LINK详细说明，请参见《开发指南》中"特性使用指导 \> DATABASE LINK"章节。
- 当DATABASE LINK连接的数据库为GaussDB数据库时，目前仅支持修改DATABASE LINK对象的用户名称和密码。
 
#### 语法格式
```
ALTER [PUBLIC] DATABASE LINK dblink_name
    [CONNECT TO 'user_name' IDENTIFIED BY 'password'] [ USING ( { option 'value' } [, ...]) ];
```
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002793699501.png)
#### 参数说明
- **dblink** **_** **name**
  待进行修改具体属性的指定DATABASE LINK对象的连接名称。
  
- **user** _**name**
  远程被连接数据库用户名。
  
- **password**
  远程被连接数据库用户密码。
  
- **PUBLIC**
  连接类型，未指定PUBLIC时，默认为PRIVATE。
  
- **USING ( { option 'value' } \[, ... \] )**
  当DATABASE LINK连接的数据库为Oracle数据库时，通过USING子句可以修改以下option：
  - isolation_level：指定通过DBLink开启Oracle数据库事务的隔离级别，默认为serializable，可选项有serializable、read_committed、read_only。
  
  - max_long：指定远程数据库表中long、long raw类型的列最大长度，取值范围为\[1, 1073741823\]。当前该参数为预置参数，暂不生效。
  
  - strip_zeros：对于ASCII编码字符串中的0字符的处理行为，如果设置为yes/on/true，0字符则会删除。
  
  - prefetch：连接的远程数据库Scan时每次fetch的数据行数，取值范围为\[1, 1000\]，默认值为50。
  
  - lob_prefetch：连接的远程数据库Scan时lob类型每次fetch的字节大小，取值范围为\[0, 536870912\]，默认值为1048576。当前该参数为预置参数，暂不生效。
  
  - time_out：指定连接执行超时时间，取值范围为\[0, 2147483647\]。默认值为0，表示不指定连接执行超时时间，即不会超时。
   
 
#### 示例
```
-- 前置条件。
gaussdb=# CREATE USER local_user WITH SYSADMIN PASSWORD '********';
CREATE ROLE
gaussdb=# SET ROLE local_user PASSWORD '********';
SET
-- 创建公共DBLink。
gaussdb=# CREATE PUBLIC DATABASE LINK public_dblink CONNECT TO 'local_user' IDENTIFIED BY '********' USING (host '***.***.***.***',port '*****',dbname 'remote_db');
CREATE DATABASE LINK
-- 创建普通用户。
gaussdb=# CREATE USER remote_user PASSWORD '********';
CREATE ROLE
-- 修改DBLink对象信息。
gaussdb=# ALTER PUBLIC DATABASE LINK public_dblink CONNECT TO 'remote_user' IDENTIFIED BY '********';
ALTER DATABASE LINK
-- 删除公共DBLink。
gaussdb=# DROP PUBLIC DATABASE LINK public_dblink;
DROP DATABASE LINK
-- 创建连接到Oracle数据库的公共DBLink。
gaussdb=# CREATE PUBLIC DATABASE LINK dblink CONNECT TO 'oracle_user' IDENTIFIED BY '********' OCI USING (dbserver  '***.***.***.***:****/orcl', case_insensitive 'on');
CREATE DATABASE LINK
-- 修改DBLink参数选项。
gaussdb=# ALTER PUBLIC DATABASE LINK dblink CONNECT TO 'oracle_user' IDENTIFIED BY '********'USING (time_out '0');
ALTER DATABASE LINK
-- 删除连接到Oracle数据库的公共DBLink。
gaussdb=# DROP PUBLIC DATABASE LINK dblink;
DROP DATABASE LINK
-- 清理环境。
gaussdb=# RESET ROLE;
RESET
gaussdb=# DROP USER local_user;
DROP ROLE
gaussdb=# DROP USER remote_user;
DROP ROLE
```
#### 相关链接
[CREATE DATABASE LINK](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0248.html)，[DROP DATABASE LINK](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0305.html)
