# ALTER DATABASE
#### 功能描述
修改数据库的属性，包括它的名称、所有者、连接数限制、对象隔离属性等。
#### 注意事项
- 只有数据库的所有者或者被授予了数据库ALTER权限的用户才能执行ALTER DATABASE命令，系统管理员默认拥有此权限。针对所要修改属性的不同，还有以下权限约束：
  - 修改数据库名称，必须拥有CREATEDB权限。
  
  - 修改数据库所有者，当前用户必须是该DATABASE的所有者或者系统管理员，必须拥有CREATEDB权限，且该用户是新所有者角色的成员。
  
  - 修改数据库默认表空间，该用户必须拥有新表空间的CREATE权限。这个语句会从物理上将一个数据库原来缺省表空间上的表和索引移至新的表空间。注意不在缺省表空间的表和索引不受此影响。
   
- 不能重命名当前使用的数据库，如果需要重新命名，须连接至其他数据库上。
 
#### 语法格式
- 修改数据库的最大连接数。
  ```
  ALTER DATABASE database_name 
      [ WITH ] CONNECTION LIMIT connlimit;
  ```
  
- 修改数据库名称。
  ```
  ALTER DATABASE database_name 
      RENAME TO new_name;
  ```
  
- 修改数据库所有者。
  ```
  ALTER DATABASE database_name 
      OWNER TO new_owner;
  ```
  

- 修改数据库默认表空间。
  ```
  ALTER DATABASE database_name
      SET TABLESPACE new_tablespace;
  ```
  ![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  如果该数据库中的某些表或对象已经创建在new_tablespace下，则无法将该数据库的默认表空间修改为new_tablespace，执行会报错。
  
- 修改数据库对象隔离属性。
  ```
  ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT;
  ```
  ![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - 修改数据库的对象隔离属性时须连接至该数据库，否则无法更改。
  
  - 新创建的数据库，对象隔离属性默认是关闭的。当开启数据库对象隔离属性后，数据库会为系统表PG_CLASS、PG_ATTRIBUTE、PG_PROC、PG_NAMESPACE、PGXC_SLICE和PG_PARTITION自动添加行级访问控制策略，普通用户只能查看这些系统表中有权访问的对象（表、函数、视图、字段等）。对象隔离特性对管理员用户不生效，当开启对象隔离特性后，管理员也可以查看到全量的数据库对象。
    

- 修改数据库时区。
  ```
  ALTER DATABASE database_name SET DBTIMEZONE = time_zone;
  ```
  

- 修改数据库指定会话参数值。
  ```
  ALTER DATABASE database_name 
      SET configuration_parameter { { TO | = } { value | DEFAULT } | FROM CURRENT };
  ```
  
- 数据库配置参数重置。
  ```
  ALTER DATABASE database_name RESET 
      { configuration_parameter | ALL };
  ```
  
 
#### 参数说明
- **database_name**
  需要修改属性的数据库名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0319.html#ZH-CN_TOPIC_0000002235270221__zh-cn_topic_0000002235098221_section14873217506)。
  
- **connlimit**
  数据库可以接收的最大并发连接数（管理员用户连接除外）。
  取值范围：\[-1, 2\^31-1\]的整数，建议填写1\~50的整数。-1（缺省）表示没有限制。
  
- **new_name**
  数据库的新名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0319.html#ZH-CN_TOPIC_0000002235270221__zh-cn_topic_0000002235098221_section14873217506)。
  
- **new_owner**
  数据库的新所有者。
  取值范围：字符串，有效的用户名。
  
- **new_tablespace**
  数据库新的默认表空间，该表空间为数据库中已经存在的表空间。默认的表空间为pg_default。
  取值范围：字符串，有效的表空间名。
  
- **configuration_parameter**
  - **value**
    把指定的数据库会话参数值设置为给定的值。如果value是DEFAULT或者RESET，则在新的会话中使用系统的缺省设置。OFF关闭设置。
    ![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    当前版本不支持设置数据库级别参数。
    取值范围：字符串
    - DEFAULT
    
    - OFF
    
    - RESET
      
  
  - **FROM CURRENT**
    取当前会话中的值设置为configuration_parameter的值。
    
   

- **time_zone**
  设置database_name的数据库的时区值，需要有对应的数据库的权限。
  取值范围：字符串
  - 系统支持的时区和其相应的缩写
  
  - -15:59到+15:00
   
- **FROM CURRENT**
  根据当前会话连接的数据库设置该参数的值。
  
- **RESET configuration_parameter**
  重置指定的数据库会话参数值。
  ![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  当前版本不支持重置数据库级别参数。
  
- **RESET ALL**
  重置全部的数据库会话参数值。
  ![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  当前版本不支持重置数据库级别参数。
  
![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。
- 修改的数据库会话参数值，将在下一次会话中生效。
- 执行完参数设置后，需要手动执行CLEAN CONNECTION清理旧连接，否则可能存在集群节点间参数值不一致。
 
#### 示例
请参考CREATE DATABASE的[示例](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0514.html#ZH-CN_TOPIC_0000002200350050__zh-cn_topic_0000002235219497_zh-cn_topic_0059778277_s6be7b8abbb4b4aceb9dae686434d672c)。
#### 相关链接
[CREATE DATABASE](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0514.html#ZH-CN_TOPIC_0000002200350050)，[DROP DATABASE](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0561.html#ZH-CN_TOPIC_0000002235270573)