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).