Updated on 2024-05-07 GMT+08:00

CLEAN CONNECTION

Function

Clears database connections. You may use this statement to delete a specific user's connections to a specified database.

Precautions

  • GaussDB does not support specified nodes and supports only TO ALL.
  • This function can be used to clear the normal connections that are being used only in fore mode.

Syntax

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

Parameter Description

  • CHECK

    This parameter can be specified only when the node list is specified as TO ALL. Setting this parameter will check whether a database is accessed by other sessions before its connections are cleared. If any sessions are detected before DROP DATABASE is executed, an error will be reported and the database will not be deleted.

  • FORCE

    This parameter can be specified only when the node list is specified as TO ALL. Setting this parameter will send SIGTERM signals to all the threads related to the specified dbname and username and forcibly shut them down.

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

    Only TO ALL is supported. This parameter must be specified. All specified connections on the node will be deleted.

  • dbname

    Deletes connections to a specified database. If this parameter is not specified, connections to all databases will be deleted.

    Value range: an existing database name

  • username

    Deletes connections of a specific user. If this parameter is not specified, connections of all users will be deleted.

    Value range: an existing username

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
-- Create user jack.
CREATE USER jack PASSWORD '********';

-- Clean the user jack's connections to the template1 database.
CLEAN CONNECTION TO ALL FOR DATABASE template1 TO USER jack;

-- Delete all connections of user jack.
CLEAN CONNECTION TO ALL TO USER jack;

-- Clean all the connections to the gaussdb database.
CLEAN CONNECTION TO ALL FORCE FOR DATABASE gaussdb;

-- Delete user jack.
DROP USER jack;