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 TABLESPACEtablespace_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
TEMPORARYorTEMPIf specified, the tablespace is created as a tablespace where temporary objects, such as temporary tables and indexes on such tables, are located.
tablespace_nameThe name of a tablespace to be created. The name cannot begin with
pg_, as such names are reserved for system tablespaces.user_nameThe name of the user who will own the tablespace. If omitted, defaults to the user executing the command.
directoryThe directory that will be used for the tablespace. The directory must exist (
CREATE TABLESPACEwill 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 = trueSpecifies that the created tablespace must be global.
tablespace_optionA 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, andencryption. 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.