# ALTER SUBSCRIPTION
#### 功能描述
修改订阅的属性。
该语法在9.1.1.100及以上集群版本中已废弃，执行时会报错SUBSCRIPTION is not yet supported。
#### 注意事项
订阅的所有者才能执行ALTER SUBSCRIPTION，并且新的所有者必须是系统管理员。
#### 语法格式
- 更新订阅的连接信息。
  ```
  ALTER SUBSCRIPTION name CONNECTION 'conninfo';
  ```
  
- 更新订阅的发布端的发布名称。
  ```
  ALTER SUBSCRIPTION name SET PUBLICATION publication_name [, ...];
  ```
  
- 启用订阅。
  ```
  ALTER SUBSCRIPTION name ENABLE;
  ```
  
- 禁用订阅。
  ```
  ALTER SUBSCRIPTION name DISABLE;
  ```
  
- 设置订阅的参数。
  ```
  ALTER SUBSCRIPTION name SET ( subscription_parameter [= value] [, ... ] );
  ```
  
- 更改订阅的所有者。
  ```
  ALTER SUBSCRIPTION name OWNER TO new_owner;
  ```
  
 
- 重命名订阅。
  ```
  ALTER SUBSCRIPTION name RENAME TO new_name;
  ```
  
#### 参数说明
表1ALTER SUBSCRIPTION参数说明 
| 参数                                                  | 描述                                                      | 取值范围                                                                                                                                                            |
|:---|:---|:---|
| name                                               | 需要修改的订阅名称。                                              | 已存在的订阅名。                                                                                                                                                        |
| CONNECTION 'conninfo'                              | 该子句修改最初由CREATE SUBSCRIPTION设置的连接属性。 | 详细的参数说明请参考CREATE SUBSCRIPTION的[参数说明](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0288.html#ZH-CN_TOPIC_0000002166772842__section1549681213574)。 |
| publication_name                                   | 新发布的名称。                                                 | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0007.html#ZH-CN_TOPIC_0000002202094021__section1475018612353)。                   |
| ENABLE                                           | 启用先前禁用的订阅，在事务结束时启动逻辑复制工作。                               | -                                                                                                                                                              |
| DISABLE                                          | 禁用正在运行的订阅，在事务结束时停止逻辑复制工作。                               | -                                                                                                                                                                |
| SET ( publication_parameter \[= value\] \[, ... \] ) | 该子句修改最初由CREATE PUBLICATION设置的发布参数。  | 详细的参数说明请参考CREATE SUBSCRIPTION的[参数说明](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0288.html#ZH-CN_TOPIC_0000002166772842__section1549681213574)。  |
| new_owner                                          | 订阅新所有者的用户名称。                        | 已存在的用户名。                                                                                                                                                      |
| new_name                                           | 订阅的新名称。                                                | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0007.html#ZH-CN_TOPIC_0000002202094021__section1475018612353)。                    |
   
#### 示例
- 创建订阅sub_demo。
  ```
  DROP SUBSCRIPTION IF EXISTS sub_demo;
  CREATE SUBSCRIPTION sub_demo
      CONNECTION 'host=10.***.*.** port=10000 user=u_admin dbname=testdb password=********'
      PUBLICATION pub_sales_only;
  ```
  
- 将订阅的发布更改为insert_only。
  ```
  ALTER SUBSCRIPTION sub_demo SET PUBLICATION insert_only;
  ```
  
- 重命名订阅。
  ```
  ALTER SUBSCRIPTION sub_demo RENAME TO new_sub_demo;
  ```
  
- 禁用订阅。
  ```
  ALTER SUBSCRIPTION new_sub_demo DISABLE;
  ```
  
 
#### 相关链接
[CREATE SUBSCRIPTION](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0288.html)，[DROP SUBSCRIPTION](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0289.html)