Redrock Postgres 文档
主页 切换暗/亮/自动模式 切换暗/亮/自动模式 切换暗/亮/自动模式 返回首页

CREATE TABLESPACE

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

语法

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

描述

CREATE TABLESPACE创建一个新的实例范围的表空间。表空间的名称必须与数据库实例中现有的任何表空间不同。

表空间允许超级用户在文件系统上定义另一个位置,可以把包含数据库对象 (例如表和索引)的数据文件放在那里。

一个具有适当特权的用户可以把*tablespace_name*传递给CREATE UNDOCREATE TABLECREATE INDEX或者ADD CONSTRAINT来让这些对象的数据文件存储在指定的表空间中。

表空间不能独立于定义它的实例使用,见 第 22.6 节

参数

  • tablespace_name

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

  • user_name

    将拥有该表空间的用户名。如果省略,默认为执行该命令的用户。只有超级用户能创建表空间,但是它们能把表空间的拥有权赋予给非超级用户。

  • local

    remote

    用于表空间的存储设备类型。如果省略,默认为locallocal表示本地存储设备,后面跟着的存储路径对应的是目录路径。remote表示远程存储设备,后面跟着的存储路径对应的是存储服务器访问信息。

  • directory

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

  • tablespace_option

    要设置或者重置的表空间参数。当前,唯一可用的参数是seq_page_costrandom_page_cost以及effective_io_concurrency。 为一个特定表空间设定其中一个值将覆盖规划器对该表空间中表页读取的 常规代价估计,常规代价估计是由同名的配置参数所建立(见 seq_page_costrandom_page_costeffective_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 扩展。