Хранимые процедуры - История изменений

Maintenance script: rollbackEdits.php mass rollback

2022-09-04T16:08:16Z

rollbackEdits.php mass rollback

194.88.143.66 в 06:21, 1 сентября 2022

2022-09-01T06:21:03Z

Dmitriy: link operator

2021-12-20T02:01:51Z

link operator

Dmitriy: colored

2021-12-20T01:59:55Z

colored

Dmitriy: added operators links

2021-12-20T00:12:07Z

added operators links

Dmitriy: -- fix, links

2021-12-20T00:09:42Z

-- fix, links

Dmitriy: init

2021-12-19T23:54:02Z

init

Новая страница

{{Определение|definition = '''Хранимая процедура''' — фрагмент кода, хранящийся в БД.}}

В отличие от [хранимых функций] может возвращать таблицу или не возвращать ничего.

Достоинства кода, хранящегося в БД:
*Обработка данных производится непосредственно на стороне БД.
*БД много знает про код -- можно скомпилировать, построить оптимальный план исполнения.
*Дает возможность работать с недоступными данными с помощью заданного нами интерфейса.
*Более удобная работа с изменением данных -- предварительные проверки, изменение сразу в нескольких местах.

== Объявление ==
===Синтаксис===

create procedure имя(параметры)
[language {sql|...}]
[[not] deterministic]
{contains sql|reads sql data|modifies sql data|no sql}
[{returns null|called} on null input]
[sql security {definer|invoker}]
тело

*Параметры -- список параметров через запятую. Объявление параметра: {in | out | inout} имя тип.
**in (умолч.) -- внешний мир не узнает об изменении параметра.
**out -- запись результата, но читать изначальное значение нельзя.
**inout -- запись результата, но читать изначальное значение можно.
*language -- язык, на котором написала процедура. По умолчанию sql. Также поддерживаются Ada, C, COBOL, Fortran, MUMPS, Pascal, PLI.
*[not] deterministic -- является ли процедура детерминированной. По умолчанию -- нет.
*Отношение к данным. Соответственно: выполняет произвольные SQL операторы (умолч.), только читает, только изменяет, с данными не работает.
*Отношение к null-агрументам. Соответственно: процедура не вызовется и вернет null, процедура вызовется (умолч.).
*Управление доступом. Соответственно: запускается с правами того, кто создал процедуру, с правами того, кто процедуру вызвал (умолч.).
**Можно позволить пользователь работать с недоступными для него данными, но через предоставленный нами интерфейс. Для этого делаем процедуру, работающую с этими данными, даем ей права definer и разрешаем выполнять пользователю.
**Права definer наследуются при вызове других функций (иначе может не хватить прав при вызове процедуры, объявленной с правами invoker).
*Тело может быть как одним оператором (к примеру, select или insert), так и произвольным количеством операторов, заключенных в begin/end. См [разделители]

=== Примеры ===
create procedure s()
language sql reads sql data
select * from Students;

create procedure t(id int, in id1 int, inout i int, out ans int)
language sql
deterministic
modifies sql data
called on null input
sql security invoker
begin
-- some operators
end

== Вызов ==
===Синтаксис===
exec имя(аргументы)

===Доступ===
Чтобы вызывать процедуру, нужно иметь привилегию execute.
Может выполняться с разными правами доступа, указанными в [объявлении].

=== Пример ===
exec ChangeName('Иванов', 'Петров');

== Разделители ==
Рассмотрим пример. Подробнее про содержимое begin/end см. [операторы].
create procedure foo()
begin
declare x int;
set x = 42;
end;

Жадный парсер прочитает до первого разделителя (а он по умолчанию ";") и получится синтаксическая ошибка, так как объявление функции уже закончилось и он встречает строку "set x = 42;".
create procedure foo()
begin
declare x int;
---------------
set x = 42;
end;

Выход -- объявить на время другой разделитель. Так мы не сможем "разорвать" содержимое begin/end.
DELIMITER //
create procedure foo()
begin
declare x int;
set x = 42;
end;
//
DELIMITER ;

NB: Некоторые СУБД умеют парсить так, как нам хочется.

== См. также ==
*[[Хранимые функции]]
*[[Операторы]]

