CREATE SERVER#

CREATE SERVER

CREATE SERVER

CREATE SERVER — определить новый внешний сервер

Синтаксис

CREATE SERVER [ IF NOT EXISTS ] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
    FOREIGN DATA WRAPPER fdw_name
    [ OPTIONS ( option 'value' [, ... ] ) ]

Описание

CREATE SERVER определяет новый внешний сервер. Пользователь, который определяет сервер, становится его владельцем.

Внешний сервер обычно инкапсулирует информацию о подключении, которую использует внешний обертыватель данных для доступа к внешнему ресурсу данных. Дополнительная информация о подключении, специфичная для пользователя, может быть указана с помощью отображений пользователей.

Имя сервера должно быть уникальным в пределах базы данных.

Создание сервера требует наличия привилегии USAGE на используемом внешнем обертке данных.

Параметры

IF NOT EXISTS

Не генерировать ошибку, если сервер с таким же именем уже существует. В этом случае будет выдано уведомление. Обратите внимание, что не гарантируется, что существующий сервер будет похож на тот, который был бы создан.

server_name

Имя внешнего сервера, который будет создан.

server_type

Опциональный тип сервера, потенциально полезный для внешних оберток данных.

server_version

Опциональная версия сервера, потенциально полезная для внешних оберток данных.

fdw_name

Имя обертки внешних данных, управляющей сервером.

OPTIONS ( option 'value' [, ... ] )

Это предложение определяет параметры для сервера. Обычно параметры определяют детали подключения к серверу, но фактические имена и значения зависят от внешнего обертки данных сервера.

Примечания

При использовании модуля 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).