CLEAN CONNECTION

功能描述

用来清理数据库连接。允许在节点上清理指定数据库的指定用户的相关连接。

注意事项

  • openGauss下不支持指定节点，仅支持TO ALL。

  • 该功能仅在force模式下，可以清理正在使用的正常连接。

语法格式

  1. CLEAN CONNECTION
  2.       TO { COORDINATOR ( nodename [, ... ] ) | NODE ( nodename [, ... ] )| ALL [ CHECK ] [ FORCE ] }
  3.       [ FOR DATABASE dbname ]
  4.       [ TO USER username ];

参数说明

  • CHECK

    仅在节点列表为TO ALL时可以指定。如果指定该参数，会在清理连接之前检查数据库是否被其他会话连接访问。此参数主要用于DROP DATABASE之前的连接访问检查，如果发现有其他会话连接，则将报错并停止删除数据库。

  • FORCE

    仅在节点列表为TO ALL时可以指定，如果指定该参数，所有和指定dbname和username相关的线程都会收到SIGTERM信号，然后被强制关闭。

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

    删除指定节点上的连接。有三种场景：

    • 删除指定CN上的连接，openGauss不支持。
    • 删除指定DN上的连接，openGauss不支持。
    • 删除所有节点上的连接(TO ALL)，openGauss仅支持该场景。

  • dbname

    删除指定数据库上的连接。如果不指定，则删除所有数据库的连接。

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

  • username

    删除指定用户上的连接。如果不指定，则删除所有用户的连接。

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

示例

  1. --创建jack用户。
  2. CREATE USER jack PASSWORD 'Bigdata123@';
  4. --删除用户jack在数据库template1上的所有连接。
  5. CLEAN CONNECTION TO ALL FOR DATABASE template1 TO USER jack;
  7. --删除用户jack的所有连接。
  8. CLEAN CONNECTION TO ALL TO USER jack;
  10. --删除在数据库gaussdb上的所有连接。
  11. CLEAN CONNECTION TO ALL FORCE FOR DATABASE gaussdb;
  13. --删除用户jack。
  14. DROP USER jack;