=================
CREATE TABLESPACE
=================


.. container:: refentry
   :name: SQL-CREATETABLESPACE

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: CREATE TABLESPACE
         :name: create-tablespace

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

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

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

   .. container:: refsect1
      :name: id-1.9.3.87.5

      .. rubric:: 描述
         :name: 描述

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

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

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

      .. warning::

         .. rubric:: 警告
            :name: 警告
            :class: title

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

   .. container:: refsect1
      :name: id-1.9.3.87.6

      .. rubric:: 参数
         :name: 参数

      .. container:: variablelist

         *``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 ( )``\ 子句。

   .. container:: refsect1
      :name: id-1.9.3.87.7

      .. rubric:: 注解
         :name: 注解

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

   .. container:: refsect1
      :name: id-1.9.3.87.8

      .. rubric:: 示例
         :name: 示例

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

      .. code:: programlisting

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

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

      .. code:: programlisting

         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';

   .. container:: refsect1
      :name: id-1.9.3.87.9

      .. rubric:: 兼容性
         :name: 兼容性

      ``CREATE TABLESPACE``\ 是一种 PostgreSQL扩展。

   .. container:: refsect1
      :name: id-1.9.3.87.10

      .. rubric:: 另见
         :name: 另见

      `CREATE DATABASE <sql-createdatabase.html>`__, `CREATE
      TABLE <sql-createtable.html>`__, `CREATE
      INDEX <sql-createindex.html>`__, `DROP
      TABLESPACE <sql-droptablespace.html>`__, `ALTER
      TABLESPACE <sql-altertablespace.html>`__