选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

CREATE TABLESPACE

CREATE TABLESPACE — 定义一个新表空间

Synopsis

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

描述

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

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

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

Warning

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

参数

tablespace_name

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

user_name

将成为该表空间所有者的用户名。若省略,则默认为执行该命令的用 户。只有超级用户可以创建表空间,但他们可以将表空间的所有权赋予 非超级用户。

directory

将用于表空间的目录。该目录应为空,并且必须归PostgreSQL系统用户所有。必须使用绝对路径名指定该目录。

tablespace_option

要设置或重置的表空间参数。目前唯一可用的参数是seq_page_costrandom_page_costeffective_io_concurrency。为特定表空间设置其中任一值,会覆盖规划器根据同名配置参数(请参见seq_page_costrandom_page_costeffective_io_concurrency)建立的、读取该表空间中表页面的通常代价估计。如果一个表空间位于比 I/O 子系统其余部分更快或更慢的磁盘上,这可能很有用。

注解

表空间仅在支持符号链接的系统上受支持。

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

示例

创建一个表空间dbspace,位置为/data/dbs

CREATE TABLESPACE dbspace LOCATION '/data/dbs';

创建一个表空间indexspace,位置为/data/indexes,所有者为用户genevieve

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

兼容性

CREATE TABLESPACE是一种PostgreSQL扩展。