CREATE SERVER#

Примечание

Эта страница переведена при помощи нейросети GigaChat.

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

Смотрите также#

ALTER SERVER, DROP SERVER, CREATE FOREIGN WRAPPER, CREATE FOREIGN TABLE, CREATE USER MAPPING