Перейти к основному содержимому

ALTER FOREIGN DATA WRAPPER

примечание

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

ALTER FOREIGN DATA WRAPPER — изменение определения внешней оболочки данных.

Синтаксис​

ALTER FOREIGN DATA WRAPPER name
    [ HANDLER handler_function | NO HANDLER ]
    [ VALIDATOR validator_function | NO VALIDATOR ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ]
ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER FOREIGN DATA WRAPPER name RENAME TO new_name

Описание​

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

Только суперпользователи имеют право изменять или владеть внешними оболочками данных.

Параметры​

name
Указывает имя существующей внешней оболочки данных, которая должна быть изменена.
HANDLER handler_function
Указывает новую функцию обработки для внешней оболочки данных.
NO HANDLER
Удаляет текущую функцию обработки.
Примечание

Таблицы, использующие оболочку без обработчика, становятся недоступны для работы.

VALIDATOR validator_function
Назначает новую функцию проверки параметров (валидатор).
Примечание

Ранее заданные параметры оболочки, а также параметры зависимых серверов, сопоставлений пользователей или внешних таблиц окажутся недействительными для нового валидатора. PostgreSQL не проверяет их — пользователь должен самостоятельно убедиться в корректности параметров. Однако параметры, указанные прямо в текущей команде ALTER FOREIGN DATA WRAPPER, будут проверены новым валидатором.

NO VALIDATOR
Удаляет функцию проверки (валидатор) у оболочки.
OPTIONS ([ ADD | SET | DROP ] option ['value'] [, ... ])
Позволяет управлять параметрами оболочки:
  • ADD — добавляет новый параметр (используется по умолчанию, если действие не указано);
  • SET — изменяет значение существующего параметра;
  • DROP — удаляет параметр.

Имена параметров должны быть уникальными. Если назначен валидатор, имена и значения параметров будут проверяться.

new_owner
Задает имя нового владельца внешней оболочки данных.
new_name
Задает новое имя для внешней оболочки данных.

Примеры​

Добавление параметра foo и удаление параметра bar у оболочки dbi:

ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar');

Назначение новой функции проверки bob.myvalidator оболочки dbi:

ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;

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

Команда ALTER FOREIGN DATA WRAPPER соответствует стандарту SQL/MED (ISO/IEC 9075-9), за исключением следующих расширений PostgreSQL: выражения HANDLER, VALIDATOR, OWNER TO и RENAME.

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

CREATE FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER