
# ALTER TABLE PARTITION
#### 功能描述
修改表分区，包括增加/删除分区、切割/合并分区、清空分区、移动分区表空间、交换分区、重命名分区，以及修改分区属性等。
#### 注意事项
- 只有分区表的所有者或者被授予了分区表ALTER权限的用户有权限执行ALTER TABLE PARTITION命令，当三权分立开关关闭时，系统管理员默认拥有此权限。
- 添加分区的表空间不能是PG_GLOBAL。
- 添加分区的名称不能与该分区表已有分区的名称相同。
- 添加分区的分区键值要和分区表的分区键类型一致。
- 若添加RANGE分区，添加分区键值要大于分区表中最后一个范围分区的上边界。
- 若添加LIST分区，添加分区键值不能与现有分区键值重复。
- 不支持添加哈希分区。
- 如果目标分区表中已有分区数达到了最大值1048575，则不能继续添加分区。
- 当分区表只有一个分区时，不能删除该分区。
- 选择分区使用PARTITION FOR()，括号里指定值个数应该与定义分区时使用的列个数相同，并且一一对应。
- Value分区表不支持Alter Partition操作。
- 哈希分区表不支持切割分区，不支持合并分区，不支持添加/删除分区。
- 删除、切割、合并、清空、交换分区的操作会使Global索引失效，可以申明UPDATE GLOBAL INDEX子句同步更新索引。
- 如果删除、切割、合并、清空、交换分区操作不申明UPDATE GLOBAL INDEX子句，并发的DML业务有可能因为索引不可用而报错。
- 删除、切割、合并、清空、交换分区的操作会使分区表上的全局二级索引失效，对于交换分区，同时也会失效普通表上的所有全局二级索引，可以申明UPDATE DISTRIBUTED GLOBAL INDEX子句同步更新索引。
- 如果删除、切割、合并、清空、交换分区操作不申明UPDATE DISTRIBUTED GLOBAL INDEX子句，并发的DML业务有可能因为索引不可用而报错。
- 若设置参数enable_gpi_auto_update为on，即使不申明UPDATE GLOBAL INDEX子句，也会自动更新Global索引。
- 在为数据对象增加或者变更ILM策略的时候，如果追加了行级表达式，需要注意行表达式目前只支持白名单中列出的函数。具体白名单函数列表参考[行表达式函数白名单](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0710.html#ZH-CN_TOPIC_0000002559105985)。
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  在ILM策略的ON(EXPR)行级表达式支持的函数中，有部分函数的输出可能会受兼容性参数影响。例如，upper函数在MYSQL兼容模式下设置b_format_version='5.7'和b_format_dev_version='s2'后，将无法转大写。
  
 
#### 语法格式
修改分区表分区包括修改表分区主语法、修改表分区名称的语法和重置分区ID的语法。
- 修改表分区主语法。
  ```
  ALTER TABLE [ IF EXISTS ] { table_name  [*] | ONLY table_name | ONLY ( table_name  )}
      action [, ... ];
  ```
  其中action统指如下分区维护子语法。当存在多个分区维护子句时，保证了分区的连续性，无论这些子句的排序如何，GaussDB总会先执行DROP PARTITION再执行ADD PARTITION操作，最后顺序执行其它分区维护操作。
  ```
  move_clause  |
      exchange_clause  |
      row_clause  |
      merge_clause  |
      modify_clause  |
      split_clause  |
      add_clause  |
      drop_clause  |
      truncate_clause  |
      ilm_clause
  ```
  - move_clause子语法用于移动分区到新的表空间。
    ```
    MOVE PARTITION { partion_name | FOR ( partition_value [, ...] ) } TABLESPACE tablespacename
    ```
    
  
  - exchange_clause子语法用于把普通表的数据迁移到指定的分区。
    ```
    EXCHANGE PARTITION { ( partition_name ) | partition_name | FOR ( partition_value [, ...] ) } 
        WITH TABLE {[ ONLY ] ordinary_table_name | ordinary_table_name * | ONLY ( ordinary_table_name )} 
        [ { WITH | WITHOUT } VALIDATION ] [ VERBOSE ] [ UPDATE GLOBAL INDEX ] [ UPDATE DISTRIBUTED GLOBAL INDEX | NO UPDATE DISTRIBUTED GLOBAL INDEX ]
    ```
    进行交换的普通表和分区必须满足如下条件：
    - 普通表和分区的列数相同，对应列的信息严格一致，包括：列名、列的数据类型、列约束、列的Collation信息、列的存储参数、列的压缩信息等。
    
    - 普通表和分区的表压缩信息严格一致。
    
    - 普通表和分区的分布列信息严格一致。
    
    - 普通表索引和分区Local索引个数相同，且对应索引的信息严格一致。
    
    - 普通表和分区的表约束个数相同，且对应表约束的信息严格一致。
    
    - 普通表不可以是临时表，分区表只能是范围分区表，列表分区表，哈希分区表或间隔分区表。
    
    - 在内置安全策略开关开启的情况下，普通表和分区表上不可以有动态数据脱敏，行访问控制约束。
    
    
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - 完成交换后，普通表和分区的数据被置换，同时普通表和分区的表空间信息被置换。此时，普通表和分区的统计信息变得不可靠，需要对普通表和分区重新执行analyze。
    
    - 由于非分区键不能建立本地唯一索引，只能建立全局唯一索引，所以如果普通表含有唯一索引时，可能会导致无法交换数据。 如果需要进行数据交换操作，可以通过创建中间表的方式，先将分区数据插入到中间表，truncate分区，普通表数据插入分区表，drop普通表，重命名中间表的方式完成数据交换操作。
      
    
    - 对于普通表和分区表都是Ustore的场景，如果普通表的Ubtree索引类型（RCR或者PCR，默认为RCR）和分区表本地的Ubtree索引类型（RCR或PCR，默认为RCR）不一致，会导致无法完成数据交换的操作。
    
    - 如果在普通表/分区表上进行了DROP COLUMN操作，被删除的列依然物理存在，则需要保证普通表和分区的被删除列严格对齐才能交换成功。
    
    - EXCHANGE PARTITION { ( partition_name ) \| partition_name \| FOR ( partition_value \[, ... \] ) }操作在MYSQL模式数据库（即sql_compatibility = 'MYSQL'）下可用，其他模式下仅EXCHANGE PARTITION { ( partition_name ) \| FOR ( partition_value \[, ... \] ) }可用。当partition_name为一级分区名时，进行交换的是一级分区和普通表。
      
  
  - row_clause子语法用于设置分区表的行迁移开关。
    ```
    { ENABLE | DISABLE } ROW MOVEMENT
    ```
    
  
  
  
  - merge_clause子语法用于把多个分区合并成一个分区。一个命令中合并的源分区上限为300。
    ```
    MERGE PARTITIONS { partition_name } [, ...] INTO PARTITION partition_name 
        [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )] ] [ TABLESPACE tablespacename ] [ UPDATE GLOBAL INDEX ] [ UPDATE DISTRIBUTED GLOBAL INDEX | NO UPDATE DISTRIBUTED GLOBAL INDEX ]
    ```
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - 对于范围分区/间隔分区，MERGE分区要求源分区的范围连续递增，且MERGE后的分区名可以与最后一个源分区名相同；对于列表分区，则源分区无顺序要求，且MERGE后的分区名可以与任一源分区名相同。如果MERGE后的分区名与源分区名相同，视为同一个分区。
    
    - 未打开guc参数enable_ilm的情况下，如果使用merge_clause子语法把多个带有ilm policy的分区合并成一个分区，新分区不继承ilm policy。
     
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/caution_3.0-zh-cn.png)
    USTORE存储引擎表不支持在事务块/存储过程中执行ALTER TABLE MERGE PARTITIONS的操作。
    
  
  - modify_clause子语法用于设置分区索引是否可用。
    ```
    MODIFY PARTITION partition_name { UNUSABLE LOCAL INDEXES | REBUILD UNUSABLE LOCAL INDEXES }
    ```
    
  
  
  
  - split_clause子语法用于把一个分区切割成多个分区。
    ```
    SPLIT PARTITION { partition_name | FOR ( partition_value [, ...] ) } { split_point_clause | no_split_point_clause } [ UPDATE GLOBAL INDEX ] [ UPDATE DISTRIBUTED GLOBAL INDEX | NO UPDATE DISTRIBUTED GLOBAL INDEX ]
    ```
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - SPLIT后的分区名可以与源分区名相同，将视为不同的分区。
    
    - 未打开guc参数enable_ilm的情况下，如果使用split_clause子语法把一个带有ilm policy的分区分割成多个分区，新分区不继承ilm policy。
     
    - 范围分区表指定切割点split_point_clause的语法为：
      ```
      AT ( partition_value ) INTO ( PARTITION partition_name [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )] ] [ TABLESPACE tablespacename ] , PARTITION partition_name [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )] ] [ TABLESPACE tablespacename ] )
      ```
      ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
      切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。
      
    
    - 范围分区表不指定切割点no_split_point_clause的语法为：
      ```
      INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) }
      ```
      ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
      - 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键。
      
      - 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在）必须等于正在被切割的分区的前一个分区（如果存在）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在）必须等于正在被切割的分区的分区键。
      
      - partition_less_than_item支持的分区键个数最多为16，而partition_start_end_item仅支持1个分区键，其支持的数据类型参见[PARTITION BY RANGE(partition_key)](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0570.html#ZH-CN_TOPIC_0000002559105915__zh-cn_topic_0000002527056190_zh-cn_topic_0059777586_l00efc30fe63048ffa2ef68c5b18bb455)。
      
      - 在同一语句中partition_less_than_item和partition_start_end_item两者不可同时使用；不同split语句之间没有限制。
        
    
    
    
    - 分区项partition_less_than_item的语法为如下，其中最后一个分区可以不写分区范围定义，即VALUES LESS THAN (partition_value)部分，默认继承源分区范围定义的上界值。
      ```
      PARTITION partition_name VALUES LESS THAN {( { partition_value | MAXVALUE }  [, ...] ) | MAXVALUE }
          [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )] ] [ TABLESPACE tablespacename ]
      ```
      ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
      RANGE分区时支持MAXVALUE关键字不带括号，只能支持MYSQL模式使用，不支持在二级分区的子分区中使用，不支持在分区字段为多列的场景使用。
      
    
    - 分区项partition_start_end_item的语法为，其约束参见[START END语法描述](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0570.html#ZH-CN_TOPIC_0000002559105915__zh-cn_topic_0000002527056190_li2094151861116)。
      ```
      PARTITION partition_name {
              {START(partition_value) END (partition_value) EVERY (interval_value)} |
              {START(partition_value) END ({partition_value | MAXVALUE})} |
              {START(partition_value)} |
              {END({partition_value | MAXVALUE})}
      } [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )] ] [TABLESPACE tablespace_name]
      ```
      
    
    - 列表分区表指定切割点split_point_clause的语法如下：
      ```
      VALUES ( partition_value_list ) INTO ( PARTITION partition_name [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )]] [ TABLESPACE tablespacename ] , PARTITION partition_name [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )]] [ TABLESPACE tablespacename ] )
      ```
      ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
      切割点必须是源分区的一个非空真子集，指定切割点的方式只能把一个分区切割成两个新分区。
      
    
    - 列表分区表不指定切割点no_split_point_clause的语法如下：
      ```
      INTO ( PARTITION partition_name VALUES (partition_value_list) [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )]] [ TABLESPACE tablespacename ][, ...] )
      ```
      ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
      - 其中最后一个分区不能写分区范围定义，即VALUES (partition_value_list)部分，其范围等于源分区去掉其他子分区后的剩余集合。
      
      - 不指定切割点的方式，每一个新分区都必须是源分区的一个非空真子集，且互不交叉。
        
     
  
  
  
  - add_clause子语法用于为指定的分区表添加一个或多个分区。
    ```
    ADD {{partition_less_than_item | partition_start_end_item} |
         PARTITION({partition_less_than_item | partition_start_end_item | partition_list_item})}
    ```
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - PARTITION({partition_less_than_item \| partition_start_end_item \| partition_list_item})语法只支持MYSQL模式下使用。
    
    - 不支持ALTER TABLE table_name ADD PARTITION (partition_definition1, partition_definition2,...);语法添加多分区。仅支持原有添加多分区语法：ALTER TABLE table_name ADD PARTITION (partition_definition1), ADD PARTITION (partition_definition2), ...。
     
    分区项partition_list_item的语法为：
    ```
    PARTITION partition_name VALUES [IN] (list_values_clause) 
        [ ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR )] ] [ TABLESPACE tablespacename ]
    ```
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - partition_list_item支持最多16个分区键，其支持的数据类型参见[PARTITION BY LIST \[COLUMNS\] (partition_key)](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0570.html#ZH-CN_TOPIC_0000002559105915__zh-cn_topic_0000002527056190_li78182216171)。
    
    
    
    - 哈希分区表不支持添加分区。
    
    - IN需要在MYSQL模式下使用，不支持在二级分区的子分区中使用。
      
   
  - drop_clause子语法用于删除分区表中的指定分区。
    ```
    DROP PARTITION  { partition_name | FOR (  partition_value [, ...] )  } [ UPDATE GLOBAL INDEX ] [ UPDATE DISTRIBUTED GLOBAL INDEX | NO UPDATE DISTRIBUTED GLOBAL INDEX ]
    ```
    ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - 哈希分区表不支持删除分区。
    
    - 当分区表只有一个分区时，不能删除该分区。
      
  
  - truncate_clause子语法用于清空分区表中的指定分区。
    ```
    TRUNCATE PARTITION  { partition_name | FOR (  partition_value [, ...] )  } [ UPDATE GLOBAL INDEX ] [ UPDATE DISTRIBUTED GLOBAL INDEX | NO UPDATE DISTRIBUTED GLOBAL INDEX ]
    ```
    
  
  - ilm_clause子语法用于为分区添加ILM策略，为数据生命周期管理-OLTP表压缩特性支持语法。
    ```
    MODIFY PARTITION partition_name ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW AFTER n { day | month | year } OF NO MODIFICATION [ ON ( EXPR ) ]
    ```
    
   
- 修改表分区名称的语法。
  ```
  ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name  )}
      RENAME PARTITION { partion_name | FOR ( partition_value [, ...] ) } TO partition_new_name;
  ```
  
- 重置分区ID的语法。
  ```
  ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name  )} RESET PARTITION;
  ```
  
 
#### 参数说明
- **table_name**
  分区表名。
  取值范围：已存在的分区表名。
  
- **partition_name**
  分区名。
  取值范围：已存在的分区名。
  
- **tablespacename**
  指定分区要移动到哪一个表空间。
  取值范围：已存在的表空间名。
  
- **partition_value**
  分区键值。
  通过PARTITION FOR ( partition_value \[, ...\] )子句指定的这一组值，可以唯一确定一个分区。
  取值范围：需要进行操作的分区的分区键的取值范围。
  
- **UNUSABLE LOCAL INDEXES**
  设置该分区上的所有索引不可用。
  
- **REBUILD UNUSABLE LOCAL INDEXES**
  重建该分区上的所有索引。
  
- **{ ENABLE \| DISABLE } ROW MOVEMET**
  行迁移开关。
  如果进行UPDATE操作时，更新了元组在分区键上的值，造成了该元组所在分区发生变化，就会根据该开关给出报错信息，或者进行元组在分区间的转移。
  取值范围：
  - ENABLE：打开行迁移开关。
  
  - DISABLE：关闭行迁移开关。
  
  
  默认是关闭状态。
  
- **ordinary_table_name**
  进行迁移的普通表的名称。
  取值范围：已存在的普通表名。
  
- **{ WITH \| WITHOUT } VALIDATION**
  在进行数据迁移时，是否检查普通表中的数据满足指定分区的分区键范围。
  取值范围：
  - WITH：对于普通表中的数据要检查是否满足分区的分区键范围，如果有数据不满足，则报错。
  
  - WITHOUT：对于普通表中的数据不检查是否满足分区的分区键范围。
  
  
  默认是WITH状态。
  由于检查比较耗时，特别是当数据量很大的情况下。所以在保证当前普通表中的数据满足分区的分区键范围时，可以加上WITHOUT来指明不进行检查。
  
- **VERBOSE**
  在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  只有在VALIDATION是WITH状态时，才可以指定VERBOSE。
  
- **partition_new_name**
  分区的新名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0322.html#ZH-CN_TOPIC_0000002559105775__zh-cn_topic_0000002558056023_section14873217506)。
  
- **UPDATE GLOBAL INDEX**
  如果使用该参数，则会更新分区表上的所有全局索引，以确保使用全局索引可以查询出正确的数据。
  如果不使用该参数，则分区表上的所有全局索引将会失效。
  
- **UPDATE DISTRIBUTED GLOBAL INDEX**
  如果使用该参数，则会更新分区表上的所有可用的全局二级索引，使得全局二级索引和基表的数据一致。对于EXCHANGE PARTITION，也会更新普通表上的所有可用全局二级索引。
  如果不使用该参数，则会使分区表上的所有全局二级索引失效。对于EXCHANGE PARTITION，也会使普通表上的所有全局二级索引失效。
  
- **NO UPDATE DISTRIBUTED GLOBAL INDEX**
  如果使用该参数，则会使分区表上的所有全局二级索引失效。对于EXCHANGE PARTITION，也会使普通表上的所有全局二级索引失效。
  
 
#### 示例
- 修改表分区名称。
  ```
  --创建前置分区表。
  gaussdb=# CREATE TABLE test_p1 (col1 INT, col2 INT) PARTITION BY RANGE (col1) 
  ( 
      PARTITION p1 VALUES LESS THAN (10), 
      PARTITION p2 VALUES LESS THAN (20), 
      PARTITION p3 VALUES LESS THAN (MAXVALUE) 
  );
  --修改分区名称。
  gaussdb=# ALTER TABLE test_p1 RENAME PARTITION p3 TO pmax;
  --查询分区信息。
  gaussdb=# SELECT relname, boundaries, oid FROM pg_partition WHERE parentid='test_p1'::regclass AND parttype <> 'r';
   relname | boundaries |  oid  
  ---------+------------+-------
   p1      | {10}       | 17066
   p2      | {20}       | 17067
   pmax    | {NULL}     | 17068
  (3 rows)
  ```
  
- 移动分区表空间。
  ```
  --创建分区。
  gaussdb=# CREATE TABLESPACE tbs_data1 RELATIVE LOCATION 'tablespace1/tbs_data1';
  --移动分区表空间。
  gaussdb=# ALTER TABLE test_p1 MOVE PARTITION P1 TABLESPACE tbs_data1;
  --查看分区表空间。
  gaussdb=# SELECT relname, spcname FROM pg_partition t1, pg_tablespace t2 WHERE T1.reltablespace=t2.oid and t1.parentid='test_p1'::regclass;
   relname |  spcname  
  ---------+-----------
   p1      | tbs_data1
  (1 row)
  ```
  
- 分区交换。
  ```
  --创建普通表，插入数据。
  gaussdb=# CREATE TABLE test_ep1(col1 INT,col2 INT);
  gaussdb=# INSERT INTO test_ep1 VALUES (GENERATE_SERIES(1,30), 1000);
  --迁移普通表数据到指定分区。
  gaussdb=# ALTER TABLE test_p1 EXCHANGE PARTITION (p1) WITH TABLE test_ep1 VERBOSE;
  --查询。
  gaussdb=# SELECT COUNT(*) FROM test_p1 PARTITION (p1);
   count 
  -------
       9
  (1 row)
  --删除表test_ep1。
  gaussdb=# DROP TABLE test_ep1;
  ```
  
- 分区合并。
  ```
  --将test_p1表中p2,pmax分区合并到pmax中。
  gaussdb=# ALTER TABLE test_p1 MERGE PARTITIONS p2,pmax INTO PARTITION pmax;
  --查看分区。
  gaussdb=# SELECT relname, boundaries, oid FROM pg_partition WHERE parentid='test_p1'::regclass AND parttype <> 'r' order by 1;
   relname | boundaries |  oid  
  ---------+------------+-------
   p1      | {10}       | 17066
   pmax    | {NULL}     | 17070
  (2 rows)
  --删除表和表空间。
  gaussdb=# DROP TABLE test_p1;
  gaussdb=# DROP TABLESPACE tbs_data1;
  ```
  
- 切割分区。
  ```
  --建表。
  gaussdb=# CREATE TABLE test_r1 (col1 INT,col2 INT) PARTITION BY RANGE (col1)(
      PARTITION p1   VALUES LESS THAN (10),
      PARTITION pmax VALUES LESS THAN (MAXVALUE)
  ); 
  --切割分区。
  gaussdb=# ALTER TABLE test_r1 SPLIT PARTITION pmax AT (20) INTO (PARTITION p2, PARTITION pmax);
  gaussdb=# ALTER TABLE test_r1 SPLIT PARTITION pmax INTO (
      PARTITION p3   VALUES LESS THAN (30),
      PARTITION pmax VALUES LESS THAN (MAXVALUE)
  );
  --查询。
  gaussdb=# SELECT relname, boundaries, oid FROM pg_partition WHERE parentid='test_r1'::regclass AND parttype <> 'r' order by 1;
   relname | boundaries |  oid  
  ---------+------------+-------
   p1      | {10}       | 17088
   p2      | {20}       | 17090
   p3      | {30}       | 17092
   pmax    | {NULL}     | 17093
  (4 rows)
  --删除表test_r1。
  gaussdb=# DROP TABLE test_r1;
  ```
  ```
  --建表。
  gaussdb=# CREATE TABLE test_r2(col1 INT, col2 INT) PARTITION BY RANGE (col1)(
      PARTITION p1   START(1) END(10),
      PARTITION p2   START(10) END(20),
      PARTITION pmax START(20) END(MAXVALUE)
  );
  --切割分区。
  gaussdb=# ALTER TABLE test_r2 SPLIT PARTITION pmax INTO (
      PARTITION p3 START(20) END(30),
      PARTITION pmax START(30) END (MAXVALUE)
  );
  --查看。
  gaussdb=# SELECT relname, boundaries, oid FROM pg_partition WHERE parentid='test_r2'::regclass AND parttype <> 'r' order by 1;
   relname | boundaries |  oid  
  ---------+------------+-------
   p1_0    | {1}        | 17112
   p1_1    | {10}       | 17113
   p2      | {20}       | 17114
   p3      | {30}       | 17116
   pmax    | {NULL}     | 17117
  (5 rows)
  --删除表test_r2。
  gaussdb=# DROP TABLE test_r2;
  ```
  ```
  --建表。
  gaussdb=# CREATE TABLE test_l1(col1 INT, col2 INT) PARTITION BY LIST(col1)(
      PARTITION p1   VALUES (10,20),
      PARTITION p2 VALUES (30,40)
  );
  --切割分区。
  gaussdb=# ALTER TABLE test_l1 SPLIT PARTITION p1 VALUES (10) INTO (PARTITION p1_1, PARTITION p1_2);
  gaussdb=# ALTER TABLE test_l1 SPLIT PARTITION p2 INTO (PARTITION p3_1 VALUES(30), PARTITION p3_2);
  --查看。
  gaussdb=# SELECT relname, boundaries, oid FROM pg_partition WHERE parentid='test_l1'::regclass AND parttype <> 'r' order by 1;
   relname | boundaries |  oid  
  ---------+------------+-------
   p1_1    | {10}       | 17132
   p1_2    | {20}       | 17133
   p3_1    | {30}       | 17134
   p3_2    | {40}       | 17135
  (4 rows)
  --删除表test_l1。
  gaussdb=# DROP TABLE test_l1;
  ```
  
- 添加分区。
  ```
  --建表。
  gaussdb=# CREATE TABLE test_p2 (col1 INT, col2 INT) PARTITION BY RANGE (col1)(
      PARTITION p1 VALUES LESS THAN (10),
      PARTITION p2 VALUES LESS THAN (20)
  );
  --添加分区。
  gaussdb=# ALTER TABLE test_p2 ADD PARTITION p3 VALUES LESS THAN (30);
  --删除表test_p2。
  gaussdb=# DROP TABLE test_p2;
  ```
  ```
  --建表。
  gaussdb=# CREATE TABLE test_p3 (col1 INT, col2 INT) PARTITION BY LIST(col1)(
      PARTITION p1 VALUES (1),
      PARTITION p2 VALUES (2)
  );
  --添加分区。
  gaussdb=# ALTER TABLE test_p3 ADD PARTITION p3 VALUES (3);
  --删除表test_p3。
  gaussdb=# DROP TABLE test_p3;
  ```
  
- 删除分区。
  ```
  --建表。
  gaussdb=# CREATE TABLE test_p4 (col1 INT, col2 INT) PARTITION BY LIST(col1)(PARTITION p1 VALUES (1),PARTITION p2 VALUES (2));
  --删除test_p3表的p2分区。
  gaussdb=# ALTER TABLE test_p4 DROP PARTITION p2;
  --查看。
  gaussdb=# SELECT relname, boundaries, oid FROM pg_partition WHERE parentid='test_p4'::regclass;
   relname | boundaries |  oid  
  ---------+------------+-------
   test_p4 |            | 17187
   p1      | {1}        | 17188
  (2 rows)
  --删除表test_p4。
  gaussdb=# DROP TABLE test_p4;
  --指定partition value删除分区。
  --建表。
  gaussdb=# CREATE TABLE test_p4 (col1 INT, col2 INT) PARTITION BY RANGE(col1)(PARTITION p1 VALUES LESS THAN(1),PARTITION p2 VALUES LESS THAN (2));
  --删除test_p3表的分区键为1时所处的分区。
  gaussdb=# ALTER TABLE test_p4 DROP PARTITION FOR (1);
  --查看。
  gaussdb=# SELECT relname, boundaries FROM pg_partition WHERE parentid='test_p4'::regclass order by 1 desc;
   relname | boundaries
  ---------+------------
   test_p4 |
   p1      | {1}
  (2 rows)
  --删除表test_p4。
  gaussdb=# DROP TABLE test_p4;
  ```
  
- 清空分区。
  ```
  --建表。
  gaussdb=# CREATE TABLE test_p5 (col1 INT, col2 INT) PARTITION BY RANGE (col1)(
      PARTITION p1 VALUES LESS THAN (5),
      PARTITION p2 VALUES LESS THAN (10)
  );
  --插入数据。
  gaussdb=# INSERT INTO test_p5 VALUES (GENERATE_SERIES(1,9), 100);
  --查看p2分区数据。
  gaussdb=# SELECT * FROM test_p5 PARTITION (p2);
   col1 | col2 
  ------+------
      5 |  100
      6 |  100
      7 |  100
      8 |  100
      9 |  100
  (5 rows)
  --清空p2分区的数据。
  gaussdb=# ALTER TABLE test_p5 TRUNCATE PARTITION p2;
  --查看p2分区数据。
  gaussdb=# SELECT * FROM test_p5 PARTITION (p2);
   col1 | col2 
  ------+------
  (0 rows)
  --删除表test_p5。
  gaussdb=# DROP TABLE test_p5;
  ```
  
 
#### 相关链接
[CREATE TABLE PARTITION](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0570.html#ZH-CN_TOPIC_0000002559105915)，[DROP TABLE](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0617.html#ZH-CN_TOPIC_0000002527986184)
