CREATE SERVER
Синтаксис
CREATE SERVER имя_сервера [ TYPE 'тип_сервера' ] [ VERSION 'версия_сервера' ]
FOREIGN DATA WRAPPER имя_обёртки_сторонних_данных
[ OPTIONS ( параметр 'значение' [, ... ] ) ]Описание
CREATE SERVER создаёт сторонний сервер. Владельцем сервера становится создавший его пользователь.
Определение стороннего сервера обычно включает информацию о подключении, которую использует обёртка сторонних данных для доступа к внешнему ресурсу. Определяя сопоставления пользователей, можно установить и другие параметры подключения, связанные с пользователями.
Имя сервера должно быть уникальным в базе данных.
Для создания сервера требуется право USAGE для обёртки сторонних данных.
Параметры
- имя_сервера
Имя создаваемого стороннего сервера.
- тип_сервера
Необязательный тип сервера, может быть полезен для обёрток сторонних данных.
- версия_сервера
Необязательная версия сервера, может быть полезна для обёрток сторонних данных.
- имя_обёртки_сторонних_данных
Имя обёртки сторонних данных, управляющей сервером.
- OPTIONS ( параметр 'значение' [, ... ] )
Это предложение определяет параметры сервера. Эти параметры обычно задают свойства подключения к серверу; их конкретные имена и значения зависят от обёртки сторонних данных.
Замечания
При использовании модуля dblink имя стороннего сервера может служить аргументом функции dblink_connect, определяющим параметры подключения. Для такого варианта использования необходимо иметь право USAGE для стороннего сервера.
Примеры
Создание сервера myserver, доступного через обёртку postgres_fdw:
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');
За подробностями обратитесь к postgres_fdw.
См. также
ALTER SERVER, DROP SERVER, CREATE FOREIGN DATA WRAPPER, CREATE FOREIGN TABLE, CREATE USER MAPPING| Пред. | Начало | След. |
| CREATE SEQUENCE | Уровень выше | CREATE TABLE |
CREATE SERVER
Synopsis
CREATE SERVER server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
FOREIGN DATA WRAPPER fdw_name
[ OPTIONS ( option 'value' [, ... ] ) ]Description
CREATE SERVER defines a new foreign server. The user who defines the server becomes its owner.
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.
The server name must be unique within the database.
Creating a server requires USAGE privilege on the foreign-data wrapper being used.
Parameters
- server_name
The name of the foreign server to be created.
- server_type
Optional server type, potentially useful to foreign-data wrappers.
- server_version
Optional server version, potentially useful to foreign-data wrappers.
- fdw_name
The name of the foreign-data wrapper that manages the server.
- OPTIONS ( option 'value' [, ... ] )
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's foreign-data wrapper.
Notes
When using the dblink module, a foreign server's name can be used as an argument of the dblink_connect function to indicate the connection parameters. It is necessary to have the USAGE privilege on the foreign server to be able to use it in this way.
Examples
Create a server myserver that uses the foreign-data wrapper postgres_fdw:
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');
See postgres_fdw for more details.