Русский

CREATE SERVER

Определяет новый внешний сервер.

Обзор

CREATE SERVER server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
    FOREIGN DATA WRAPPER fdw_name
    [ OPTIONS ( [ mpp_execute { 'master' | 'any' | 'all segments' } [, ] ] option 'value' [, ... ] ) ]

Описание

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

Внешние серверы обычно инкапсулируют внешние обёртки данных для доступа к информации о подключении из внешних источников данных. Другая пользовательская информация о подключении может быть задана с помощью отображения пользователя (user mapping).

Для создания сервера требуются привилегии USAGE на указанную внешнюю обёртку данных.

Параметры

server_name

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

server_type

Необязательный тип сервера, который может быть полезен для внешних обёрток данных.

server_version

Необязательная версия сервера, которая может быть полезна для внешних обёрток данных.

fdw_name

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

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

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

mpp_execute { 'master' | 'any' | 'all segments' }

Параметр, указывающий хост, с которого внешняя обёртка данных запрашивает данные:
- master (значение по умолчанию) — Запрашивать данные с хоста Master.
- any — Запрашивать данные с хоста Master или любого Segment, в зависимости от того, какой путь является менее затратным.
- all segments — Запрашивать данные со всех сегментов. Для поддержки этого значения внешняя обёртка данных должна иметь политику сопоставления сегментов с данными.
Параметр mpp_execute может быть указан в нескольких командах: CREATE FOREIGN TABLE, CREATE SERVER и CREATE FOREIGN DATA WRAPPER. Настройки внешней таблицы имеют приоритет над настройками внешнего сервера, за которыми следуют настройки внешней обёртки данных.

Примечание

При использовании модуля dblink (см. dblink) имя внешнего сервера можно использовать как параметр функции dblink_connect(), чтобы передать параметры подключения. Чтобы использовать сервер таким образом, необходимо иметь привилегии USAGE на внешнем сервере.

Пример

Создание внешнего сервера с именем myserver, использующего внешнюю обёртку данных pgsql и содержащего параметры подключения:

CREATE SERVER myserver FOREIGN DATA WRAPPER pgsql
    OPTIONS (host 'foo', dbname 'foodb', port '5432');

Соответствие стандартам

CREATE SERVER соответствует стандарту ISO/IEC 9075-9 (SQL/MED).

См. также

ALTER SERVER, DROP SERVER

← Предыдущая

CREATE_SEQUENCE

CREATE_TABLE

Русский English 简体中文