ok
Direktori : /opt/alt/postgresql11/usr/share/man/man7/ |
Current File : //opt/alt/postgresql11/usr/share/man/man7/CREATE_TABLESPACE.7 |
'\" t .\" Title: CREATE TABLESPACE .\" Author: The PostgreSQL Global Development Group .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> .\" Date: 2017-11-06 .\" Manual: PostgreSQL 9.2.24 Documentation .\" Source: PostgreSQL 9.2.24 .\" Language: English .\" .TH "CREATE TABLESPACE" "7" "2017-11-06" "PostgreSQL 9.2.24" "PostgreSQL 9.2.24 Documentation" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" CREATE_TABLESPACE \- define a new tablespace .\" CREATE TABLESPACE .SH "SYNOPSIS" .sp .nf CREATE TABLESPACE \fItablespace_name\fR [ OWNER \fIuser_name\fR ] LOCATION \*(Aq\fIdirectory\fR\*(Aq .fi .SH "DESCRIPTION" .PP \fBCREATE TABLESPACE\fR registers a new cluster\-wide tablespace\&. The tablespace name must be distinct from the name of any existing tablespace in the database cluster\&. .PP A tablespace allows superusers to define an alternative location on the file system where the data files containing database objects (such as tables and indexes) can reside\&. .PP A user with appropriate privileges can pass \fItablespace_name\fR to \fBCREATE DATABASE\fR, \fBCREATE TABLE\fR, \fBCREATE INDEX\fR or \fBADD CONSTRAINT\fR to have the data files for these objects stored within the specified tablespace\&. .SH "PARAMETERS" .PP \fItablespace_name\fR .RS 4 The name of a tablespace to be created\&. The name cannot begin with pg_, as such names are reserved for system tablespaces\&. .RE .PP \fIuser_name\fR .RS 4 The name of the user who will own the tablespace\&. If omitted, defaults to the user executing the command\&. Only superusers can create tablespaces, but they can assign ownership of tablespaces to non\-superusers\&. .RE .PP \fIdirectory\fR .RS 4 The directory that will be used for the tablespace\&. The directory should be empty and must be owned by the PostgreSQL system user\&. The directory must be specified by an absolute path name\&. .RE .SH "NOTES" .PP Tablespaces are only supported on systems that support symbolic links\&. .PP \fBCREATE TABLESPACE\fR cannot be executed inside a transaction block\&. .SH "EXAMPLES" .PP Create a tablespace dbspace at /data/dbs: .sp .if n \{\ .RS 4 .\} .nf CREATE TABLESPACE dbspace LOCATION \*(Aq/data/dbs\*(Aq; .fi .if n \{\ .RE .\} .PP Create a tablespace indexspace at /data/indexes owned by user genevieve: .sp .if n \{\ .RS 4 .\} .nf CREATE TABLESPACE indexspace OWNER genevieve LOCATION \*(Aq/data/indexes\*(Aq; .fi .if n \{\ .RE .\} .SH "COMPATIBILITY" .PP \fBCREATE TABLESPACE\fR is a PostgreSQL extension\&. .SH "SEE ALSO" CREATE DATABASE (\fBCREATE_DATABASE\fR(7)), CREATE TABLE (\fBCREATE_TABLE\fR(7)), CREATE INDEX (\fBCREATE_INDEX\fR(7)), DROP TABLESPACE (\fBDROP_TABLESPACE\fR(7)), ALTER TABLESPACE (\fBALTER_TABLESPACE\fR(7))