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

CREATE TABLESPACE

定义一个新表空间

define a new tablespace

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

动词: CREATE
对象: TABLESPACE
分组: 数据库、模式与表空间
引入版本: 8.0
状态: 现存
语法变更次数: 4
手册小节数: 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，从而将这些对象的数据文件存储在指定的表空间中。

警告

表空间不能脱离定义它的集簇单独使用；见第 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 18← 17正文更新

正文更新
PostgreSQL 17← 16正文更新

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

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

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

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

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

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

+ [ OWNER { new_owner | CURRENT_USER | SESSION_USER } ]− [ OWNER user_name ]
PostgreSQL 9.4← 9.3语法变化

+ [ WITH ( tablespace_option = value [, ... ] ) ]正文更新
PostgreSQL 9.0← 8.4语法变化

+ CREATE TABLESPACE tablespace_name [ OWNER user_name ] LOCATION 'directory'− CREATE TABLESPACE tablespacename [ OWNER username ] LOCATION 'directory'正文更新
PostgreSQL 8.3← 8.2正文更新

正文更新
PostgreSQL 8.2← 8.1正文更新

正文更新
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

语法概要

描述

警告

参数

注解

示例

兼容性

另见

语法演化

相关命令

同组命令