SQL COMMAND · 数据库、模式与表空间

ALTER TABLESPACE

更改一个表空间的定义

change the definition of a tablespace

ALTER数据库、模式与表空间引入 8.0现存至 20 devel3 次语法变更

动词: ALTER
对象: TABLESPACE
分组: 数据库、模式与表空间
引入版本: 8.0
状态: 现存
语法变更次数: 3
手册小节数: 5

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 语法未变，正文有更新。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

ALTER TABLESPACE · 语法 2

ALTER TABLESPACE · 语法 3

ALTER TABLESPACE · 语法 4

语法概要

ALTER TABLESPACE name RENAME TO new_name
ALTER TABLESPACE name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER TABLESPACE name SET ( tablespace_option = value [, ... ] )
ALTER TABLESPACE name RESET ( tablespace_option [, ... ] )

PostgreSQL 18 手册 · 查看完整参考页

描述

ALTER TABLESPACE 可以用于更改表空间的定义。

要更改表空间的定义，你必须拥有该表空间。要修改拥有者，你还必须能够对新拥有者角色执行 SET ROLE。（注意，超级用户自动具有这些权限。）

参数

name: 现有表空间的名称。
new_name: 该表空间的新名称。新名称不能以 pg_开头，因为这类名称保留给系统表空间使用。
new_owner: 该表空间的新拥有者。
tablespace_option: 要设置或者重置的表空间参数。当前，唯一可用的参数是 seq_page_cost、random_page_cost、effective_io_concurrency 以及 maintenance_io_concurrency。为一个特定表空间设定这些值将覆盖由同名配置参数确定的规划器对该表空间中表页读取的常规代价估计，以及会发起的并发 I/O 数量（见 seq_page_cost、random_page_cost、effective_io_concurrency、maintenance_io_concurrency）。如果一个表空间位于一个比 I/O 子系统其余部分更慢或者更快的磁盘上，这些参数就能发挥作用。

示例

将表空间 index_space 重命名为 fast_raid：

ALTER TABLESPACE index_space RENAME TO fast_raid;

更改表空间 index_space 的拥有者：

ALTER TABLESPACE index_space OWNER TO mary;

兼容性

在 SQL 标准中没有 ALTER TABLESPACE 语句。

另见

CREATE TABLESPACE, DROP TABLESPACE

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 18← 17正文更新

正文更新
PostgreSQL 16← 15正文更新

正文更新
PostgreSQL 14← 13语法变化

+ ALTER TABLESPACE name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
PostgreSQL 13← 12正文更新

正文更新
PostgreSQL 9.6← 9.5正文更新

正文更新
PostgreSQL 9.5← 9.4语法变化

+ ALTER TABLESPACE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
PostgreSQL 9.4← 9.3正文更新

正文更新
PostgreSQL 9.3← 9.2正文更新

正文更新
PostgreSQL 9.0← 8.4语法变化

+ ALTER TABLESPACE name RENAME TO new_name+ ALTER TABLESPACE name OWNER TO new_owner+ ALTER TABLESPACE name SET ( tablespace_option = value [, ... ] )+ ALTER TABLESPACE name RESET ( tablespace_option [, ... ] )− ALTER TABLESPACE name RENAME TO newname− ALTER TABLESPACE name OWNER TO newowner正文更新
PostgreSQL 8.1← 8.0正文更新

正文更新
PostgreSQL 8.0← 7.4新增此命令

同组命令

命令	动词	对象	最近变更
DATABASES & SCHEMAS数据库、模式与表空间9 条↑
`CREATE DATABASE`	CREATE	DATABASE	1713 次
创建一个新数据库			现存
`ALTER DATABASE`	ALTER	DATABASE	159 次
更改一个数据库			现存
`DROP DATABASE`	DROP	DATABASE	132 次
移除一个数据库			现存
`CREATE SCHEMA`	CREATE	SCHEMA	144 次
定义一个新模式			现存
`ALTER SCHEMA`	ALTER	SCHEMA	144 次
更改一个模式的定义			现存
`DROP SCHEMA`	DROP	SCHEMA	8.21 次
移除一个模式			现存
`CREATE TABLESPACE`	CREATE	TABLESPACE	144 次
定义一个新表空间			现存
`ALTER TABLESPACE`	ALTER	TABLESPACE	143 次
更改一个表空间的定义			现存
`DROP TABLESPACE`	DROP	TABLESPACE	9.23 次
移除一个表空间			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

示例

兼容性

另见

语法演化

相关命令

同组命令