ALTER DATABASE

更改一个数据库

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

7.3 7.4 8.0 8.1 8.2 8.3 8.4 9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19 20

anchor: SQL-ALTERDATABASE
file: sql-alterdatabase.html
lang: en
name: ALTER DATABASE
purpose: change a database
purpose zh: 未知
sections same as: 未知
slug: 18

语法

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

where option can be:

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

语法图

从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。

option

ALTER DATABASE · 语法 2

ALTER DATABASE · 语法 3

ALTER DATABASE · 语法 4

ALTER DATABASE · 语法 5

ALTER DATABASE · 语法 6

ALTER DATABASE · 语法 7

ALTER DATABASE · 语法 8

ALTER DATABASE · 语法 9

版本定义 PG 18

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扩展。

另见

CREATE DATABASE, DROP DATABASE, SET, CREATE TABLESPACE

比较版本

完整来源事实

synopsis html

ALTER DATABASE <em class="replaceable"><code>name</code></em> [ [ WITH ] <em class="replaceable"><code>option</code></em> [ ... ] ]

<span class="phrase">where <em class="replaceable"><code>option</code></em> can be:</span>

    ALLOW_CONNECTIONS <em class="replaceable"><code>allowconn</code></em>
    CONNECTION LIMIT <em class="replaceable"><code>connlimit</code></em>
    IS_TEMPLATE <em class="replaceable"><code>istemplate</code></em>

ALTER DATABASE <em class="replaceable"><code>name</code></em> RENAME TO <em class="replaceable"><code>new_name</code></em>

ALTER DATABASE <em class="replaceable"><code>name</code></em> OWNER TO { <em class="replaceable"><code>new_owner</code></em> | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

ALTER DATABASE <em class="replaceable"><code>name</code></em> SET TABLESPACE <em class="replaceable"><code>new_tablespace</code></em>

ALTER DATABASE <em class="replaceable"><code>name</code></em> REFRESH COLLATION VERSION

ALTER DATABASE <em class="replaceable"><code>name</code></em> SET <em class="replaceable"><code>configuration_parameter</code></em> { TO | = } { <em class="replaceable"><code>value</code></em> | DEFAULT }
ALTER DATABASE <em class="replaceable"><code>name</code></em> SET <em class="replaceable"><code>configuration_parameter</code></em> FROM CURRENT
ALTER DATABASE <em class="replaceable"><code>name</code></em> RESET <em class="replaceable"><code>configuration_parameter</code></em>
ALTER DATABASE <em class="replaceable"><code>name</code></em> RESET ALL

synopsis text

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

where option can be:

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

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c