PURGE

功能描述

使用PURGE语句可以实现如下功能:

  • 从回收站中清理表或索引,并释放对象相关的全部空间。
  • 清理回收站。
  • 清理回收站中指定表空间的对象。

注意事项

  • 清除(PURGE)操作支持:表(PURGE TABLE)、索引(PURGE INDEX)、回收站(PURGE RECYCLEBIN)。
  • 执行PURGE操作的权限要求如下:

  • PURGE TABLE:用户必须是表的所有者,且用户必须拥有表所在模式的USAGE权限,系统管理员默认拥有此权限。

  • PURGE INDEX:用户必须是索引的所有者,用户必须拥有索引所在模式的USAGE权限,系统管理员默认拥有此权限。
  • PURGE RECYCLEBIN:普通用户只能清理回收站中当前用户拥有的对象,且用户必须拥有对象所在模式的USAGE权限,系统管理员默认可以清理回收站所有对象。

语法格式

1. PURGE { TABLE [schema_name.]table_name
2. | INDEX index_name
3. | RECYCLEBIN
4. }

参数说明

  • [ schema_name. ]

模式名。 - TABLE [ schema_name. ] table_name

清空回收站中指定的表。 - INDEX index_name

清空回收站中指定的索引。 - RECYCLEBIN

清空回收站中的对象。

示例

1. -- 创建表空间reason_table_space
2. openGauss=#  CREATE TABLESPACE REASON_TABLE_SPACE1 owner tpcds RELATIVE location 'tablespace/tsp_reason1';
3. -- 在表空间创建表tpcds.reason_t1
4. openGauss=#  CREATE TABLE tpcds.reason_t1
5. (
6. r_reason_sk    integer,
7. r_reason_id    character(16),
8. r_reason_desc  character(100)
9. ) tablespace reason_table_space1;
10. -- 在表空间创建表tpcds.reason_t2
11. openGauss=#  CREATE TABLE tpcds.reason_t2
12. (
13. r_reason_sk    integer,
14. r_reason_id    character(16),
15. r_reason_desc  character(100)
16. ) tablespace reason_table_space1;
17. -- 在表空间创建表tpcds.reason_t3
18. openGauss=#  CREATE TABLE tpcds.reason_t3
19. (
20. r_reason_sk    integer,
21. r_reason_id    character(16),
22. r_reason_desc  character(100)
23. ) tablespace reason_table_space1;
24. -- 对表tpcds.reason_t1创建索引
25. openGauss=#  CREATE INDEX index_t1 on tpcds.reason_t1(r_reason_id);
26. openGauss=#  DROP TABLE tpcds.reason_t1;
27. openGauss=#  DROP TABLE tpcds.reason_t2;
28. openGauss=#  DROP TABLE tpcds.reason_t3;
29. --查看回收站
30. openGauss=#  SELECT rcyname,rcyoriginname,rcytablespace FROM GS_RECYCLEBIN;
31. rcyname        | rcyoriginname | rcytablespace
32. -----------------------+---------------+---------------
33. BIN$16409$2CEE988==$0 | reason_t1     |         16408
34. BIN$16412$2CF2188==$0 | reason_t2     |         16408
35. BIN$16415$2CF2EC8==$0 | reason_t3     |         16408
36. BIN$16418$2CF3EC8==$0 | index_t1     |             0
37. (4 rows)
38. --PURGE清除表
39. openGauss=#  PURGE TABLE tpcds.reason_t3;
40. openGauss=#  SELECT rcyname,rcyoriginname,rcytablespace FROM GS_RECYCLEBIN;
41. rcyname        | rcyoriginname | rcytablespace
42. -----------------------+---------------+---------------
43. BIN$16409$2CEE988==$0 | reason_t1     |         16408
44. BIN$16412$2CF2188==$0 | reason_t2     |         16408
45. BIN$16418$2CF3EC8==$0 | index_t1     |             0
46. (3 rows)
47. --PURGE清除索引
48. openGauss=#  PURGE INDEX tindex_t1;
49. openGauss=#  SELECT rcyname,rcyoriginname,rcytablespace FROM GS_RECYCLEBIN;
50. rcyname        | rcyoriginname | rcytablespace
51. -----------------------+---------------+---------------
52. BIN$16409$2CEE988==$0 | reason_t1     |         16408
53. BIN$16412$2CF2188==$0 | reason_t2     |         16408
54. (2 rows)
55. --PURGE清除回收站所有对象
56. openGauss=#  PURGE recyclebin;
57. openGauss=#  SELECT rcyname,rcyoriginname,rcytablespace FROM GS_RECYCLEBIN;
58. rcyname        | rcyoriginname | rcytablespace
59. -----------------------+---------------+---------------
60. (0 rows)