ALTER SERVER#

ALTER SERVER

ALTER SERVER

ALTER SERVER — изменить определение внешнего сервера

Синтаксис

ALTER SERVER name [ VERSION 'new_version' ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ]
ALTER SERVER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SERVER name RENAME TO new_name

Описание

ALTER SERVER изменяет определение внешнего сервера. Первая форма изменяет строку версии сервера или общие параметры сервера (требуется хотя бы одно предложение). Вторая форма изменяет владельца сервера.

Чтобы изменить сервер, вы должны быть владельцем сервера. Кроме того, чтобы изменить владельца, вы должны иметь возможность SET ROLE на новую роль владельца, и вы должны иметь привилегию USAGE на обертку внешних данных сервера. (Обратите внимание, что суперпользователи автоматически удовлетворяют всем этим критериям.)

Параметры

name

Имя существующего сервера.

new_version

Новая версия сервера.

OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )

Измените параметры сервера. ADD, SET и DROP указывают действие, которое должно быть выполнено. Если явно не указана операция, предполагается ADD. Имена параметров должны быть уникальными; имена и значения также проверяются с использованием библиотеки обертки внешних данных сервера.

new_owner

Имя пользователя нового владельца внешнего сервера.

new_name

Новое имя для внешнего сервера.

Примеры

Изменить сервер foo, добавить параметры подключения:

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

Изменить сервер foo, изменить версию, изменить опцию host:

ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');

Совместимость

ALTER SERVER соответствует ISO/IEC 9075-9 (SQL/MED). Формы OWNER TO и RENAME являются расширениями PostgreSQL.

См. также

CREATE SERVER, DROP SERVER