↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0

CREATE TABLESPACE

CREATE TABLESPACE — 定义一个新表空间

大纲

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扩展。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。