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 [, ... ] ) ]

描述

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

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

拥有相应特权的用户可以把 tablespace_name 传递给 CREATE DATABASE、CREATE TABLE、CREATE INDEX 或 ADD CONSTRAINT,从而把这些对象的数据文件存储在指定的表空间中。

Warning

表空间不能脱离定义它的集群而独立使用;请参见 Section 22.6。

参数

tablespace_name

要创建的表空间的名称。该名称不能以 pg_ 开头,因为这样的名称被保留用于系统表空间。

user_name

将拥有该表空间的用户的名称。如果省略,默认为执行该命令的用户。只有超级用户才能创建表空间,但他们可以把表空间的拥有权分配给非超级用户。

directory

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

tablespace_option

要设置或重置的表空间参数。当前,唯一可用的参数是 seq_page_cost、random_page_cost、effective_io_concurrency 和 maintenance_io_concurrency。为某个特定表空间设置这些值,将会覆盖规划器对从该表空间中的表读取页面的开销以及发出多少并发 I/O 的通常估计,这一估计由同名的配置参数确定(参见 seq_page_cost、random_page_cost、effective_io_concurrency、maintenance_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 的扩展。

另请参阅

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