==Литература==
* ''Дейт К. Введение в системы баз данных (главы 4 и 17)''
* ''Уидом Д., Ульман Д. Основы реляционных баз данных (раздел 7.4)''
* ''Gulutzan P., Pelzer T. SQL-99 complete, really''
** [https://crate.io/docs/sql-99/en/latest/chapters/25.html Chapter 25 – SQL-Invoked Routine]
** [https://crate.io/docs/sql-99/en/latest/chapters/26.html Chapter 26 – PSM: Not Just Persistent Stored Modules]

[[Категория: Базы данных]]

← Предыдущая		Версия 16:08, 4 сентября 2022
Строка 1:		Строка 1:
−	~~{\| class="wikitable" align="center" style="color: red; background-color: black; font-size: 56px; width: 800px;"~~
−	\|+
−	~~\|-align="center"~~
−	~~\|'''НЕТ ВОЙНЕ'''~~
−	~~\|-style="font-size: 16px;"~~
−	\|
−	24 февраля 2022 года российское руководство во главе с Владимиром Путиным развязало агрессивную войну против Украины. В глазах всего мира это военное преступление совершено от лица всей страны, всех россиян.
−
−	Будучи гражданами Российской Федерации, мы против своей воли оказались ответственными за нарушение международного права, военное вторжение и массовую гибель людей. Чудовищность совершенного преступления не оставляет возможности промолчать или ограничиться пассивным несогласием.
−
−	Мы убеждены в абсолютной ценности человеческой жизни, в незыблемости прав и свобод личности. Режим Путина — угроза этим ценностям. Наша задача — обьединить все силы для сопротивления ей.
−
−	Эту войну начали не россияне, а обезумевший диктатор. И наш гражданский долг — сделать всё, чтобы её остановить.
−
−	~~''Антивоенный комитет России''~~
−	~~\|-style="font-size: 16px;"~~
−	\|Распространяйте правду о текущих событиях, оберегайте от пропаганды своих друзей и близких. Изменение общественного восприятия войны - ключ к её завершению.
−	~~\|-style="font-size: 16px;"~~
−	\|[https://meduza.io/ meduza.io], [https://www.youtube.com/c/popularpolitics/videos Популярная политика], [https://novayagazeta.ru/ Новая газета], [https://zona.media/ zona.media], [https://www.youtube.com/c/MackNack/videos Майкл Наки].
−	\|}
−
	{{Определение\|definition = '''Хранимая процедура''' {{---}} фрагмент кода, хранящийся в БД.}}		{{Определение\|definition = '''Хранимая процедура''' {{---}} фрагмент кода, хранящийся в БД.}}

← Предыдущая		Версия 06:21, 1 сентября 2022
Строка 1:		Строка 1:
		+	{\| class="wikitable" align="center" style="color: red; background-color: black; font-size: 56px; width: 800px;"
		+	\|+
		+	\|-align="center"
		+	\|'''НЕТ ВОЙНЕ'''
		+	\|-style="font-size: 16px;"
		+	\|
		+	24 февраля 2022 года российское руководство во главе с Владимиром Путиным развязало агрессивную войну против Украины. В глазах всего мира это военное преступление совершено от лица всей страны, всех россиян.
		+
		+	Будучи гражданами Российской Федерации, мы против своей воли оказались ответственными за нарушение международного права, военное вторжение и массовую гибель людей. Чудовищность совершенного преступления не оставляет возможности промолчать или ограничиться пассивным несогласием.
		+
		+	Мы убеждены в абсолютной ценности человеческой жизни, в незыблемости прав и свобод личности. Режим Путина — угроза этим ценностям. Наша задача — обьединить все силы для сопротивления ей.
		+
		+	Эту войну начали не россияне, а обезумевший диктатор. И наш гражданский долг — сделать всё, чтобы её остановить.
		+
		+	''Антивоенный комитет России''
		+	\|-style="font-size: 16px;"
		+	\|Распространяйте правду о текущих событиях, оберегайте от пропаганды своих друзей и близких. Изменение общественного восприятия войны - ключ к её завершению.
		+	\|-style="font-size: 16px;"
		+	\|[https://meduza.io/ meduza.io], [https://www.youtube.com/c/popularpolitics/videos Популярная политика], [https://novayagazeta.ru/ Новая газета], [https://zona.media/ zona.media], [https://www.youtube.com/c/MackNack/videos Майкл Наки].
		+	\|}
		+
	{{Определение\|definition = '''Хранимая процедура''' {{---}} фрагмент кода, хранящийся в БД.}}		{{Определение\|definition = '''Хранимая процедура''' {{---}} фрагмент кода, хранящийся в БД.}}

@@ Строка 32: / Строка 32: @@
 **Можно позволить пользователь работать с недоступными для него данными, но через предоставленный нами интерфейс. Для этого делаем процедуру, работающую с этими данными, даем ей права <font color = blue>definer</font> и разрешаем выполнять пользователю.
 **Права <font color = blue>definer</font> наследуются при вызове других функций (иначе может не хватить прав при вызове процедуры, объявленной с правами <font color = blue>invoker</font>).
-*Тело может быть как одним оператором (к примеру, <font color = blue>select</font> или <font color = blue>insert</font>), так и произвольным количеством операторов, заключенных в <font color = blue>begin</font>/<font color = blue>end</font>. См. [[Хранимые процедуры#Разделители | разделители]].
+*Тело может быть как одним оператором (к примеру, <font color = blue>select</font> или <font color = blue>insert</font>), так и [[Хранимые процедуры и функции: операторы#Составной оператор| составным оператором]]. См. также [[Хранимые процедуры#Разделители | разделители]].
 === Примеры ===

@@ Строка 61: / Строка 61: @@
 == Разделители ==
-Рассмотрим пример. Подробнее про содержимое <font color = blue>begin/end</font> см. [[Хранимые процедуры и функции: операторы|операторы]].
+Рассмотрим пример. Подробнее про содержимое <font color = blue><font color = blue>begin</font>/<font color = blue>end</font></font> см. [[Хранимые процедуры и функции: операторы|операторы]].
-  create procedure foo()
+  <font color = blue>create procedure</font> foo()
-  begin
+  <font color = blue>begin</font>
-   declare x int;
+   <font color = blue>declare</font> x int;
-   set x = 42;
+   <font color = blue>set</font> x = 42;
-  end;
+  <font color = blue>end</font>;
-Жадный парсер прочитает до первого разделителя (а он по умолчанию ";") и получится синтаксическая ошибка, так как объявление функции уже закончилось и он встречает строку "set x = 42;".
+Жадный парсер прочитает до первого разделителя (а он по умолчанию ";") и получится синтаксическая ошибка, так как объявление функции уже закончилось и он встречает строку "<font color = blue>set</font> x = 42;".
-  create procedure foo()
+  <font color = blue>create procedure</font> foo()
-  begin
+  <font color = blue>begin</font>
-   declare x int;
+   <font color = blue>declare</font> x int;
-  {{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}-
+  --------------
-   set x = 42;
+   <font color = blue>set</font> x = 42;
-  end;
+  <font color = blue>end</font>;
-Выход {{---}} объявить на время другой разделитель. Так мы не сможем "разорвать" содержимое <font color = blue>begin/end</font>.
+Выход {{---}} объявить на время другой разделитель. Так мы не сможем "разорвать" содержимое <font color = blue><font color = blue>begin</font>/<font color = blue>end</font></font>.
-  DELIMITER //
+  <font color = blue>DELIMITER</font> //
-  create procedure foo()
+  <font color = blue>create procedure</font> foo()
-  begin
+  <font color = blue>begin</font>
-   declare x int;
+   <font color = blue>declare</font> x int;
-   set x = 42;
+   <font color = blue>set</font> x = 42;
-  end;
+  <font color = blue>end</font>;
   //
-  DELIMITER ;
+  <font color = blue>DELIMITER</font> ;
 NB: Некоторые СУБД умеют парсить так, как нам хочется.

@@ Строка 1: / Строка 1: @@
-{{Определение|definition = '''Хранимая процедура''' — фрагмент кода, хранящийся в БД.}}
+{{Определение|definition = '''Хранимая процедура''' {{---}} фрагмент кода, хранящийся в БД.}}
-В отличие от [хранимых функций] может возвращать таблицу или не возвращать ничего.
+== Достоинства и мотивация ==
 Достоинства кода, хранящегося в БД:
 *Обработка данных производится непосредственно на стороне БД.
-*БД много знает про код -- можно скомпилировать, построить оптимальный план исполнения.
+*БД много знает про код {{---}} можно скомпилировать, построить оптимальный план исполнения.
 *Дает возможность работать с недоступными данными с помощью заданного нами интерфейса.
-*Более удобная работа с изменением данных -- предварительные проверки, изменение сразу в нескольких местах.
+*Более удобная работа с изменением данных {{---}} предварительные проверки, изменение сразу в нескольких местах.
 == Объявление ==
@@ Строка 22: / Строка 21: @@
   <font color = red>тело</font>
-*<font color = red>Параметры</font> -- список параметров через запятую. Объявление параметра: {<font color = blue>in</font> | <font color = blue>out</font> | <font color = blue>inout</font>} имя тип.
+*<font color = red>Параметры</font> {{---}} список параметров через запятую. Объявление параметра: {<font color = blue>in</font> | <font color = blue>out</font> | <font color = blue>inout</font>} имя тип.
-**<font color = blue>in</font> (умолч.) -- внешний мир не узнает об изменении параметра.
+**<font color = blue>in</font> (умолч.) {{---}} внешний мир не узнает об изменении параметра.
-**<font color = blue>out</font> -- запись результата, но читать изначальное значение нельзя.
+**<font color = blue>out</font> {{---}} запись результата, но читать изначальное значение нельзя.
-**<font color = blue>inout</font> -- запись результата, но читать изначальное значение можно.
+**<font color = blue>inout</font> {{---}} запись результата, но читать изначальное значение можно.
-*<font color = blue>language</font> -- язык, на котором написала процедура. По умолчанию <font color = blue>sql</font>. Также поддерживаются <font color = blue>Ada</font>, <font color = blue>C</font>, <font color = blue>COBOL</font>, <font color = blue>Fortran</font>, <font color = blue>MUMPS</font>, <font color = blue>Pascal</font>, <font color = blue>PLI</font>.
+*<font color = blue>language</font> {{---}} язык, на котором написала процедура. По умолчанию <font color = blue>sql</font>. Также поддерживаются <font color = blue>Ada</font>, <font color = blue>C</font>, <font color = blue>COBOL</font>, <font color = blue>Fortran</font>, <font color = blue>MUMPS</font>, <font color = blue>Pascal</font>, <font color = blue>PLI</font>.
-*[<font color = blue>not</font>] <font color = blue>deterministic</font> -- является ли процедура детерминированной. По умолчанию -- нет.
+*[<font color = blue>not</font>] <font color = blue>deterministic</font> {{---}} является ли процедура детерминированной. По умолчанию {{---}} нет.
 *Отношение к данным. Соответственно: выполняет произвольные SQL операторы (умолч.), только читает, только изменяет, с данными не работает.
 *Отношение к null-агрументам. Соответственно: процедура не вызовется и вернет <font color = red>null</font>, процедура вызовется (умолч.).
@@ Строка 33: / Строка 32: @@
 **Можно позволить пользователь работать с недоступными для него данными, но через предоставленный нами интерфейс. Для этого делаем процедуру, работающую с этими данными, даем ей права <font color = blue>definer</font> и разрешаем выполнять пользователю.
 **Права <font color = blue>definer</font> наследуются при вызове других функций (иначе может не хватить прав при вызове процедуры, объявленной с правами <font color = blue>invoker</font>).
-*Тело может быть как одним оператором (к примеру, <font color = blue>select</font> или <font color = blue>insert</font>), так и произвольным количеством операторов, заключенных в <font color = blue>begin</font>/<font color = blue>end</font>. См [разделители]
+*Тело может быть как одним оператором (к примеру, <font color = blue>select</font> или <font color = blue>insert</font>), так и произвольным количеством операторов, заключенных в <font color = blue>begin</font>/<font color = blue>end</font>. См. [[Хранимые процедуры#Разделители | разделители]].
 === Примеры ===
@@ Строка 56: / Строка 55: @@
 ===Доступ===
 Чтобы вызывать процедуру, нужно иметь привилегию <font color = blue>execute</font>.
-Может выполняться с разными правами доступа, указанными в [объявлении].
+Может выполняться с разными правами доступа, указанными в [[Хранимые процедуры#Объявление | объявлении]].
 === Пример ===
@@ Строка 73: / Строка 72: @@
   begin
    declare x int;
-  ---------------
+  {{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}-
    set x = 42;
   end;
-Выход -- объявить на время другой разделитель. Так мы не сможем "разорвать" содержимое <font color = blue>begin/end</font>.
+Выход {{---}} объявить на время другой разделитель. Так мы не сможем "разорвать" содержимое <font color = blue>begin/end</font>.
   DELIMITER //
   create procedure foo()

@@ Строка 61: / Строка 61: @@
 == Разделители ==
-Рассмотрим пример. Подробнее про содержимое <font color = blue>begin/end</font> см. [операторы].
+Рассмотрим пример. Подробнее про содержимое <font color = blue>begin/end</font> см. [[Хранимые процедуры и функции: операторы|операторы]].
   create procedure foo()
   begin
@@ Строка 90: / Строка 90: @@
 == См. также ==
 *[[Хранимые функции]]
-*[[Операторы]]
+*[[Хранимые процедуры и функции: операторы]]
 ==Литература==