Postgresql 中文操作指南

CREATE TABLESPACE

CREATE TABLESPACE — 定义一个新表空间

Synopsis

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

Description

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

一个表空间允许超级用户在文件系统上定义一个替代位置，其中可以容纳包含数据库对象（比如表和索引）的数据文件。

拥有适当权限的用户可以将 tablespace_name 传递给 CREATE DATABASE 、 CREATE TABLE 、 CREATE INDEX 或 ADD CONSTRAINT ，以便将这些对象的数据文件存储在指定表空间内。

Warning

一个表空间不能独立于定义它的集群使用；请参见 Section 23.6 。

Parameters

  • tablespace_name

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

  • user_name

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

  • directory

    • 将用于这个表空间的目录。该目录必须存在（ CREATE TABLESPACE 不会创建它），应该为空，并且必须归 PostgreSQL 系统用户所有。必须用绝对路径名称指定该目录。

  • tablespace_option

    • 一个要设置或重置的表空间参数。当前，唯一可用的参数是 seq_page_cost 、 random_page_cost 、 effective_io_concurrency 和 maintenance_io_concurrency 。为特定表空间设置这些值将覆盖计划程序对于从该表空间中的表读取页面的成本的通常估计，并且执行程序的预取行为，由同名配置参数建立（请参见 seq_page_cost 、 random_page_cost 、 effective_io_concurrency 、 maintenance_io_concurrency ）。如果一个表空间位于比 I/O 子系统的其他部分更快速或更慢的磁盘上，这可能很有用。

Notes

CREATE TABLESPACE 无法在事务块内执行。

Examples

要在文件系统位置 /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';

Compatibility

CREATE TABLESPACE 是 PostgreSQL 扩展。

See Also

CREATE DATABASE , CREATE TABLE , CREATE INDEX , DROP TABLESPACE , ALTER TABLESPACE