ALTER EXTENSION#

ALTER EXTENSION
ALTER EXTENSION
Назад НаверхSQL КомандыНачало Далее

ALTER EXTENSION

ALTER EXTENSION — изменить определение расширения

Синтаксис

ALTER EXTENSION name UPDATE [ TO new_version ]
ALTER EXTENSION name SET SCHEMA new_schema
ALTER EXTENSION name ADD member_object
ALTER EXTENSION name DROP member_object

where member_object is:

  ACCESS METHOD object_name |
  AGGREGATE aggregate_name ( aggregate_signature ) |
  CAST (source_type AS target_type) |
  COLLATION object_name |
  CONVERSION object_name |
  DOMAIN object_name |
  EVENT TRIGGER object_name |
  FOREIGN DATA WRAPPER object_name |
  FOREIGN TABLE object_name |
  FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
  MATERIALIZED VIEW object_name |
  OPERATOR operator_name (left_type, right_type) |
  OPERATOR CLASS object_name USING index_method |
  OPERATOR FAMILY object_name USING index_method |
  [ PROCEDURAL ] LANGUAGE object_name |
  PROCEDURE procedure_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
  ROUTINE routine_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
  SCHEMA object_name |
  SEQUENCE object_name |
  SERVER object_name |
  TABLE object_name |
  TEXT SEARCH CONFIGURATION object_name |
  TEXT SEARCH DICTIONARY object_name |
  TEXT SEARCH PARSER object_name |
  TEXT SEARCH TEMPLATE object_name |
  TRANSFORM FOR type_name LANGUAGE lang_name |
  TYPE object_name |
  VIEW object_name

and aggregate_signature is:

* |
[ argmode ] [ argname ] argtype [ , ... ] |
[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]

Описание

ALTER EXTENSION изменяет определение установленного расширения. Существует несколько подформ:

UPDATE

Эта форма обновляет расширение до новой версии. Расширение должно предоставить подходящий скрипт обновления (или серию скриптов), который может изменить установленную версию на запрошенную версию.

SET SCHEMA

Эта форма перемещает объекты расширения в другую схему. Для успешного выполнения этой команды расширение должно быть перемещаемым.

ADD member_object

Эта форма добавляет существующий объект в расширение. Это особенно полезно в скриптах обновления расширения. Объект будет далее рассматриваться как член расширения; в частности, его можно удалить только путем удаления расширения.

DROP member_object

Эта форма удаляет объект-член из расширения. Это особенно полезно в скриптах обновления расширения. Объект не удаляется, а только отсоединяется от расширения.

См. Раздел 35.16 для получения дополнительной информации об этих операциях.

Вы должны быть владельцем расширения, чтобы использовать команду ALTER EXTENSION. Формы ADD/DROP также требуют владения добавляемым/удаляемым объектом.

Параметры

name

Имя установленного расширения.

new_version

Желаемая новая версия расширения. Это может быть указано как идентификатор или строковый литерал. Если не указано, ALTER EXTENSION UPDATE пытается обновиться до той версии, которая указана в файле управления расширением в качестве версии по умолчанию.

new_schema

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

object_name
aggregate_name
function_name
operator_name
procedure_name
routine_name

Имя объекта, который будет добавлен или удален из расширения. Имена таблиц, агрегаты, домены, внешние таблицы, функции, операторы, классы операторов, семейства операторов, процедуры, процедуры, последовательности, объекты текстового поиска, типы и представления могут быть уточнены с указанием схемы.

source_type

Имя исходного типа данных приведения.

target_type

Имя целевого типа данных приведения.

argmode

Режим аргумента функции, процедуры или агрегата: IN, OUT, INOUT или VARIADIC. Если не указано, по умолчанию используется IN. Обратите внимание, что команда ALTER EXTENSION фактически не обращает внимания на аргументы OUT, поскольку только входные аргументы необходимы для определения идентификатора функции. Поэтому достаточно перечислить аргументы IN, INOUT и VARIADIC.

argname

Имя функции, процедуры или аргумента агрегата. Обратите внимание, что ALTER EXTENSION на самом деле не обращает внимания на имена аргументов, поскольку для определения идентификатора функции требуются только типы данных аргументов.

argtype

Тип данных аргумента функции, процедуры или агрегата.

left_type
right_type

Тип(ы) данных аргументов оператора (опционально с указанием схемы). Для отсутствующего аргумента префиксного оператора напишите NONE.

PROCEDURAL

Это шумовое слово.

type_name

Имя типа данных преобразования.

lang_name

Имя языка преобразования.

Примеры

Для обновления расширения 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 - это расширение Tantor BE.

Назад Наверх Далее
ALTER EVENT TRIGGER Начало ALTER FOREIGN DATA WRAPPER