ALTER SERVER
ALTER SERVER — изменить определение стороннего сервера
Синтаксис
ALTER SERVERимя
[ VERSION 'новая_версия
' ] [ OPTIONS ( [ ADD | SET | DROP ]параметр
['значение
'] [, ... ] ) ] ALTER SERVERимя
OWNER TO {новый_владелец
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER SERVERимя
RENAME TOновое_имя
Описание
ALTER SERVER
изменяет определение стороннего сервера. Первая форма меняет строку версии сервера или общие параметры сервера (требуется минимум одно предложение). Вторая форма меняет владельца сервера.
Изменить свойства сервера может только его владелец. Чтобы изменить владельца, необходимо иметь право SET ROLE
для новой роли-владельца и, кроме того, иметь право USAGE
для обёртки сторонних данных сервера. (Суперпользователи удовлетворяют всем этим условиям автоматически.)
Параметры
имя
Имя существующего сервера.
новая_версия
Новая версия сервера.
OPTIONS ( [ ADD | SET | DROP ]
параметр
['значение
'] [, ... ] )Эти формы изменяют параметры сервера. Указания
ADD
,SET
иDROP
определяют выполняемое действие (добавление, установка и удаление, соответственно). Если действие не задано явно, подразумеваетсяADD
. Имена параметров должны быть уникальными, они вместе со значениями также проверяются библиотекой обёртки сторонних данных.новый_владелец
Имя пользователя, назначаемого новым владельцем стороннего сервера.
новое_имя
Новое имя стороннего сервера.
Примеры
Изменение свойств сервера 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.