Updated on 2024-09-02 GMT+08:00

DISCARD

Function

Releases internal resources related to database sessions. The DISCARD command is used to reset the status of some or all sessions. Different DISCARD clauses release different types of resources. The DISCARD ALL command releases all temporary resources related to the current session and resets them to the initial state.

Precautions

None

Syntax

1
2
3
DISCARD 
        { VOLATILE { TEMPORARY | TEMP } }  |
        { ALL | TEMP | TEMPORARY | PLANS | SEQUENCES } }

Parameter Description

  • VOLATILE { TEMPORARY | TEMP }

    Releases resources related to the VOLATILE temporary table in the current session.

    After the DISCARD VOLATILE { TEMPORARY | TEMP } statement is executed, all volatile temporary table resources in the current session will be cleared. However, the statement cannot clear a single volatile temporary table resource.

  • TEMP | TEMPORARY

    Releases resources related to all temporary tables in the current session, including volatile and global temporary tables.

  • PLANS

    Releases all cached query plans in the current session and forces them to be replanned when related PREPARE statements are used next time.

  • SEQUENCES

    Discards all cached sequence-related states, including currval()/lastval() information and any pre-allocated sequence values that have not been returned through nextval().

  • ALL

    Releases all temporary resources related to the current session and resets them to their initial state. This has almost the same effect as executing the following statement sequence:

    SET SESSION AUTHORIZATION DEFAULT; 
    RESET ALL; 
    DEALLOCATE ALL; 
    CLOSE ALL; 
    UNLISTEN *; 
    SELECT pg_advisory_unlock_all(); 
    DISCARD PLANS; DISCARD SEQUENCES; 
    DISCARD TEMP;
    • After DISCARD ALL is executed successfully, schemas starting with pg_temp and pg_toast_temp are also deleted.
    • DISCARD ALL cannot be executed in a transaction.

Examples

  • DISCARD VOLATILE temporary table.

    After the DISCARD operation is performed, all resources related to volatile temporary tables in the current session are cleared.

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    CREATE VOLATILE TEMP TABLE TX1(A INT) DISTRIBUTE BY HASH(A);
    CREATE TABLE
    CREATE VOLATILE TEMP TABLE TX2(A INT) DISTRIBUTE BY HASH(A);
    CREATE TABLE
    
    SELECT * FROM TX1;
     a
    ---
    (0 rows)
    SELECT * FROM TX2;
     a
    ---
    (0 rows)
    
    DISCARD VOLATILE TEMP;
    
    SELECT * FROM TX1;
    ERROR:  relation "tx1" does not exist
    LINE 1: SELECT * FROM TX1;
                          ^
    SELECT * FROM TX2;
    ERROR:  relation "tx2" does not exist
    LINE 1: SELECT * FROM TX2;
    
  • DISCARD TEMP
    After DISCARD TEMP is run, all temporary table resources in the current session are cleared.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    CREATE GLOBAL TEMP TABLE t_global_temp(a int,b int);
    NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using round-robin as the distribution mode by default.
    HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
    CREATE TABLE
    INSERT INTO t_global_temp VALUES(1,1),(2,2);
    INSERT 0 2
    
    CREATE VOLATILE TEMP TABLE t_volatile_temp(a int,b int);
    CREATE TEMP TABLE t_temp(a int,b int);
    
    DISCARD TEMP;
    
    SELECT * FROM t_global_temp;
     a | b
    ---+---
    (0 rows)
    
    SELECT * FROM t_volatile_temp;
    ERROR:  relation "t_volatile_temp" does not exist
    LINE 1: select * from t_volatile_temp;
    
    SELECT * FROM t_temp;
    ERROR:  relation "t_temp" does not exist
    LINE 1: select * from t_temp;