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

ALTER TABLESPACE

更改一个表空间的定义

ALTER数据库、模式与表空间引入 10（基线）现存至 20 devel1 次语法变更

动词: ALTER
对象: TABLESPACE
分组: 数据库、模式与表空间
引入版本: 10（基线）
状态: 现存
语法变更次数: 1
手册小节数: 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 14← 13语法变化

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

正文更新

同组命令

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

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

示例

兼容性

另见

语法演化

相关命令

同组命令