受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

CREATE TABLESPACE

CREATE TABLESPACE — 定义一个新表空间

Synopsis

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, 从而将这些对象的数据文件存储在指定的表空间中。

Warning

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

参数

tablespace_name #

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

user_name #

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

directory #

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

tablespace_option #

要设置或者重置的表空间参数。当前,唯一可用的参数是 seq_page_costrandom_page_costeffective_io_concurrency以及maintenance_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 TABLESPACE是一种PostgreSQL扩展。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。