ALTER PROCEDURE
ALTER PROCEDURE — изменить определение процедуры
СинтакÑиÑ
ALTER PROCEDUREимÑ[ ( [ [режим_аргумента] [имÑ_аргумента]тип_аргумента[, ...] ] ) ]дейÑтвие[ ... ] [ RESTRICT ] ALTER PROCEDUREимÑ[ ( [ [режим_аргумента] [имÑ_аргумента]тип_аргумента[, ...] ] ) ] RENAME TOновое_имÑALTER PROCEDUREимÑ[ ( [ [режим_аргумента] [имÑ_аргумента]тип_аргумента[, ...] ] ) ] OWNER TO {новый_владелец| CURRENT_USER | SESSION_USER } ALTER PROCEDUREимÑ[ ( [ [режим_аргумента] [имÑ_аргумента]тип_аргумента[, ...] ] ) ] SET SCHEMAноваÑ_ÑхемаALTER PROCEDUREимÑ[ ( [ [режим_аргумента] [имÑ_аргумента]тип_аргумента[, ...] ] ) ] DEPENDS ON EXTENSIONимÑ_раÑширениÑГдедейÑтвиеможет быть Ñледующим: [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER SETпараметр_конфигурации{ TO | = } {значение| DEFAULT } SETпараметр_конфигурацииFROM CURRENT RESETпараметр_конфигурацииRESET ALL
ОпиÑание
ALTER PROCEDURE изменÑет определение процедуры.
Выполнить ALTER PROCEDURE может только владелец процедуры. Чтобы Ñменить Ñхему процедуры, необходимо также иметь право CREATE в новой Ñхеме. Чтобы Ñменить владельца, требуетÑÑ Ñ‚Ð°ÐºÐ¶Ðµ быть непоÑредÑтвенным или опоÑредованным членом новой роли, а Ñта роль должна иметь право CREATE в Ñхеме предÑтавлениÑ. (С таким ограничениÑми при Ñмене владельца не проиÑходит ничего такого, что Ð½ÐµÐ»ÑŒÐ·Ñ Ð±Ñ‹Ð»Ð¾ бы Ñделать, Ð¸Ð¼ÐµÑ Ð¿Ñ€Ð°Ð²Ð¾ удалить и вновь Ñоздать процедуру. Однако Ñуперпользователь может Ñменить владельца процедуры в любом Ñлучае.)
Параметры
имÑÐ˜Ð¼Ñ ÑущеÑтвующей процедуры (возможно, дополненное Ñхемой). ЕÑли ÑпиÑок аргументов не указан, Ð¸Ð¼Ñ Ð¿Ñ€Ð¾Ñ†ÐµÐ´ÑƒÑ€Ñ‹ должно быть уникальным в её Ñхеме.
режим_аргументаРежим аргумента:
INилиVARIADIC. По умолчанию подразумеваетÑÑIN.имÑ_Ð°Ñ€Ð³ÑƒÐ¼ÐµÐ½Ñ‚Ð°Ð˜Ð¼Ñ Ð°Ñ€Ð³ÑƒÐ¼ÐµÐ½Ñ‚Ð°. Заметьте, что на Ñамом деле
ALTER PROCEDUREне обращает внимание на имена аргументов, так как Ð´Ð»Ñ Ð¾Ð´Ð½Ð¾Ð·Ð½Ð°Ñ‡Ð½Ð¾Ð¹ идентификации процедуры доÑтаточно только типов аргументов.тип_аргументаТип данных аргументов процедуры (возможно, дополненный именем Ñхемы), еÑли таковые имеютÑÑ.
новое_имÑÐовое Ð¸Ð¼Ñ Ð¿Ñ€Ð¾Ñ†ÐµÐ´ÑƒÑ€Ñ‹.
новый_владелецÐовый владелец процедуры. Заметьте, что еÑли процедура помечена как
SECURITY DEFINER, в дальнейшем она будет выполнÑÑ‚ÑŒÑÑ Ð¾Ñ‚ имени нового владельца.новаÑ_ÑхемаÐÐ¾Ð²Ð°Ñ Ñхема процедуры.
имÑ_раÑширениÑÐ˜Ð¼Ñ Ñ€Ð°ÑширениÑ, от которого будет завиÑеть процедура.
[EXTERNAL] SECURITY INVOKER[EXTERNAL] SECURITY DEFINERУÑтанавливает, ÑвлÑетÑÑ Ð»Ð¸ процедура определÑющей контекÑÑ‚ безопаÑноÑти. Ключевое Ñлово
EXTERNALигнорируетÑÑ Ð´Ð»Ñ ÑоответÑÑ‚Ð²Ð¸Ñ Ñтандарту SQL. Подробнее Ñто ÑвойÑтво опиÑано в CREATE PROCEDURE.параметр_конфигурациизначениеДобавлÑет или изменÑет уÑтановку параметра конфигурации, выполнÑемую при вызове процедуры. ЕÑли задано
значениеDEFAULTили, что равнозначно, выполнÑетÑÑ Ð´ÐµÐ¹ÑтвиеRESET, локальное переопределение Ð´Ð»Ñ Ð¿Ñ€Ð¾Ñ†ÐµÐ´ÑƒÑ€Ñ‹ удалÑетÑÑ Ð¸ процедура выполнÑетÑÑ Ñо значением, уÑтановленным в окружении. Ð”Ð»Ñ ÑƒÐ´Ð°Ð»ÐµÐ½Ð¸Ñ Ð²Ñех уÑтановок параметров Ð´Ð»Ñ Ð´Ð°Ð½Ð½Ð¾Ð¹ процедуры укажитеRESET ALL.SET FROM CURRENTуÑтанавливает Ð´Ð»Ñ Ð¿Ð¾Ñледующих вызовов процедуры значение параметра, дейÑтвующее в момент выполнениÑALTER PROCEDURE.За подробными ÑведениÑми об именах и значениÑÑ… параметров обратитеÑÑŒ к SET и Главе 19.
RESTRICTИгнорируетÑÑ Ð´Ð»Ñ ÑоответÑÑ‚Ð²Ð¸Ñ Ñтандарту SQL.
Примеры
Переименование процедуры insert_data Ñ Ð´Ð²ÑƒÐ¼Ñ Ð°Ñ€Ð³ÑƒÐ¼ÐµÐ½Ñ‚Ð°Ð¼Ð¸ типа integer в insert_record:
ALTER PROCEDURE insert_data(integer, integer) RENAME TO insert_record;
Смена владельца процедуры insert_data Ñ Ð´Ð²ÑƒÐ¼Ñ Ð°Ñ€Ð³ÑƒÐ¼ÐµÐ½Ñ‚Ð°Ð¼Ð¸ типа integer на joe:
ALTER PROCEDURE insert_data(integer, integer) OWNER TO joe;
Смена Ñхемы процедуры insert_data Ñ Ð´Ð²ÑƒÐ¼Ñ Ð°Ñ€Ð³ÑƒÐ¼ÐµÐ½Ñ‚Ð°Ð¼Ð¸ типа integer на accounting:
ALTER PROCEDURE insert_data(integer, integer) SET SCHEMA accounting;
Обозначение процедуры insert_data(integer, integer) как завиÑимой от раÑÑˆÐ¸Ñ€ÐµÐ½Ð¸Ñ myext:
ALTER PROCEDURE insert_data(integer, integer) DEPENDS ON EXTENSION myext;
Изменение пути поиÑка, который уÑтанавливаетÑÑ Ð°Ð²Ñ‚Ð¾Ð¼Ð°Ñ‚Ð¸Ñ‡ÐµÑки Ð´Ð»Ñ Ð¿Ñ€Ð¾Ñ†ÐµÐ´ÑƒÑ€Ñ‹:
ALTER PROCEDURE check_password(text) SET search_path = admin, pg_temp;
Отмена автоматичеÑкого Ð¾Ð¿Ñ€ÐµÐ´ÐµÐ»ÐµÐ½Ð¸Ñ search_path Ð´Ð»Ñ Ð¿Ñ€Ð¾Ñ†ÐµÐ´ÑƒÑ€Ñ‹:
ALTER PROCEDURE check_password(text) RESET search_path;
Теперь процедура будет выполнÑÑ‚ÑŒÑÑ Ñ Ñ‚ÐµÐ¼ путём, который задан в момент вызова.
СовмеÑтимоÑÑ‚ÑŒ
Ðтот оператор чаÑтично ÑовмеÑтим Ñ Ð¾Ð¿ÐµÑ€Ð°Ñ‚Ð¾Ñ€Ð¾Ð¼ ALTER PROCEDURE в Ñтандарте SQL. Стандарт позволÑет изменить больше ÑвойÑтв процедуры, но не даёт возможноÑти переименовать процедуру, Ñделать процедуру определÑющей контекÑÑ‚ безопаÑноÑти, ÑвÑзать Ñ Ð¿Ñ€Ð¾Ñ†ÐµÐ´ÑƒÑ€Ð¾Ð¹ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚Ñ€Ð¾Ð² конфигурации или изменить владельца, Ñхему или характериÑтику изменчивоÑти процедуры. Также Ñтандарт требует Ð½Ð°Ð»Ð¸Ñ‡Ð¸Ñ ÐºÐ»ÑŽÑ‡ÐµÐ²Ð¾Ð³Ð¾ Ñлова RESTRICT, но в PostgreSQL оно необÑзательное.