# ALTER SUBSCRIPTION
#### 功能描述
更改订阅的属性。
#### 注意事项
- 该语法仅8.2.0.100及以上集群版本支持。
- 订阅的所有者才能执行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-dws/dws_06_0288.html#ZH-CN_TOPIC_0000001811634793__section1549681213574)。 |
| publication_name                                   | 新发布的名称。                                                                                                                     | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-dws/dws_06_0007.html#ZH-CN_TOPIC_0000001811634529__section1475018612353)。                   |
| ENABLE                                           | 启用先前禁用的订阅，在事务结束时启动逻辑复制工作。                                                                                                   | -                                                                                                                                                          |
| DISABLE                                          | 禁用正在运行的订阅，在事务结束时停止逻辑复制工作。                                                                                                   | -                                                                                                                                                            |
| SET ( publication_parameter \[= value\] \[, ... \] ) | 该子句修改最初由[CREATE PUBLICATION](https://support.huaweicloud.com/sqlreference-dws/dws_06_0285.html)设置的发布参数。 | 详细的参数说明请参考CREATE SUBSCRIPTION的[参数说明](https://support.huaweicloud.com/sqlreference-dws/dws_06_0288.html#ZH-CN_TOPIC_0000001811634793__section1549681213574)。  |
| new_owner                                          | 订阅新所有者的用户名称。                                                                                            | 已存在的用户名。                                                                                                                                                  |
| new_name                                           | 订阅的新名称。                                                                                                                    | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-dws/dws_06_0007.html#ZH-CN_TOPIC_0000001811634529__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-dws/dws_06_0288.html)，[DROP SUBSCRIPTION](https://support.huaweicloud.com/sqlreference-dws/dws_06_0289.html)
#### 查看数据库中的订阅信息
DWS提供[PG_SUBSCRIPTION](https://support.huaweicloud.com/devg-dws/dws_04_1044.html)系统表查看当前数据库中创建的订阅信息，包括订阅的名称、所有者、参数设置等。