PostgreSQL 13.1 中文入门教程 PostgreSQL CREATE TABLESPACE

2024-02-25 开发教程 PostgreSQL 13.1 中文入门教程 匿名 0

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

大纲

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

描述

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

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

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

警告

表空间不能独立于定义它的集簇使用,见 第 22.6 节。

参数

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系统用户拥有。该目录必须用一个绝对 路径指定。

tablespace_option

要设置或者重置的表空间参数。当前,唯一可用的参数是 seq_page_costrandom_page_costeffective_io_concurrency以及maintenance_io_concurrency。 为一个特定表空间设定这些值将覆盖规划器对该表空间中表页读取的 常规代价估计,和执行程序的预取行为,由同名的配置参数确定(见 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