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

CREATE TABLESPACE

定义一个新表空间

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

动词: CREATE
对象: TABLESPACE
分组: 数据库、模式与表空间
引入版本: 10（基线）
状态: 现存
语法变更次数: 1
手册小节数: 6

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

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

语法概要

CREATE TABLESPACE tablespace_name
    [ OWNER { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ]
    LOCATION 'directory'
    [ WITH ( tablespace_option = value [, ... ] ) ]

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

描述

CREATE TABLESPACE注册一个新的集簇级别的表空间。该表空间的名称必须不同于数据库集簇中任何现有表空间的名称。

表空间允许超级用户在文件系统中定义一个替代位置，使数据库对象（如表和索引）的数据文件可以存放在那里。

具有适当权限的用户可以将 tablespace_name传递给 CREATE DATABASE、CREATE TABLE、 CREATE INDEX或ADD CONSTRAINT，从而将这些对象的数据文件存储在指定的表空间中。

Warning

表空间不能脱离定义它的集簇单独使用；见 Section 22.6。

参数

tablespace_name: 要创建的表空间名称。名称不能以pg_开头，因为这类名称保留给系统表空间使用。
user_name: 将成为该表空间所有者的用户名。若省略，则默认为执行该命令的用户。只有超级用户可以创建表空间，但他们可以将表空间的所有权赋予非超级用户。
directory: 用作该表空间的目录。该目录必须已存在（CREATE TABLESPACE 不会创建它），应为空，并且必须由 PostgreSQL系统用户拥有。该目录必须指定为绝对路径名。
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 子系统更慢或者更快的磁盘上，这些参数就能发挥作用。

注解

CREATE TABLESPACE不能在事务块内执行。

示例

要在文件系统位置/data/dbs创建表空间 dbspace，请首先使用操作系统工具创建目录并设置正确的所有权：

mkdir /data/dbs
chown postgres:postgres /data/dbs

然后在PostgreSQL中发出创建表空间的命令：

CREATE TABLESPACE dbspace LOCATION '/data/dbs';

要创建一个由其他数据库用户拥有的表空间，可使用类似下面的命令：

CREATE TABLESPACE indexspace OWNER genevieve LOCATION '/data/indexes';

兼容性

CREATE TABLESPACE是一种PostgreSQL扩展。

另见

CREATE DATABASE, CREATE TABLE, CREATE INDEX, DROP TABLESPACE, ALTER TABLESPACE

语法演化

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

PostgreSQL 14← 13语法变化

+ [ OWNER { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ]− [ OWNER { new_owner | CURRENT_USER | SESSION_USER } ]正文更新
PostgreSQL 13← 12正文更新

正文更新
PostgreSQL 12← 11正文更新

正文更新

同组命令

命令	动词	对象	最近变更
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	—
移除一个表空间			现存

快速链接