CREATE SERVER#
CREATE SERVER
CREATE SERVER — определить новый внешний сервер
Синтаксис
CREATE SERVER [ IF NOT EXISTS ]server_name
[ TYPE 'server_type
' ] [ VERSION 'server_version
' ] FOREIGN DATA WRAPPERfdw_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).