CREATE TABLESPACE#

CREATE TABLESPACE

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 来让这些对象的数据文件存储在指定的表空间中。

警告

表空间不能独立于定义它的集簇使用。

参数

``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``

要被用于表空间的目录。该目录必需存在（CREATE TABLESPACE 将不创建它），应该为空，并且必须由 PostgreSQL系统用户拥有。该目录必须用一个URL指定。

``tablespace_option``

要设置或者重置的表空间参数。

seq_page_cost、random_page_cost 以及effective_io_concurrency 为一个特定表空间设定其中一个值将覆盖规划器对该表空间中表页读取的常规代价估计，常规代价估计是由同名的配置参数所建立（见 `seq_page_cost`__、 `random_page_cost`__、 `effective_io_concurrency`__）。如果一个表空间位于一个比其他 I/O 子系统更慢或者更快的磁盘上，这些参数就能发挥作用。

remote_storage设定表空间是否为存算分离。

bucket_number设定表空间的存储分片数量。

default_create_table_option设定在表空间创建表时默认使用的参数，效果如同把这些参数添加到CREATE TABLE的WITH ( )子句。

注解

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

示例

要在magma集群oushu的虚拟存储集群vsc_default创建表空间dbspace，请发出表空间创建命令：

CREATE TABLESPACE magma_space LOCATION 'magma://oushu/vsc_default';
CREATE TABLESPACE horc_dfs LOCATION 'hdfs://localhost:8020/oushudb/horc_default';

要创建由不同数据库用户拥有的表空间，可用类似这样的命令：

CREATE TABLESPACE magma_space OWNER role_A LOCATION 'magma://oushu/vsc_default';
CREATE TABLESPACE horc_dfs OWNER role_B LOCATION 'hdfs://localhost:8020/oushudb/horc_default';

兼容性

CREATE TABLESPACE是一种 PostgreSQL扩展。

另见

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

OushuDB 产品文档

CREATE TABLESPACE

CREATE TABLESPACE#