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

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 ];

参数说明

  • CHECK

    主要用于DROP DATABASE操作之前的连接访问检查,若发现存在其他会话连接,则报错并终止删除操作。仅当节点列表为TO ALL时可以指定该参数,指定该参数后,会在清理连接之前检查数据库是否被其他会话连接访问。

  • FORCE

    清理模式,指定该参数后,所有与指定数据库和指定用户相关的线程都将会收到SIGTERM信号,并且会被强制关闭。

    仅在节点列表指定为TO ALL时可以指定该参数。

  • COORDINATOR ( nodename [, ... ] ) | NODE ( nodename [, ... ] ) | ALL

    节点列表,当前形态仅支持指定为TO ALL,且必须指定该参数。指定TO ALL后,指定数据库和指定用户相关的连接将被全部删除。

  • dbname

    删除指定数据库上的连接。如果未指定,则默认删除所有数据库相关的连接。

    取值范围:已存在数据库名。

  • username

    删除指定用户上的连接。如果未指定,则默认删除所有用户相关的连接。

    取值范围:已存在的用户。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
--创建数据库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;

相关文档