↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3

ALTER DATABASE

ALTER DATABASE — 更改一个数据库

大纲

ALTER DATABASE name [ [ WITH ] option [ ... ] ]

其中option可以是:

    ALLOW_CONNECTIONS allowconn
    CONNECTION LIMIT connlimit
    IS_TEMPLATE istemplate

ALTER DATABASE name RENAME TO new_name

ALTER DATABASE name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

ALTER DATABASE name SET TABLESPACE new_tablespace

ALTER DATABASE name REFRESH COLLATION VERSION

ALTER DATABASE name SET configuration_parameter { TO | = } { value | DEFAULT }
ALTER DATABASE name SET configuration_parameter FROM CURRENT
ALTER DATABASE name RESET configuration_parameter
ALTER DATABASE name RESET ALL

描述

ALTER DATABASE 更改一个数据库的属性。

第一种形式更改某些数据库级设置(详见下文)。只有数据库拥有者或者超级用户才能更改这些设置。

第二种形式更改数据库的名称。只有数据库拥有者或者超级用户可以重命名数据库;非超级用户拥有者还必须具有 CREATEDB 权限。当前连接的数据库不能被重命名(如果需要这样做,请连接到另一个数据库)。

第三种形式更改数据库的拥有者。要修改拥有者,你必须能够对新拥有者角色执行 SET ROLE,并且还必须具有 CREATEDB 权限。(注意,超级用户会自动拥有这些权限。)

第四种形式更改数据库的默认表空间。只有数据库拥有者或者超级用户可以这样做;你还必须对新表空间具有创建权限。该命令会将数据库旧默认表空间中的所有表和索引在物理上移动到新表空间中。对于该数据库而言,新默认表空间必须为空,并且不能有人连接到该数据库。位于非默认表空间中的表和索引不受影响。复制文件到新表空间所使用的方法会受到 file_copy_method 设置的影响。

其余形式会更改某个 PostgreSQL 数据库的运行时配置变量的会话默认值。此后每当在该数据库中启动一个新会话时,指定的值就会成为会话默认值。数据库特定的默认值会覆盖 postgresql.conf 中的设置,或者从 postgres 命令行接收到的设置。只有数据库拥有者或者超级用户才能更改该数据库的会话默认值。某些变量不能以这种方式设置,或者只能由超级用户设置。

参数

name

要修改其属性的数据库名称。

allowconn

如果为 false,则任何人都不能连接到该数据库。

connlimit

这个数据库允许多少并发连接。-1 表示没有限制。

istemplate

如果为 true,则任何具有 CREATEDB 权限的用户都可以克隆该数据库;如果为 false,则只有超级用户或该数据库的拥有者可以克隆它。

new_name

数据库的新名称。

new_owner

数据库的新拥有者。

new_tablespace

数据库的新默认表空间。

这种形式的命令不能在事务块内执行。

REFRESH COLLATION VERSION

更新数据库排序规则版本。背景信息见注解。

configuration_parameter
value

将此数据库在指定配置参数上的会话默认值设为给定值。如果 value 是 DEFAULT,或者等效地使用了 RESET,则数据库特定设置会被移除,因此新会话将继承系统范围的默认设置。使用 RESET ALL 可清除所有数据库特定设置。SET FROM CURRENT 会把该参数在当前会话中的值保存为数据库特定值。

关于允许的参数名和值的更多信息,见 SET 和第 19 章。

注解

也可以把会话默认值绑定到特定角色,而不是数据库;见 ALTER ROLE。如果发生冲突,角色特定设置会覆盖数据库特定设置。

示例

要在数据库 test 中默认禁用索引扫描:

ALTER DATABASE test SET enable_indexscan TO off;

兼容性

ALTER DATABASE 语句是一个 PostgreSQL 扩展。

报告文档问题

阅读 上游文档. 通过 PostgreSQL 文档反馈表单.