# ALTER PLUGGABLE DATABASE
#### 功能描述
修改Pluggable Database（PDB）的状态，对其进行打开、关闭、强制关闭的操作。
#### 注意事项
- 只能在GUC参数enable_mtd为on的状态下使用。
- 只能在非PDB中进行该操作。不可在M兼容模式数据库中执行该命令。
- 操作用户需要为PDB属主（见系统表pg_database.datdba）或拥有sysadmin权限。
- 仅数据库初始用户可以使用该语句变更模板PDB（template_pdb）。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 模板PDB只允许数据库初始用户连接，其他用户无法连接。
- 禁止用户在模板PDB下执行任何数据操作，若执行相关操作，可能产生预期外行为。例如，若在模板PDB内创建表空间，后续基于该模板创建的PDB不会同步模板内的表空间软链接，表空间软链接会发生丢失。
 
#### 语法格式
```
ALTER PLUGGABLE DATABASE pdb_name { OPEN | CLOSE | CLOSE IMMEDIATE };
```
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002764301344.png "点击放大")
#### 参数说明
- **pdb_name**
  PDB名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0003.html#ZH-CN_TOPIC_0000002793779057__section1257443811315)。
  
- **OPEN**
  打开指定的PDB。PDB的OPEN操作对其数据库实例的启动，即仅当PDB开启时才提供服务。管理员可按需启用或停用一部分PDB。只有PDB处于开启状态时，才允许被连接。
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  只有在当前的资源计划中存在与PDB关联的资源计划指令时，才可以成功打开PDB。
  
- **CLOSE**
  关闭指定的PDB。当用户暂不需要使用PDB或者需要将其删除时，可以通过CLOSE操作停止PDB的服务。关闭后，无法连接到该PDB。数据库会对关闭的PDB进行最基本的常规维护，以保证系统整体的一致性。这些停用的PDB对系统开销可以忽略。如果执行该语句时，该PDB还存在业务连接，则将最多等待5秒，后续还存在则会导致关闭失败。
  
- **CLOSE IMMEDIATE**
  强制关闭指定的PDB。如果管理员无法主动断连PDB的业务连接，可以使用该选项主动清退PDB现有的业务连接，并关闭PDB。
  
 
 #### 示例
- 前置条件。 请参见[示例](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0267.html#ZH-CN_TOPIC_0000002793698923__section5257162813410)完成PDB的创建。
  

- 打开与关闭PDB。
  ```
  -- 使用系统管理员连接postgres数据库，开启创建出的PDB。
  gaussdb=# ALTER PLUGGABLE DATABASE my_pdb OPEN;
  ALTER PLUGGABLE DATABASE
  -- 使用系统管理员连接postgres数据库，尝试关闭已经开启的PDB。
  gaussdb=# ALTER PLUGGABLE DATABASE my_pdb CLOSE;
  ALTER PLUGGABLE DATABASE
  -- 使用系统管理员连接postgres数据库，开启创建出的PDB。
  gaussdb=# ALTER PLUGGABLE DATABASE my_pdb OPEN;
  ALTER PLUGGABLE DATABASE
  -- 使用系统管理员连接postgres数据库，立即关闭已经开启的PDB。
  gaussdb=# ALTER PLUGGABLE DATABASE my_pdb CLOSE IMMEDIATE;
  ALTER PLUGGABLE DATABASE
  ```
  
 
#### 相关链接
[CREATE PLUGGABLE DATABASE](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0267.html)，[DROP PLUGGABLE DATABASE INCLUDING DATAFILES](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0323.html)，[GS_PDB](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1180.html)
