ГЛАВА 7 Команды

create plan

373

create plan

• Если в группе уже есть план запроса с тем же текстом SQL, необхо-

374

[[(]@имя_параметра тип_данных [(длина ) | (точность [, масштаб ])]

[= значение_по_умолчанию][output]

375

create procedure

дельно. Администратор безопасности системы может запретить группировку процедур, изменив значение параметра allow procedure grouping с помощью системной процедуры sp_configure. Информацию по опробованной конфигурации см. в книге Руководство по систем-

ному администрированию.

имя_параметра

Имя аргумента процедуры. Значения параметров указываются при выполнении процедуры. Имена параметров необязательно указывать в команде процедура может не иметь аргументов.

Имена параметров должны быть допустимыми идентификаторами и начинаться с символа @. Максимальная длина имени параметра,

включая знак @, составляет 30 символов. Параметры являются локаль- ными по отношению к процедуре: другие процедуры могут использо- вать параметры с такими же именами.

Если значение параметра содержит не буквенно-цифровые символы, оно должно быть заключено в кавычки. Это правило распространяется на имена объектов, уточненные именем базы данных или владельца (так как они содержат точку). Значение параметра, начинающееся с цифры, также нужно заключить в кавычки.

тип_данных[(длина) | (точность [, масштаб])]

Тип данных параметра. Подробности о типах данных см. в главе 1, “Системные и пользовательские типы данных”. Параметры хранимой процедуры не могут иметь тип text, image и пользовательский тип, ба- зовым типом которого является text или image.

Вместе с типами данных char, varchar, unichar, univarchar, nchar, nvarchar, binary и varbinary указывается длина (в круглых скобках). Если длина не указана, значение параметра усекается до одного символа.

Вместе с типом данных float в круглых скобках можно указать двоич- ную точность. Если точность не указана, Adaptive Server использует точность, заданную по умолчанию для данной платформы.

Вместе с типами данных numeric и decimal в круглых скобках через за- пятую можно указать точность и масштаб. Если точность и масштаб не указаны, Adaptive Server использует значения по умолчанию – 18 для точности и 0 для масштаба.

значение_по_умолчанию

Значение по умолчанию для параметра процедуры. Если значение по умолчанию задано, пользователь может не указывать значение параметра при вызове процедуры. Значение по умолчанию должно

376

ГЛАВА 7 Команды

быть константой. Оно может содержать метасимволы (%, _, [ ] и [^]), если параметр используется в процедуре вместе с ключевым словом like (см. пример 2).

Значение по умолчанию может равняться NULL. В определении про- цедуры можно указать, что некоторое действие должно быть выпол- нено, если значение параметра равно NULL (см. пример 3).

output

Указывает, что параметр является выходным. Значение этого пара- метра может быть возвращено команде execute, вызывающей проце- дуру. Выходные параметры используются для возврата информации в вызывающую процедуру (см. пример 5).

Чтобы значение параметра можно было передать вверх на несколько уровней вложенности, в каждой процедуре должен быть определен

соответствующий выходной параметр (в том числе и в команде execute,

вызвающей процедуру высшего уровня).

Можно использовать сокращенную форму ключевого слова output – out.

with recompile

Означает, что план для процедуры никогда не будет сохраняться, а при каждом ее выполнении будет создаваться новый план. Эту необяза- тельную инструкцию следует указать, если вы считаете, что выпол- нение процедуры будет нетипичным, то есть когда необходимо соз- дать новый план. Инструкция with recompile не влияет на выполнение расширенной хранимой процедуры.

операторы_SQL

Действия, выполняемые процедурой. Этот параметр может содержать неограниченное количество любых операторов SQL, кроме create view, create default, create rule, create procedure, create trigger и use.

SQL-операторы команды create procedure часто содержат управ-

ляющие конструкции, в том числе declare, if...else; while, break, continue, begin...end, goto label, return, waitfor и /* комментарии */. В них также могут быть указаны параметры, объявленные в процедуре.

SQL-операторы могут ссылаться на объекты в другой базе данных (при этом имена этих объектов должны быть соответсвующим образом уточнены именем базы данных).

external name

Создает расширенную хранимую процедуру. Если используется син- таксис as external name, то процедуру нельзя группировать (указывать параметр номер).

377

create procedure

имя_dll

378

ГЛАВА 7 Команды

else

select sysobjects.name, sysindexes.name, indid from sysindexes, sysobjects

where sysobjects.name = @table and sysobjects.id = sysindexes.id

Пример 4. Следующая процедура вычисляет произведение двух цело- численных параметров и возвращает результат в выходной параметр

@result:

create procedure mathtutor @mult1 int, @mult2 int, @result int output

as

select @result = @mult1 * @mult2

Если в процедуру передаются три числа, оператор select выполняет умно- жение и присваивает значение, но не отображает выходной параметр:

mathtutor 5, 6, 32 (return status 0)

Пример 5. В этом примере и процедура, и оператор execute сопровож- даются ключевым словом output с именем параметра, возвращающим значение вызывающей процедуре:

declare @guess int select @guess = 32

exec mathtutor 5, 6, @result = @guess output

(1 row affected) (return status = 0)

Return parameters:

@result

-----------

30

Выходной параметр @result и все последующие параметры оператора execute должны передаваться в форме:

@параметр = значение

•Значение возвращаемого параметра отображается всегда, независимо от того, изменилось оно или нет.

•@result необязательно объявлять в вызывающем пакете, поскольку это имя параметра, передаваемого в mathtutor.

379

create procedure

•Хотя значение параметра @result возвращается в переменную, указанную в операторе execute (в нашем случае – @guess), он отображается под собственным заголовком (@result).

Пример 6. Возвращаемые параметры можно использовать в других SQL- операторах пакета или вызывающей процедуры. Следующий пример демонстрирует, как можно использовать значение переменной @guess

в условных инструкциях после оператора execute, сохраняя его в другой переменной @store во время вызова процедуры. Если возвращаемые параметры используются в операторе execute, который является частью SQL-пакета, возвращаемые значения печатаются под собственным заголовком перед последующими операторами пакета.

declare @guess int declare @store int select @guess = 32 select @store = @guess

execute mathtutor 5, 6, @result = @guess output select Your_answer = @store, Right_answer = @guess if @guess = @store

print "Right-o"

else

print "Wrong, wrong, wrong!"

(1 row affected) (1 row affected)

(return status = 0)

Return parameters:

@result

-----------

30

(1 row affected) Wrong, wrong, wrong!

Пример 7. Создание расширенной хранимой процедуры xp_echo, которая присваивает значение входного параметра @in выходному параметру @out. Код этой процедуры содержится в функции xp_echo, которая находится в динамической библиотеке sqlsrvdll.dll:

create procedure xp_echo @in varchar(255), @out varchar(255) output

as external name "sqlsrvdll.dll"

380

381

create procedure

•В хранимой процедуре нельзя создать объект (включая временную таблицу), удалить его, а затем создать новый объект с тем же именем. Adaptive Server создает объект, определенный в хранимой процеду- ре, во время ее выполнения, а не во время компиляции.

Предупреждение. Некоторые изменения в базе данных, например удаление и повторное создание индексов, могут привести к изме- нению идентификатора объекта. Когда идентификаторы объектов изменяются, хранимые процедуры автоматически перекомпили- руются и могут слегка увеличиться в размере. Оставляйте немного места для этого увеличения.

Расширенные хранимые процедуры

•Если используется синтаксис as external name, команда create procedure регистрирует расширенную хранимую процедуру (ESP). Расширенные хранимые процедуры выполняют функции, написан- ные на процедурном языке, а не команды Transact-SQL.

•В Windows NT ESP-функция не должна вызывать сигнальную про- цедуру этапа выполнения на языке Си. Это приведет к сбою XP Server, так как Open Server™ не поддерживает обработку сигналов в Windows NT.

•Для поддержания многопоточности ESP-функции должны исполь- зовать функцию Open Server srv_yield, которая приостанавливает и повторно планирует работу потока XP Server, позволяя выполниться другому потоку с равным или более высоким приоритетом.

•Механизм поиска файла DLL зависит от платформы. В Windows NT поиск имени файла DLL выполняется в следующей последовательности:

a каталог, из которого загружается приложение; b текущий каталог;

c системный каталог (SYSTEM32);

d каталоги, перечисленные в переменной окружения PATH.

Если DLL не находится в первых трех каталогах, включите путь к нужному каталогу в переменную PATH.

В UNIX метод поиска зависит от платформы. Если DLL или общую библиотеку найти не удается, проверяется каталог $SYBASE/lib.

Абсолютные имена путей не поддерживаются.

382

ГЛАВА 7 Команды

Системные процедуры

•Системные администраторы могут создавать новые системные про- цедуры в базе данных sybsystemprocs. Имена системных процедур должны начинаться с символов “sp_”. Эти процедуры можно выпол- нить из любой базы данных, указав только имя; необязательно уточ- нять имена процедур с помощью имени базы данных sybsystemprocs. Более подробную информацию о создании системных процедур см. в книге Руководство по системному администрированию.

•Результаты системных процедур различаются в зависимости от кон- текста, в котором они выполняются. Например, процедура sp_foo, вызывающая системную функцию db_name(), возвращает имя базы данных, из которой она выполняется. Если ее выполнить из базы данных pubs2, она возвратит значение “pubs2”:

use pubs2 sp_foo

------------------------------

pubs2

Если ее выполнить из базы данных sybsystemprocs, она возвратит значение “sybsystemprocs”:

use sybsystemprocs sp_foo

------------------------------

sybsystemprocs

Вложенные процедуры

•Вложение процедур происходит, когда одна хранимая процедура вызывает другую.

•Вложенная процедура может обращаться к объектам, созданным вызывающей процедурой.

•Уровень вложенности увеличивается при выполнении вызванной процедуры и уменьшается при ее завершении. Если уровень вло- женности превышает 16, транзакция завершается неудачно.

•Процедуру можно вызвать по имени или по имени переменной вместо фактического имени процедуры.

•Текущий уровень вложенности хранится в глобальной переменной nestlevel.

383

ГЛАВА 7 Команды

•Если во время выполнения возникает сразу несколько ошибок воз- вращается код с наибольшим абсолютным значением. Пользователь- ские значения имеют приоритет над системными.

Идентификаторы объектов

•Для переименования хранимой процедуры используется системная процедура sp_rename.

•Чтобы переименовать расширенную хранимую процедуру, нужно удалить ее, переименовать и перекомпилировать базовую функцию и создать процедуру.

•Если процедура ссылается на таблицы, столбцы или представления, имена которых не являются допустимыми идентификаторами, не- обходимо включить параметр quoted_identifier перед выполнением команды create procedure и заключить каждое такое имя в двойные кавычки. Параметр quoted_identifier может быть выключен при выполнении процедуры.

•Если любой объект, на который ссылается процедура, был пере- именован, процедуру необходимо удалить и создать заново.

•Имена объектов, указанные в командах create table и dbcc внутри хра- нимой процедуры, должны содержать имя владельца, если вы хотите, чтобы другие пользователи могли обращаться к данной процедуре.

Например, пользователь “mary”, владеющая таблицей marytab, долж- на полностью указать имя таблицы внутри хранимой процедуры (когда оно используется с этими командами), если она хочет, чтобы другие пользователи могли выполнить хранимую процедуру. Это нужно, потому что имена объектов разрешаются во время выполне- ния процедуры. Когда другой пользователь попытается выполнить процедуру, Adaptive Server найдет таблицу marytab, владельцем ко- торой является “mary”, а не таблицу marytab, принадлежащую поль- зователю, выполняющему процедуру.

Имена объектов, используемых в других операторах (например,

select или insert) внутри хранимой процедуры, не нужно указывать полностью, т.к. они разрешаются во время компиляции процедуры.

Временные таблицы и процедуры

•Вы можете создать хранимую процедуру для ссылки на временную таблицу, созданную в текущем сеансе. Временная таблица, созданная внутри хранимой процедуры, удаляется после ее завершения.

Подробности см. в книге Transact-SQL User’s Guide.

•Такие системные процедуры, как sp_help, работают с временными таблицами, только если они вызваны из базы данных tempdb.

385

create procedure

Задание параметров в процедурах

• Команду set можно использовать внутри хранимой процедуры. Боль- шинство параметров команды set остаются действительными во вре- мя выполнения процедуры, а затем принимают исходные значения.

Однако при использовании параметров команды set (таких как identity_insert), которые требуют, чтобы пользователь был владельцем объекта, другие пользователи не смогут выполнить хранимую проце- дуру.

Получение информации о процедурах

• Для получения отчета об объектах, на которые ссылается процедура, используйте системную процедуру sp_depends.

• Для отображения текста оператора create procedure, который

386

ГЛАВА 7 Команды

• Если объекты, на которые ссылается процедура, принадлежат раз- ным пользователям, то пользователю, который вызвал процедуру, должен быть предоставлен прямой доступ к этим объектам. Нап- ример, если процедура выполняет выборку из таблицы, к которой пользователь, вызывающий процедуру, не имеет доступа, выполне- ние процедуры завершается ошибкой.

• Если процедура и ее объекты принадлежат одному пользователю,

387