# DROP DATABASE LINK
#### 功能描述
删除一个DATABASE LINK对象。
#### 语法格式
```
DROP [ PUBLIC ] DATABASE LINK [ IF EXISTS ] dblink_name;
```
![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/figure/zh-cn_image_0000002793708127.png "点击放大")
#### 参数说明
- **dblink_name**
  连接对象的名称。
  
- **IF EXISTS**
  判断指定的DATABASE LINK是否存在。
  - 如果指定的DATABASE LINK存在，则删除成功。
  
  - 如果指定的DATABASE LINK不存在，不会进行删除操作，仅产生一个NOTICE提示，用于告知指定的DATABASE LINK不存在。
   
- **PUBLIC**
  连接类型，未指定PUBLIC时，默认为PRIVATE。
  
 
#### 示例
```
-- 创建一个兼容性为ORA的数据库。
gaussdb=# CREATE DATABASE ora_test_db DBCOMPATIBILITY 'ORA';
CREATE DATABASE
-- 切换数据库。
gaussdb=# \c ora_test_db
-- 创建拥有系统管理员权限的用户。
ora_test_db=# CREATE USER local_user WITH SYSADMIN PASSWORD '********';
CREATE ROLE
ora_test_db=# SET ROLE local_user PASSWORD '********';
SET
-- 创建私有DBLink，host也可以是IPv6地址。
ora_test_db=> CREATE DATABASE LINK private_dblink CONNECT TO 'remote_user' IDENTIFIED BY '********' USING (host '***.***.***.***',port '*****',dbname 'remote_db');
CREATE DATABASE LINK
-- 删除私有DBLink。
ora_test_db=> DROP DATABASE LINK private_dblink;
DROP DATABASE LINK
-- 创建公共DBLink，host也可以是IPv6地址。
ora_test_db=> CREATE PUBLIC DATABASE LINK public_dblink CONNECT TO 'remote_user' IDENTIFIED BY '********' USING (host '***.***.***.***',port '*****',dbname 'remote_db');
CREATE DATABASE LINK
-- 删除公共DBLink。
ora_test_db=> DROP PUBLIC DATABASE LINK public_dblink;
DROP DATABASE LINK
-- 删除创建出的用户。
ora_test_db=> RESET ROLE;
RESET
ora_test_db=# DROP USER local_user;
DROP ROLE
-- 切换回初始数据库，并删除测试数据库。请用真实的数据库名替换postgres。
ora_test_db=# \c postgres
gaussdb=# DROP DATABASE ora_test_db;
DROP DATABASE
```
#### 相关链接
[ALTER DATABASE LINK](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-0185.html)，[CREATE DATABASE LINK](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-0244.html)
