ALTER-COLOCATE-GROUP

ALTER-COLOCATE-GROUP

Name

ALTER COLOCATE GROUP

Description

该语句用于修改 Colocation Group 的属性。

语法：

ALTER COLOCATE GROUP  [database.]group
SET (
    property_list
);

注意：

1. 如果 colocate group 是全局的，即它的名称是以 __global__ 开头的，那它不属于任何一个 Database；

2. property_list 是 colocation group 属性，目前只支持修改replication_num 和 replication_allocation。 修改 colocation group 的这两个属性修改之后，同时把该 group 的表的属性default.replication_allocation 、 属性dynamic.replication_allocation 、以及已有分区的replication_allocation改成跟它一样。

Example

1. 修改一个全局 group 的副本数

   # 建表时设置 "colocate_with" = "__global__foo"
   
   ALTER COLOCATE GROUP __global__foo
   SET (
       "replication_num"="1"
   );

2. 修改一个非全局 group 的副本数

   # 建表时设置 "colocate_with" = "bar"，且表属于 Database example_db
   
   ALTER COLOCATE GROUP example_db.bar
   SET (
       "replication_num"="1"
   );
   ```

### Keywords

```sql
ALTER, COLOCATE , GROUP

Best Practice