CREATE PROCEDURE
CREATE PROCEDURE — создать процедуру
Синтаксис
CREATE [ OR REPLACE ] PROCEDUREимя
( [ [режим_аргумента
] [имя_аргумента
]тип_аргумента
[ { DEFAULT | = }выражение_по_умолчанию
] [, ...] ] ) { LANGUAGEимя_языка
| TRANSFORM { FOR TYPEимя_типа
} [, ... ] | [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER | SETпараметр_конфигурации
{ TOзначение
| =значение
| FROM CURRENT } | AS 'определение
' | AS 'объектный_файл
', 'объектный_символ
' |тело_sql
} ...
Описание #
Команда CREATE PROCEDURE
определяет новую процедуру. CREATE OR REPLACE PROCEDURE
создаёт новую процедуру либо заменяет определение уже существующей. Чтобы определить процедуру, необходимо иметь право USAGE
для соответствующего языка.
Если указано имя схемы, процедура создаётся в заданной схеме, в противном случае — в текущей. Имя новой процедуры должно отличаться от имён существующих процедур и функций с такими же типами аргументов в этой схеме. Однако процедуры и функции с аргументами разных типов могут иметь одно имя (это называется перегрузкой).
Команда CREATE OR REPLACE PROCEDURE
предназначена для изменения текущего определения существующей процедуры. С её помощью нельзя изменить имя или типы аргументов (если попытаться сделать это, будет создана новая отдельная процедура).
Когда команда CREATE OR REPLACE PROCEDURE
заменяет существующую процедуру, владелец и права доступа к этой процедуре не меняются. Все другие свойства процедуры получают значения, задаваемые командой явно или по умолчанию. Чтобы заменить процедуру, необходимо быть её владельцем (или быть членом роли-владельца).
Владельцем процедуры становится создавший её пользователь.
Чтобы создать процедуру, необходимо иметь право USAGE
для типов её аргументов.
За дополнительной информацией о разработке процедур обратитесь к Разделу 38.4.
Параметры
имя
Имя создаваемой процедуры (возможно, дополненное схемой).
режим_аргумента
Режим аргумента:
IN
,OUT
,INOUT
илиVARIADIC
. По умолчанию подразумеваетсяIN
.имя_аргумента
Имя аргумента.
тип_аргумента
Тип данных аргумента процедуры (возможно, дополненный схемой), при наличии аргументов. Тип аргументов может быть базовым, составным или доменным, либо это может быть ссылка на столбец таблицы.
В зависимости от языка реализации также может допускаться указание «псевдотипов», например,
cstring
. Псевдотипы показывают, что фактический тип аргумента либо определён не полностью, либо существует вне множества обычных типов SQL.Ссылка на тип столбца записывается в виде
. Иногда такое указание бывает полезно, так как позволяет создать процедуру, независящую от изменений в определении таблицы.имя_таблицы
.имя_столбца
%TYPEвыражение_по_умолчанию
Выражение, используемое для вычисления значения по умолчанию, если параметр не задан явно. Результат выражения должен сводиться к типу соответствующего параметра. Для всех входных параметров, следующих за параметром с определённым значением по умолчанию, также должны быть определены значения по умолчанию.
имя_языка
Имя языка, на котором реализована процедура. Это может быть
sql
,c
,internal
либо имя процедурного языка, определённого пользователем, например,plpgsql
. Если присутствуеттело_sql
, подразумевается языкsql
. Вариант написания этого имени в апострофах считается устаревшим и требует точного совпадения регистра.TRANSFORM { FOR TYPE
имя_типа
} [, ... ] }Устанавливает список трансформаций, которые должны применяться при вызове процедуры. Трансформации выполняют преобразования между типами SQL и типами данных, специфичными для языков; см. CREATE TRANSFORM. Преобразования встроенных типов обычно жёстко предопределены в реализациях процедурных языков, так что их здесь указывать не нужно. Если реализация процедурного языка не может обработать тип и трансформация для него отсутствует, будет выполнено преобразование типов по умолчанию, но это зависит от реализации.
[EXTERNAL] SECURITY INVOKER
[EXTERNAL] SECURITY DEFINER
Характеристика
SECURITY INVOKER
(безопасность вызывающего) показывает, что процедура будет выполняться с правами пользователя, вызвавшего её. Этот вариант подразумевается по умолчанию. ВариантSECURITY DEFINER
(безопасность определившего) обозначает, что процедура выполняется с правами пользователя, владеющего ей.Ключевое слово
EXTERNAL
(внешняя) допускается для соответствия стандарту SQL, но является необязательным, так как, в отличие от SQL, эта характеристика распространяется на все процедуры, а не только внешние.В процедуре с характеристикой
SECURITY DEFINER
не могут выполняться операторы управления транзакциями (например,COMMIT
иROLLBACK
в некоторых языках).параметр_конфигурации
значение
Предложение
SET
определяет, что при вызове процедуры указанный параметр конфигурации должен принять заданное значение, а затем восстановить своё предыдущее значение при завершении процедуры. ПредложениеSET FROM CURRENT
сохраняет в качестве значения, которое будет применено при входе в процедуру, значение, действующее в момент выполненияCREATE PROCEDURE
.Если в определение процедуры добавлено
SET
, то действие командыSET LOCAL
, выполняемой внутри процедуры для того же параметра, ограничивается телом процедуры: предыдущее значение параметра так же будет восстановлено при завершении процедуры. Однако обычная командаSET
(безLOCAL
) переопределяет предложениеSET
, как и предыдущую командуSET LOCAL
: действие такой команды будет сохранено и после завершения процедуры, если только не произойдёт откат транзакции.Если к определению процедуры добавлено
SET
, то в этой процедуре не могут выполняться операторы управления транзакциями (например,COMMIT
иROLLBACK
в некоторых языках).За подробными сведениями об именах и значениях параметров обратитесь к SET и Главе 19.
определение
Строковая константа, определяющая реализацию процедуры; её значение зависит от языка. Это может быть имя внутренней процедуры, путь к объектному файлу, команда SQL или код на процедурном языке.
Часто бывает полезно заключать определение процедуры в доллары (см. Подраздел 4.1.2.4), а не в традиционные апострофы. Если не использовать доллары, все апострофы и обратные косые черты в определении процедуры придётся экранировать, дублируя их.
объектный_файл
,объектный_символ
Эта форма предложения
AS
применяется для динамически загружаемых процедур на языке C, когда имя процедуры в коде C не совпадает с именем процедуры в SQL. Строкаобъектный_файл
задаёт имя файла, содержащего скомпилированную процедуру на C (данная команда воспринимает эту строку так же, как иLOAD
). Строкаобъектный_символ
задаёт символ скомпонованной процедуры, то есть имя процедуры в исходном коде на языке C. Если объектный символ не указан, предполагается, что он совпадает с именем определяемой SQL-процедуры.Если повторные вызовы
CREATE PROCEDURE
ссылаются на один и тот же объектный файл, он загружается в рамках сеанса только один раз. Чтобы выгрузить и загрузить этот файл снова (например, в процессе разработки), начните новый сеанс.тело_sql
Тело процедуры в стиле
LANGUAGE SQL
. Это должен быть блок видаBEGIN ATOMIC
оператор
;оператор
; ...оператор
; ENDОно определяется подобно телу, задаваемому строковой константой (см.
определение
выше), но есть и некоторые различия. Эта форма работает только с функциями в стилеLANGUAGE SQL
, тогда как форма со строковой константой поддерживается для всех языков. Она разбирается во время определения процедуры, тогда как форма со строковой константой — во время выполнения; как следствие, эта форма не поддерживает полиморфные типы аргументов и другие конструкции, которые нельзя обработать во время определения процедуры. С данной формой отслеживаются зависимости процедуры от объектов, используемых в её теле, так что командаDROP ... CASCADE
выполнится корректно, тогда как в случае определения тела в строковой константе после такого удаления могут остаться неполноценные процедуры. Наконец, данная форма в большей степени соответствует стандарту SQL и совместима с другими реализациями SQL.
Примечания #
Дополнительные детали создания функций, которые применимы и к процедурам, описываются в CREATE FUNCTION.
Чтобы выполнить процедуру, воспользуйтесь командой CALL.
Примеры #
CREATE PROCEDURE insert_data(a integer, b integer) LANGUAGE SQL AS $$ INSERT INTO tbl VALUES (a); INSERT INTO tbl VALUES (b); $$;
или
CREATE PROCEDURE insert_data(a integer, b integer) LANGUAGE SQL BEGIN ATOMIC INSERT INTO tbl VALUES (a); INSERT INTO tbl VALUES (b); END;
и пример вызова:
CALL insert_data(1, 2);
Совместимость #
Команда CREATE FUNCTION
определена в стандарте SQL. Её реализация в Postgres Pro может использоваться совместимым образом, но дополнена множеством расширений. За подробностями обратитесь также к CREATE FUNCTION.