2025年9月25日: PostgreSQL 18 发布!
支持的版本:当前18)/ 17 / 16 / 15 / 14 / 13
开发版本:devel
不支持的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0

CREATE TABLESPACE

CREATE TABLESPACE — 定义一个新的表空间

概要

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

描述

CREATE TABLESPACE 注册一个新的集群范围的表空间。表空间名称必须与数据库集群中任何现有表空间的名称不同。

表空间允许超级用户在文件系统上定义一个备用位置,用于存放包含数据库对象(如表和索引)的数据文件。

具有适当权限的用户可以将 tablespace_name 传递给 CREATE DATABASECREATE TABLECREATE INDEXADD CONSTRAINT,以便这些对象的 数据文件存储在指定的表空间中。

警告

表空间不能独立于其定义的集群使用;请参阅 第 22.6 节

参数

tablespace_name

要创建的表空间名称。名称不能以 pg_ 开头,因为此类名称保留给系统表空间。

user_name

将拥有该表空间的用户名称。如果省略,则默认为执行命令的用户。只有超级用户可以创建表空间,但他们可以将表空间的所有权分配给非超级用户。

directory

将用于表空间的目录。该目录必须存在(CREATE TABLESPACE 不会创建它),应该是空的,并且必须由 PostgreSQL 系统用户拥有。该目录必须由绝对路径名指定。

tablespace_option

要设置或重置的表空间参数。目前,唯一可用的参数是 seq_page_costrandom_page_costeffective_io_concurrencymaintenance_io_concurrency。为特定表空间设置这些值将覆盖规划器对从该表空间中的表读取页面的成本的常规估计,以及这些页面的并发 I/O 操作次数,这些值由同名的配置参数(请参阅 seq_page_costrandom_page_costeffective_io_concurrencymaintenance_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 TABLESPACEPostgreSQL 的扩展。

提交更正

如果您在文档中发现任何不正确的内容,与您实际使用的功能不符,或者需要进一步澄清,请使用 此表单 报告文档问题。