Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

CREATE TABLESPACE

CREATE TABLESPACE — 定义一个新 tablespace

概要

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

描述

CREATE TABLESPACE 注册一个新的群集范围的 tablespace。tablespace 名称必须有别于数据库群集中的任何现有的 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。为特定表空间设置这些值将覆盖规划程序通常估计从该表空间中的表中读取页面的成本,以及执行程序的预取行为(由同名配置参数确定,请参阅 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 扩展。

另请参见

创建数据库创建表创建索引删除表空间更改表空间