CREATE SERVER
CREATE SERVER — создать сторонний сервер
Синтаксис
CREATE SERVER [ IF NOT EXISTS ]имя_сервера[ TYPE 'тип_сервера' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPERимя_обёртки_сторонних_данных[ OPTIONS (параметр'значение' [, ... ] ) ]
Описание
CREATE SERVER создаёт сторонний сервер. Владельцем сервера становится создавший его пользователь.
Определение стороннего сервера обычно включает информацию о подключении, которую использует обёртка сторонних данных для доступа к внешнему ресурсу. Определяя сопоставления пользователей, можно установить и другие параметры подключения, связанные с пользователями.
Имя сервера должно быть уникальным в базе данных.
Для создания сервера требуется право USAGE для обёртки сторонних данных.
Параметры
IF NOT EXISTSНе считать ошибкой, если сервер с таким именем уже существует. В этом случае будет выдано замечание. Заметьте, что нет никакой гарантии, что существующий сервер как-то соотносится с тем, который мог бы быть создан.
имя_сервераИмя создаваемого стороннего сервера.
тип_сервераНеобязательный тип сервера, может быть полезен для обёрток сторонних данных.
server_versionНеобязательная версия сервера, может быть полезна для обёрток сторонних данных.
имя_обёртки_сторонних_данныхИмя обёртки сторонних данных, управляющей сервером.
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.
Совместимость
CREATE SERVER соответствует стандарту ISO/IEC 9075-9 (SQL/MED).
CREATE SERVER
CREATE SERVER — define a new foreign server
Synopsis
CREATE SERVER [ IF NOT EXISTS ]server_name[ TYPE 'server_type' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPERfdw_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
IF NOT EXISTSDo not throw an error if a server with the same name already exists. A notice is issued in this case. Note that there is no guarantee that the existing server is anything like the one that would have been created.
server_nameThe name of the foreign server to be created.
server_typeOptional server type, potentially useful to foreign-data wrappers.
server_versionOptional server version, potentially useful to foreign-data wrappers.
fdw_nameThe 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.
If the foreign server supports sort pushdown, it is necessary for it to have the same sort ordering as the local server.
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.
Compatibility
CREATE SERVER conforms to ISO/IEC 9075-9 (SQL/MED).
