更新时间:2026-10-21 GMT+08:00
分享

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' } [, ...]) ];

参数说明

  • 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

相关文档