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элемент_объектЭта форма удаляет из расширения включённый в него объект. В основном это применяется в скриптах обновления расширений. Сам объект при этом не уничтожается, а только отделяется от расширения.
Подробнее эти операции описаны в Разделе 40.17.
Чтобы выполнить команду 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 является расширением Postgres Pro.
См. также
CREATE EXTENSION, DROP EXTENSIONPart VII. Internals
This part contains assorted information that might be of use to Postgres Pro developers.
Table of Contents
- 48. Overview of Postgres Pro Internals
- 49. System Catalogs
- 49.1. Overview
- 49.2.
pg_aggregate - 49.3.
pg_am - 49.4.
pg_amop - 49.5.
pg_amproc - 49.6.
pg_attrdef - 49.7.
pg_attribute - 49.8.
pg_authid - 49.9.
pg_auth_members - 49.10.
pg_cast - 49.11.
pg_class - 49.12.
pg_collation - 49.13.
pg_constraint - 49.14.
pg_conversion - 49.15.
pg_database - 49.16.
pg_db_role_setting - 49.17.
pg_default_acl - 49.18.
pg_depend - 49.19.
pg_description - 49.20.
pg_enum - 49.21.
pg_event_trigger - 49.22.
pg_extension - 49.23.
pg_foreign_data_wrapper - 49.24.
pg_foreign_server - 49.25.
pg_foreign_table - 49.26.
pg_index - 49.27.
pg_inherits - 49.28.
pg_language - 49.29.
pg_largeobject - 49.30.
pg_largeobject_metadata - 49.31.
pg_namespace - 49.32.
pg_opclass - 49.33.
pg_operator - 49.34.
pg_opfamily - 49.35.
pg_pltemplate - 49.36.
pg_policy - 49.37.
pg_proc - 49.38.
pg_range - 49.39.
pg_replication_origin - 49.40.
pg_rewrite - 49.41.
pg_seclabel - 49.42.
pg_shdepend - 49.43.
pg_shdescription - 49.44.
pg_shseclabel - 49.45.
pg_statistic - 49.46.
pg_tablespace - 49.47.
pg_transform - 49.48.
pg_trigger - 49.49.
pg_ts_config - 49.50.
pg_ts_config_map - 49.51.
pg_ts_dict - 49.52.
pg_ts_parser - 49.53.
pg_ts_template - 49.54.
pg_type - 49.55.
pg_user_mapping - 49.56. System Views
- 49.57.
pg_available_extensions - 49.58.
pg_available_extension_versions - 49.59.
pg_cursors - 49.60.
pg_file_settings - 49.61.
pg_group - 49.62.
pg_indexes - 49.63.
pg_locks - 49.64.
pg_matviews - 49.65.
pg_policies - 49.66.
pg_prepared_statements - 49.67.
pg_prepared_xacts - 49.68.
pg_replication_origin_status - 49.69.
pg_replication_slots - 49.70.
pg_roles - 49.71.
pg_rules - 49.72.
pg_seclabels - 49.73.
pg_settings - 49.74.
pg_shadow - 49.75.
pg_stats - 49.76.
pg_tables - 49.77.
pg_timezone_abbrevs - 49.78.
pg_timezone_names - 49.79.
pg_user - 49.80.
pg_user_mappings - 49.81.
pg_views
- 50. Frontend/Backend Protocol
- 51. Postgres Pro Coding Conventions
- 52. Native Language Support
- 53. Writing A Procedural Language Handler
- 54. Writing A Foreign Data Wrapper
- 55. Writing A Table Sampling Method
- 56. Writing A Custom Scan Provider
- 57. Genetic Query Optimizer
- 58. Index Access Method Interface Definition
- 59. GiST Indexes
- 60. SP-GiST Indexes
- 61. GIN Indexes
- 62. BRIN Indexes
- 63. Database Physical Storage
- 64. BKI Backend Interface
- 65. How the Planner Uses Statistics