CREATE TABLESPACE
定义一个新表空间
英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。
当前阅读 PG 18·选择有来源记录的版本
- anchor
- SQL-CREATETABLESPACE
- file
- sql-createtablespace.html
- lang
- en
- name
- CREATE TABLESPACE
- purpose
- define a new tablespace
- purpose zh
- 未知
- sections same as
- 未知
- slug
- 18
- synopsis text
- CREATE TABLESPACE tablespace_name [ OWNER { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ] LOCATION 'directory' [ WITH ( tablespace_option = value [, ... ] ) ]
语法
CREATE TABLESPACE tablespace_name
[ OWNER { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ]
LOCATION 'directory'
[ WITH ( tablespace_option = value [, ... ] ) ]语法图
从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。
版本定义 PG 18
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，从而将这些对象的数据文件存储在指定的表空间中。
警告
表空间不能脱离定义它的集簇单独使用；见第 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比较版本
完整来源事实
synopsis html
CREATE TABLESPACE <em class="replaceable"><code>tablespace_name</code></em>
[ OWNER { <em class="replaceable"><code>new_owner</code></em> | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ]
LOCATION '<em class="replaceable"><code>directory</code></em>'
[ WITH ( <em class="replaceable"><code>tablespace_option</code></em> = <em class="replaceable"><code>value</code></em> [, ... ] ) ]来源引用
定义来源
center · PostgreSQL 18 · a709ab85
正文语言: zh-Hans · 1b5ca64c