CREATE SERVER
CREATE SERVER — создать сторонний сервер
Синтаксис
CREATE SERVER [ IF NOT EXISTS ]имя_сервера[ TYPE 'тип_сервера' ] [ VERSION 'версия_сервера' ] FOREIGN DATA WRAPPERимя_обёртки_сторонних_данных[ OPTIONS (параметр'значение' [, ... ] ) ]
Описание
CREATE SERVER создаёт сторонний сервер. Владельцем сервера становится создавший его пользователь.
Определение стороннего сервера обычно включает информацию о подключении, которую использует обёртка сторонних данных для доступа к внешнему ресурсу. Определяя сопоставления пользователей, можно установить и другие параметры подключения, связанные с пользователями.
Имя сервера должно быть уникальным в базе данных.
Для создания сервера требуется право USAGE для обёртки сторонних данных.
Параметры
IF NOT EXISTSНе считать ошибкой, если сервер с таким именем уже существует. В этом случае будет выдано замечание. Заметьте, что нет никакой гарантии, что существующий сервер как-то соотносится с тем, который мог бы быть создан.
имя_сервераИмя создаваемого стороннего сервера.
тип_сервераНеобязательный тип сервера, может быть полезен для обёрток сторонних данных.
версия_сервераНеобязательная версия сервера, может быть полезна для обёрток сторонних данных.
имя_обёртки_сторонних_данныхИмя обёртки сторонних данных, управляющей сервером.
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).