文档

CREATE TABLESPACE

更新时间:

CREATE TABLESPACE用于注册一个新的集群范围的表空间。

简介

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

表空间用于在文件系统上定义另一个位置,可以把包含数据库对象 (例如表和索引)的数据文件放在那里,并且可以把 tablespace_name传递给 CREATE DATABASECREATE TABLECREATE INDEX或者ADD CONSTRAINT 来让这些对象的数据文件存储在指定的表空间中。

重要
  • 只有polar_superuser用户可以创建表空间,普通客户无法创建。

  • 对于polar_superuser用户,支持将对象存储在指定表空间的语法,但是实际上对象还是在pg_default表空间下,执行过程中会返回提醒信息。对于普通用户,不支持该语法。

语法

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

参数

  • tablespace_name要创建的表空间的名称。名称不能以pg_开头。

  • user_name将拥有该表空间的用户名。如果省略,默认为执行该命令的用户。只有polar_superuser用户能创建表空间。

  • directory要被用于表空间的目录。该目录必须存在(CREATE TABLESPACE 将不创建它),应该为空,并且必须由PolarDB系统用户拥有。该目录必须用一个绝对路径指定。

  • tablespace_option要设置或者重置的表空间参数。当前可用的参数是 seq_page_costrandom_page_costeffective_io_concurrencymaintenance_io_concurrency。 为一个特定表空间设定这些值将覆盖规划器对该表空间中表页读取的常规代价估计,和执行程序的预取行为,由同名的配置参数确定(见 seq_page_cost、random_page_cost、effective_io_concurrency、 maintenance_io_concurrency)。 如果一个表空间位于一个比其他 I/O 子系统更慢或者更快的磁盘上,这些参数就能发挥作用。

说明

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

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

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

示例

您可以在pg_tablespace系统表中查询polar_superuser用户创建的表空间。

  1. 执行如下语句,使用polar_superuser用户创建表空间。

    CREATE TABLESPACE test_tablespace location '/';
  2. 执行如下语句,在pg_tablespace系统表中查询表空间。

    SELECT spcname FROM pg_tablespace;

    返回结果如下:

         spcname     
    -----------------
     pg_default
     pg_global
     test_tablespace
  3. 执行如下语句,使用polar_superuser用户创建数据库对象并指定表空间。

    CREATE TABLE test_table(a int) TABLESPACE test_tablespace;

    返回结果如下:

    NOTICE:  User defined tablespace is not supported, The tablespace set by the user will be ignored
    CREATE TABLE