ok
Direktori : /opt/alt/postgresql11/usr/share/man/man7/ |
Current File : //opt/alt/postgresql11/usr/share/man/man7/CREATE_SERVER.7 |
'\" t .\" Title: CREATE SERVER .\" 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 SERVER" "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_SERVER \- define a new foreign server .\" CREATE SERVER .SH "SYNOPSIS" .sp .nf CREATE SERVER \fIserver_name\fR [ TYPE \*(Aq\fIserver_type\fR\*(Aq ] [ VERSION \*(Aq\fIserver_version\fR\*(Aq ] FOREIGN DATA WRAPPER \fIfdw_name\fR [ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) ] .fi .SH "DESCRIPTION" .PP \fBCREATE SERVER\fR defines a new foreign server\&. The user who defines the server becomes its owner\&. .PP A foreign server typically encapsulates connection information that a foreign\-data wrapper uses to access an external data resource\&. Additional user\-specific connection information may be specified by means of user mappings\&. .PP The server name must be unique within the database\&. .PP Creating a server requires USAGE privilege on the foreign\-data wrapper being used\&. .SH "PARAMETERS" .PP \fIserver_name\fR .RS 4 The name of the foreign server to be created\&. .RE .PP \fIserver_type\fR .RS 4 Optional server type\&. .RE .PP \fIserver_version\fR .RS 4 Optional server version\&. .RE .PP \fIfdw_name\fR .RS 4 The name of the foreign\-data wrapper that manages the server\&. .RE .PP OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) .RS 4 This clause specifies the options for the server\&. The options typically define the connection details of the server, but the actual names and values are dependent on the server\*(Aqs foreign\-data wrapper\&. .RE .SH "NOTES" .PP When using the dblink module (see dblink), the foreign server name can be used as an argument of the \fBdblink_connect\fR(3) function to indicate the connection parameters\&. See also there for more examples\&. It is necessary to have the USAGE privilege on the foreign server to be able to use it in this way\&. .SH "EXAMPLES" .PP Create a server foo that uses the built\-in foreign\-data wrapper default: .sp .if n \{\ .RS 4 .\} .nf CREATE SERVER foo FOREIGN DATA WRAPPER "default"; .fi .if n \{\ .RE .\} .PP Create a server myserver that uses the foreign\-data wrapper pgsql: .sp .if n \{\ .RS 4 .\} .nf CREATE SERVER myserver FOREIGN DATA WRAPPER pgsql OPTIONS (host \*(Aqfoo\*(Aq, dbname \*(Aqfoodb\*(Aq, port \*(Aq5432\*(Aq); .fi .if n \{\ .RE .\} .SH "COMPATIBILITY" .PP \fBCREATE SERVER\fR conforms to ISO/IEC 9075\-9 (SQL/MED)\&. .SH "SEE ALSO" ALTER SERVER (\fBALTER_SERVER\fR(7)), DROP SERVER (\fBDROP_SERVER\fR(7)), CREATE FOREIGN DATA WRAPPER (\fBCREATE_FOREIGN_DATA_WRAPPER\fR(7)), CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7))