CREATE TABLESPACE

CREATE TABLESPACE — создать табличное пространство

Синтаксис

Только для глобальных табличных пространств:
CREATE TABLESPACE табл_пространство
    [ OWNER { новый_владелец | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ]
    LOCATION 'template'
    [ WITH ( global = true = параметр_табличного_пространства= значение [, ... ] ) ]

Описание

Обратите внимание, что Postgres Pro Shardman поддерживает только глобальные табличные пространства.

В сегментированных системах при создании табличного пространства используйте значение {rgid} для location и ключевое слово with (global).

Расширение синтаксиса команды CREATE TABLESPACE в Postgres Pro Shardman позволяет создавать новое табличное пространство на уровне кластера. Все табличные пространства в кластере Shardman должны создаваться на уровне кластера. Табличное пространство на уровне кластера создаётся на каждом узле с расположением, полученным из параметра шаблон.

Табличные пространства позволяют администраторам баз данных определять альтернативные расположения в файловой системе, где могут находиться файлы, содержащие объекты базы данных (например, таблицы или индексы). Создавать табличные пространства могут только суперпользователи и пользователи с правами роли pg_create_tablespace, но их владельцами могут быть назначены и обычные пользователи.

Пользователь, имеющий соответствующие права, может передать параметр табл_пространство команде CREATE DATABASE, CREATE TABLE, CREATE INDEX или ADD CONSTRAINT, чтобы файлы данных для этих объектов хранились в указанном табличном пространстве.

Предупреждение

Табличное пространство нельзя использовать отдельно от кластера, в котором оно было определено; см. Раздел 21.7.

Параметры

TEMPORARY или TEMP

Если указано, табличное пространство создаётся как пространство для временных объектов, таких как временные таблицы и индексы этих таблиц.

табл_пространство

Имя создаваемого табличного пространства. Это имя не может начинаться с pg_, так как такие имена зарезервированы для системных табличных пространств.

имя_пользователя

Имя пользователя, который будет владельцем табличного пространства. Если опущено, владельцем по умолчанию станет пользователь, выполняющий команду.

каталог

Каталог, который будет использован для этого табличного пространства. Этот каталог должен уже существовать (CREATE TABLESPACE не создаст его), быть пустым и принадлежать системному пользователю Postgres Pro Shardman. Задаваться его расположение должно абсолютным путём.

global = true

Указывает, что создаваемое табличное пространство должно быть глобальным.

параметр_табличного_пространства

Устанавливаемый или сбрасываемый параметр табличного пространства. В настоящее время поддерживаются только параметры seq_page_cost, random_page_cost, effective_io_concurrency, maintenance_io_concurrency, compression и encryption. При установке параметров стоимости для заданного табличного пространства будут переопределены обычная оценка стоимости чтения страниц из таблиц в этом пространстве и число одновременно выполняемых операций ввода-вывода, задаваемые одноимёнными параметрами конфигурации (см. seq_page_cost, random_page_cost, effective_io_concurrency, maintenance_io_concurrency). Это может быть полезно, если одно из табличных пространств размещено на диске, который быстрее или медленнее остальной дисковой подсистемы. Сжатие рассматривается в разделе Сжатая файловая система (CFS).

Примечания

CREATE TABLESPACE не может быть выполнена внутри блока транзакции.

Примеры

Чтобы создать табличное пространство dbspace, расположенное в файловой системе в каталоге /data/dbs, сначала создайте этот каталог средствами операционной системы на всех узлах и установите для него подходящего владельца (или проверьте, что у пользователя postgres есть право его создать):

mkdir /data/dbs
chown postgres:postgres /data/dbs

Затем выполните команду, собственно создающую табличное пространство:

CREATE TABLESPACE dbspace LOCATION '/data/dbs/ts-{rgid}' WITH (global = true);

Совместимость

CREATE TABLESPACE является расширением Postgres Pro Shardman.

CREATE TABLESPACE

CREATE TABLESPACE — define a new tablespace

Synopsis

For global tablespaces only:
CREATE TABLESPACE tablespace_name
    [ OWNER { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ]
    LOCATION 'template'
    [ WITH (global = true [ tablespace_option = value [, ... ] ) ]

Description

Note that Postgres Pro Shardman only supports global tablspaces.

For sharded systems, when creating a tablespace use {rgid} under location and a keyword with (global).

Postgres Pro Shardman extension of the CREATE TABLESPACE syntax enables creation of a new cluster-wide tablespace. All tablespaces in a Postgres Pro Shardman cluster must be cluster-wide. The cluster-wide tablespace is created on each cluster node with the location derived from the template parameter.

A tablespace allows database administrators to define an alternative location on the file system where the data files containing database objects (such as tables and indexes) can reside. Only superusers and users with the privileges of the pg_create_tablespace role can create tablespaces, but they can assign ownership of tablespaces to non-superusers.

A user with appropriate privileges can pass tablespace_name to CREATE DATABASE, CREATE TABLE, CREATE INDEX or ADD CONSTRAINT to have the data files for these objects stored within the specified tablespace.

Warning

A tablespace cannot be used independently of the cluster in which it is defined; see Section 21.7.

Parameters

TEMPORARY or TEMP

If specified, the tablespace is created as a tablespace where temporary objects, such as temporary tables and indexes on such tables, are located.

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

The name of the user who will own the tablespace. If omitted, defaults to the user executing the command.

directory

The directory that will be used for the tablespace. The directory must exist (CREATE TABLESPACE will not create it), should be empty, and must be owned by the Postgres Pro Shardman system user. The directory must be specified by an absolute path name.

global = true

Specifies that the created tablespace must be global.

tablespace_option

A tablespace parameter to be set or reset. Currently, the only available parameters are seq_page_cost, random_page_cost, effective_io_concurrency, maintenance_io_concurrency, compression, and encryption. Setting cost value for a particular tablespace will override the planner's usual estimate of the cost of reading pages from tables in that tablespace, and how many concurrent I/Os are issued, as established by the configuration parameters of the same name (see seq_page_cost, random_page_cost, effective_io_concurrency, maintenance_io_concurrency). This may be useful if one tablespace is located on a disk which is faster or slower than the remainder of the I/O subsystem. Compression is discussed in the Compressed File System (CFS) section.

Notes

CREATE TABLESPACE cannot be executed inside a transaction block.

Examples

To create a tablespace dbspace under the file system location /data/dbs, first create the directory using operating system facilities on all nodes and set the correct ownership (or ensure that postgres user has permissions to create it):

mkdir /data/dbs
chown postgres:postgres /data/dbs

Then issue the tablespace creation command

CREATE TABLESPACE dbspace LOCATION '/data/dbs/ts-{rgid}' WITH (global = true);

Compatibility

CREATE TABLESPACE is a Postgres Pro Shardman extension.

FAQ