ALTER EXTENSION
ALTER EXTENSION — изменить определение расширения
Синтаксис
ALTER EXTENSION имя UPDATE [ TO новая_версия ]
ALTER EXTENSION имя SET SCHEMA новая_схема
ALTER EXTENSION имя ADD член_объект
ALTER EXTENSION имя DROP член_объект
где членом_объектом может быть:
ACCESS METHOD имя_объекта |
AGGREGATE имя_агрегата ( сигнатура_агрегата ) |
CAST (исходный_тип AS целевой_тип) |
COLLATION имя_объекта |
CONVERSION имя_объекта |
DOMAIN имя_объекта |
EVENT TRIGGER имя_объекта |
FOREIGN DATA WRAPPER имя_объекта |
FOREIGN TABLE имя_объекта |
FUNCTION имя_функции [ ( [ [ режим_аргумента ] [ имя_аргумента ] тип_аргумента [, ...] ] ) ] |
MATERIALIZED VIEW имя_объекта |
OPERATOR имя_оператора (тип_слева, тип_справа) |
OPERATOR CLASS имя_объекта USING индексный_метод |
OPERATOR FAMILY имя_объекта USING индексный_метод |
[ PROCEDURAL ] LANGUAGE имя_объекта |
PROCEDURE имя_процедуры [ ( [ [ режим_аргумента ] [ имя_аргумента ] тип_аргумента [, ...] ] ) ] |
ROUTINE имя_подпрограммы [ ( [ [ режим_аргумента ] [ имя_аргумента ] тип_аргумента [, ...] ] ) ] |
SCHEMA имя_объекта |
SEQUENCE имя_объекта |
SERVER имя_объекта |
TABLE имя_объекта |
TEXT SEARCH CONFIGURATION имя_объекта |
TEXT SEARCH DICTIONARY имя_объекта |
TEXT SEARCH PARSER имя_объекта |
TEXT SEARCH TEMPLATE имя_объекта |
TRANSFORM FOR имя_типа LANGUAGE имя_языка |
TYPE имя_объекта |
VIEW имя_объекта
а сигнатурой_агрегата является:
* |
[ режим_аргумента ] [ имя_аргумента ] тип_аргумента [ , ... ] |
[ [ режим_аргумента ] [ имя_аргумента ] тип_аргумента [ , ... ] ] ORDER BY [ режим_аргумента ] [ имя_аргумента ] тип_аргумента [ , ... ]
Описание
Команда ALTER EXTENSION изменяет определение установленного расширения. Она
имеет несколько форм:
UPDATE
Эта форма обновляет расширение до более новой версии. Расширение должно предоставить подходящий скрипт (или набор скриптов) обновления, который сможет изменить текущую установленную версию на требуемую.
SET SCHEMA
Эта форма перемещает объекты расширения в другую схему. Для успешного выполнения этой команды расширение должно быть перемещаемым.
ADD член_объект
Эта форма добавляет к расширению существующий объект. Указание в основном используется в скриптах обновления расширений. Объект впоследствии будет рассматриваться как часть расширения; в частности, он может быть удален только вместе с расширением.
DROP член_объект
Эта форма удаляет объект из расширения. Указание в основном используется в скриптах обновления расширений. Объект при этом не удаляется, а только отделяется от расширения.
Подробную информацию об этих операциях см. в разделе Упаковка связанных объектов в расширение.
Чтобы использовать команду ALTER EXTENSION, нужно быть владельцем соответствующего
расширения. Для форм ADD/DROP требуется также быть владельцем добавляемого/
удаляемого объекта.
Параметры
имя
Имя установленного расширения.
новая_версия
Запрашиваемая новая версия расширения. Ее можно указать в виде идентификатора
или строки. Если версия не указана, ALTER EXTENSION UPDATE попытается обновить
расширение до версии по умолчанию в управляющем файле расширения.
новая_схема
Новая схема для расширения.
имя_объекта
имя_агрегата
имя_функции
имя_оператора
имя_процедуры
имя_подпрограммы
Имя объекта, который будет добавлен или удален из расширения. Имена таблиц, агрегатов, доменов, сторонних таблиц, функций, операторов, классов операторов, семейств операторов, процедур, подпрограмм, последовательностей, объектов текстового поиска, типов и представлений могут дополняться именем схемы.
исходный_тип
Имя исходного типа данных для приведения.
целевой_тип
Имя целевого типа данных для приведения.
режим_аргумента
Режим аргумента функции, процедуры или агрегата: IN (входной), OUT
(выходной), INOUT (входной-выходной) или VARIADIC (переменный). Если этот
параметр опущен, по умолчанию установлен режим IN. Обратите внимание, что
фактически ALTER EXTENSION не обращает никакого внимания на аргументы OUT,
так как для идентификации функции нужны только входные аргументы. Поэтому достаточно
перечислить аргументы IN, INOUT и VARIADIC.
имя_аргумента
Имя аргумента функции, процедуры или агрегата. Обратите внимание, что фактически
ALTER EXTENSION не обращает никакого внимания на имена аргументов, поскольку
для идентификации функции необходимы только типы данных аргументов.
тип_аргумента
Тип данных аргумента функции, процедуры или агрегата.
тип_слева
тип_справа
Типы данных аргументов оператора (могут быть дополнены схемой). При отсутствии аргумента префиксного или постфиксного оператора укажите вместо типа NONE.
PROCEDURAL
Неучитываемое слово.
имя_типа
Имя типа данных, для которого делается трансформация.
имя_языка
Имя языка, для которого делается трансформация.
Примеры
Обновление расширения hstore до версии 2.0:
ALTER EXTENSION hstore UPDATE TO '2.0';
Смена схемы расширения hstore на utils:
ALTER EXTENSION hstore SET SCHEMA utils;
Добавление существующей функции в расширение hstore:
ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);
Совместимость
Команда ALTER EXTENSION является расширением QHB.