# CLEAN CONNECTION
#### 功能描述
清理数据库连接。允许清理指定数据库中指定用户的相关连接。
#### 注意事项
- 当前形态下不支持指定具体的节点（即不支持指定为TO COORDINATOR或TO NODE），仅支持指定为TO ALL。
- 仅在指定FORCE模式后，可以清理正在使用的正常连接。
 
#### 语法格式
```
CLEAN CONNECTION
      TO { COORDINATOR ( nodename [, ... ] ) | NODE ( nodename [, ... ] )| ALL [ CHECK ] [ FORCE ] }
      [ FOR DATABASE dbname ]
      [ TO USER username ];
```
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002764301478.png)
#### 参数说明
- **CHECK**
  主要用于DROP DATABASE操作之前的连接访问检查，若发现存在其他会话连接，则报错并终止删除操作。仅当节点列表为TO ALL时可以指定该参数，指定该参数后，会在清理连接之前检查数据库是否被其他会话连接访问。
  
- **FORCE**
  清理模式，指定该参数后，所有与指定数据库和指定用户相关的线程都将会收到SIGTERM信号，并且会被强制关闭。
  仅在节点列表指定为TO ALL时可以指定该参数。
  
- **COORDINATOR ( nodename \[, ... \] ) \| NODE ( nodename \[, ... \] ) \| ALL**
  节点列表，当前形态仅支持指定为TO ALL，且必须指定该参数。指定TO ALL后，指定数据库和指定用户相关的连接将被全部删除。
  
- **dbname**
  删除指定数据库上的连接。如果未指定，则默认删除所有数据库相关的连接。
  取值范围：已存在数据库名。
  
- **username**
  删除指定用户上的连接。如果未指定，则默认删除所有用户相关的连接。
  取值范围：已存在的用户。
  
 
#### 示例
```
--创建数据库test_clean_connection。
gaussdb=# CREATE DATABASE test_clean_connection;
--创建jack用户。
gaussdb=# CREATE USER jack PASSWORD '********';
--删除用户jack在数据库template1上的所有连接。
gaussdb=# CLEAN CONNECTION TO ALL FOR DATABASE template1 TO USER jack;
--删除用户jack的所有连接。
gaussdb=# CLEAN CONNECTION TO ALL TO USER jack;
--删除在数据库test_clean_connection上的所有连接。
gaussdb=# CLEAN CONNECTION TO ALL FORCE FOR DATABASE test_clean_connection;
--删除用户jack。
gaussdb=# DROP USER jack;
--删除数据库test_clean_connection。
gaussdb=# DROP DATABASE test_clean_connection;
```
