CREATE TABLESPACE

CREATE TABLESPACE
上一页	上一级	SQL 命令	起始页	下一页

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

大纲

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

描述

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

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

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

警告

表空间不能独立于定义它的集簇使用，见第 22.6 节。

参数

tablespace_name: The name of a tablespace to be created. The name cannot begin with pg_, as such names are reserved for system tablespaces.
user_name: 将拥有该表空间的用户名。如果省略，默认为执行该命令的用户。只有超级用户能创建表空间，但是它们能把表空间的拥有权赋予给非超级用户。
directory: 要被用于表空间的目录。该目录应该为空并且必须由 PostgreSQL系统用户拥有。该目录必须用一个绝对路径指定。
tablespace_option: 要设置或者重置的表空间参数。当前，唯一可用的参数是 seq_page_cost、random_page_cost 以及effective_io_concurrency。为一个特定表空间设定其中一个值将覆盖规划器对该表空间中表页读取的常规代价估计，常规代价估计是由同名的配置参数所建立（见 seq_page_cost、 random_page_cost、 effective_io_concurrency）。如果一个表空间位于一个比其他 I/O 子系统更慢或者更快的磁盘上，这些参数就能发挥作用。

注解

只有在支持符号链接的系统上才支持表空间。

CREATE TABLESPACE不能在一个事务块内被执行。

示例

在/data/dbs创建一个表空间dbspace：

CREATE TABLESPACE dbspace LOCATION '/data/dbs';

在/data/indexes创建一个genevieve 用户拥有的表空间indexspace：

CREATE TABLESPACE indexspace OWNER genevieve LOCATION '/data/indexes';

兼容性

CREATE TABLESPACE是一种 PostgreSQL扩展。

另见

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