- Статья
- Чтение занимает 30 мин
Применимо к: SQL Server (все поддерживаемые версии) База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics Параллельное хранилище данных
Создает хранимую процедуру Transact-SQL или общеязыковой среды выполнения (CLR) в следующих компонентах: SQL Server, База данных SQL Azure и Система платформы аналитики (PDW). Хранимые процедуры похожи на процедуры из других языков программирования в том, что они могут:
- принимать входные параметры и возвращать вызывающей процедуре или пакету ряд значений в виде выходных параметров;
- содержать программные инструкции, которые выполняют операции в базе данных, в том числе вызывающие другие процедуры;
- возвращать значение состояния вызывающей процедуре или пакету, таким образом передавая сведения об успешном или неуспешном завершении (и причины последнего).
Используйте эту инструкцию для создания постоянной процедуры в текущей базе данных или временной процедуры в базе данных tempdb
.
Примечание
В этом разделе рассматривается интеграция среды CLR .NET Framework с SQL Server. Интеграция со средой CLR не применяется к База данных SQL Azure.
Перейдите к разделу Простые примеры, чтобы пропустить сведения о синтаксисе и просмотреть краткий пример базовой хранимой процедуры.
Синтаксические обозначения в Transact-SQL
Синтаксис
-- Transact-SQL Syntax for Stored Procedures in SQL Server and Azure SQL Database
CREATE [ OR ALTER ] { PROC | PROCEDURE }
[schema_name.] procedure_name [ ; number ]
[ { @parameter [ type_schema_name. ] data_type }
[ VARYING ] [ = default ] [ OUT | OUTPUT | [READONLY]
] [ ,...n ]
[ WITH <procedure_option> [ ,...n ] ]
[ FOR REPLICATION ]
AS { [ BEGIN ] sql_statement [;] [ ...n ] [ END ] }
[;]
<procedure_option> ::=
[ ENCRYPTION ]
[ RECOMPILE ]
[ EXECUTE AS Clause ]
-- Transact-SQL Syntax for CLR Stored Procedures
CREATE [ OR ALTER ] { PROC | PROCEDURE }
[schema_name.] procedure_name [ ; number ]
[ { @parameter [ type_schema_name. ] data_type }
[ = default ] [ OUT | OUTPUT ] [READONLY]
] [ ,...n ]
[ WITH EXECUTE AS Clause ]
AS { EXTERNAL NAME assembly_name.class_name.method_name }
[;]
-- Transact-SQL Syntax for Natively Compiled Stored Procedures
CREATE [ OR ALTER ] { PROC | PROCEDURE } [schema_name.] procedure_name
[ { @parameter data_type } [ NULL | NOT NULL ] [ = default ]
[ OUT | OUTPUT ] [READONLY]
] [ ,... n ]
WITH NATIVE_COMPILATION, SCHEMABINDING [ , EXECUTE AS clause ]
AS
{
BEGIN ATOMIC WITH (set_option [ ,... n ] )
sql_statement [;] [ ... n ]
[ END ]
}
[;]
<set_option> ::=
LANGUAGE = [ N ] 'language'
| TRANSACTION ISOLATION LEVEL = { SNAPSHOT | REPEATABLE READ | SERIALIZABLE }
| [ DATEFIRST = number ]
| [ DATEFORMAT = format ]
| [ DELAYED_DURABILITY = { OFF | ON } ]
-- Transact-SQL Syntax for Stored Procedures in Azure Synapse Analytics
-- and Parallel Data Warehouse
-- Create a stored procedure
CREATE { PROC | PROCEDURE } [ schema_name.] procedure_name
[ { @parameter data_type } [ OUT | OUTPUT ] ] [ ,...n ]
AS
{
[ BEGIN ] sql_statement [;][ ,...n ] [ END ]
}
[;]
Аргументы
OR ALTER
Область применения: Azure База данных SQL, SQL Server (начиная с SQL Server 2016 (13.x); с пакетом обновления 1 (SP1)).
Изменяет процедуру, если она уже существует.
schema_name
Имя схемы, которой принадлежит процедура. Процедуры привязаны к схеме. Если имя схемы не указано при создании процедуры, то автоматически назначается схема по умолчанию для пользователя, который создает процедуру.
procedure_name
Имя процедуры. Имена процедур должны соответствовать требованиям, предъявляемым к идентификаторам, и должны быть уникальными в схеме.
Внимание!
При задании имен для процедур не следует пользоваться префиксом sp_ . Этим префиксом в SQL Server обозначаются системные процедуры. Использование этого префикса может нарушить работу кода приложения, если обнаружится системная процедура с таким же именем.
Локальную или глобальную временную процедуру можно создать, указав один символ номера (#) перед procedure_name ( #procedure_name) для локальных временных процедур и два символа номера для глобальных временных процедур ( ##procedure_name). Локальная временная процедура видима только соединению, которое создало процедуру, и удаляется, когда это соединение закрывается. Глобальная временная процедура доступна для всех соединений и удаляется при завершении последнего сеанса, в котором она использовалась. Для процедур CLR нельзя задавать временные имена.
Полное имя процедуры или глобальной временной процедуры не может содержать более 128 символов (с учетом символов ##). Полное имя локальной временной процедуры с учетом символа # не может содержать более 116 символов.
; число
Применимо к: SQL Server 2008 и выше, а также База данных SQL Azure.
Необязательный целочисленный аргумент, используемый для группирования одноименных процедур. Все сгруппированные процедуры можно удалить, выполнив одну инструкцию DROP PROCEDURE.
Примечание
В будущей версии Microsoft SQL Server этот компонент будет удален. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется.
В нумерованных процедурах нельзя использовать определяемые пользователем типы данных xml и CLR, и их нельзя использовать в структуре плана.
@ параметр
Параметр, объявленный в процедуре. Укажите имя параметра, начинающееся со знака @ . Имя параметра должно соответствовать правилам для идентификаторов. Параметры являются локальными в пределах процедуры; в разных процедурах могут быть использованы одинаковые имена параметров.
Можно объявить от 1 до 2100 параметров. При выполнении процедуры значение каждого из объявленных параметров должно быть указано пользователем, если для параметра не определено значение по умолчанию или значение не задано равным другому параметру. Если процедура содержит возвращающие табличное значение параметры, а в вызове отсутствует параметр, передается пустая таблица. Параметры могут использоваться только в качестве выражений-констант; они не могут использоваться вместо имен таблиц, столбцов или других объектов базы данных. Дополнительные сведения см. в разделе EXECUTE (Transact-SQL).
Параметры не могут быть объявлены, если указан параметр FOR REPLICATION.
[ type_schema_name . ] data_type
Тип данных параметра и схема, к которой принадлежит этот тип.
Рекомендации по процедурам Transact-SQL
- Все типы данных Transact-SQL можно использовать в качестве параметров.
- Для создания возвращающих табличное значение параметров можно использовать определяемый пользователем табличный тип. Возвращающие табличное значение параметры могут быть только ВХОДНЫМИ и должны сопровождаться ключевым словом READONLY. Дополнительные сведения см. в статье Использование возвращающих табличные значения параметров (ядро СУБД).
- Типы данных cursor могут быть только ВЫХОДНЫМИ параметрами и должны сопровождаться ключевым словом VARYING.
Рекомендации по процедурам CLR
-
Все собственные типы данных SQL Server, имеющие эквиваленты в управляемом коде, можно использовать в качестве параметров. Дополнительные сведения о соответствии между типами среды CLR и системными типами данных SQL Server см. в разделе Сопоставление данных параметров CLR. Дополнительные сведения о системных типах данных SQL Server и их синтаксисе см. в разделе Типы данных (Transact-SQL).
-
Возвращающие табличное значение типы данных и типы данных cursor не могут служить параметрами.
-
Если тип параметра является определяемым пользователем типом данных CLR, то необходимо иметь связанное с этим типом разрешение EXECUTE.
VARYING
Указывает результирующий набор, поддерживаемый в качестве выходного параметра. Этот параметр динамически формируется процедурой, и его содержимое может различаться. Область применения — только параметры cursor. Этот параметр недопустим для процедур CLR.
default
Значение по умолчанию для параметра. Если для некоторого параметра определено значение по умолчанию, то процедуру можно выполнить без указания значения этого параметра. Значение по умолчанию должно быть константой или может быть равно NULL. Значение константы может иметь вид шаблона, что позволяет использовать ключевое слово LIKE при передаче параметра в процедуру.
Значения по умолчанию записываются в столбец sys.parameters.default
только для процедур CLR. В случае параметров процедуры Transact-SQL этот столбец содержит значения NULL.
OUT | OUTPUT
Показывает, что параметр процедуры является выходным. Используйте выходные параметры для возврата значений коду, вызвавшему процедуру. Параметры text, ntext и image не могут быть выходными, если процедура не является процедурой CLR. Выходным параметром с ключевым словом OUTPUT может быть заполнитель курсора, если процедура не является процедурой CLR. Возвращающий табличное значение тип данных не может быть указан в качестве выходного параметра процедуры.
READONLY
Указывает, что параметр не может быть обновлен или изменен в тексте процедуры. Если тип параметра является возвращающим табличное значение типом, то должно быть указано ключевое слово READONLY.
RECOMPILE
Показывает, что компонент Компонент Database Engine не кэширует план запроса для этой процедуры, что вызывает ее компиляцию при каждом выполнении. Дополнительные сведения о причинах принудительной повторной компиляции см. в разделе Перекомпиляция хранимой процедуры. Этот параметр нельзя использовать, если указано предложение FOR REPLICATION, а также для процедур CLR.
Чтобы Компонент Database Engine удалил планы отдельных запросов в процедуре, следует использовать указание запроса RECOMPILE в определении запроса. Дополнительные сведения см. в разделе Указания запросов (Transact-SQL).
ENCRYPTION
Область применения: SQL Server (SQL Server 2008 и выше), База данных SQL Azure.
Показывает, что SQL Server выполняет запутывание исходного текста инструкции CREATE PROCEDURE. Результат запутывания не виден непосредственно ни в одном представлении каталога SQL Server. Пользователи, не имеющие доступа к системным таблицам или файлам баз данных, не смогут получить запутанный текст, однако этот текст доступен привилегированным пользователям, которые либо смогут обращаться к системным таблицам через порт DAC, либо будут иметь непосредственный доступ к файлам баз данных. Кроме того, пользователи, имеющие право на подключение отладчика к серверному процессу, могут получить расшифрованный текст процедуры из памяти во время выполнения. Дополнительные сведения о доступе к метаданным системы см. в статье Настройка видимости метаданных.
Этот параметр недопустим для процедур CLR.
Процедуры, созданные с этим аргументом, не могут быть опубликованы как часть репликации SQL Server.
EXECUTE AS предложение
Определяет контекст безопасности, в котором должна быть выполнена процедура.
Для скомпилированных в собственном коде хранимых процедур, начиная с SQL Server 2016 (13.x); и в База данных SQL Azure, отсутствуют ограничения на предложение EXECUTE AS. В SQL Server 2014 (12.x) предложения SELF, OWNER и user_name поддерживаются с помощью хранимых процедур, скомпилированных в собственном коде.
Дополнительные сведения см. в разделе Предложение EXECUTE AS (Transact-SQL).
FOR REPLICATION
Область применения: SQL Server (SQL Server 2008 и выше), База данных SQL Azure.
Указывает, что процедура создается для репликации. Следовательно, ее нельзя выполнять на подписчике. Процедура, созданная с параметром FOR REPLICATION, используется в качестве фильтра и выполняется только в процессе репликации. Параметры не могут быть объявлены, если указан параметр FOR REPLICATION. Параметр FOR REPLICATION нельзя указывать для процедур CLR. Параметр RECOMPILE не учитывается для процедур, созданных с параметром FOR REPLICATION.
Процедура FOR REPLICATION
имеет тип объекта RF в представлениях sys.objects
и sys.procedures
.
{ [ BEGIN ] sql_statement [;] [ …n ] [ END ] }
Одна или несколько инструкций Transact-SQL, составляющих текст процедуры. Инструкции можно заключить в необязательные ключевые слова BEGIN и END. Дополнительные сведения см. далее в разделах «Рекомендации», «Общие замечания» и «Ограничения».
EXTERNAL NAME assembly_name . class_name . method_name
Применимо к: SQL Server 2008 и выше, База данных SQL.
Указывает метод сборки .NET Framework для процедуры CLR, на которую создается ссылка. Аргумент class_name должен быть допустимым идентификатором SQL Server и существовать как класс в сборке. Если класс имеет квалифицированное имя пространства имен, которое использует точку ( . ) для разделения частей пространства имен, имя класса разделено скобками ( [] ) или кавычками ( «» ). Указанный метод класса должен быть статическим.
По умолчанию SQL Server не производит выполнение кода CLR. Можно создавать, изменять и удалять объекты базы данных со ссылками на модули среды CLR, но SQL Server не выполняет их до тех пор, пока не будет включен параметр clr enabled. Для включения параметра используйте хранимую процедуру sp_configure.
Примечание
Процедуры CLR не поддерживаются в автономной базе данных.
ATOMIC WITH
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Указывает атомарное выполнение хранимой процедуры. Изменения принимаются, либо все изменения откатываются с исключением. Блок ATOMIC WITH требуется для скомпилированных в собственном коде хранимых процедур.
Если процедура возвращает результат (явно с помощью инструкции RETURN либо неявно путем завершения выполнения), выполненная работа фиксируется процедурой. Если процедура выдает ошибку, выполняется откат работы, выполненной процедурой.
Параметр XACT_ABORT по умолчанию имеет значение ON внутри блока ATOMIC и не может быть изменен. Параметр XACT_ABORT указывает, выполняет ли SQL Server автоматический откат текущей транзакции, если инструкция языка Transact-SQL вызывает ошибку выполнения.
Следующие параметры SET всегда имеют значение ON внутри блока ATOMIC; параметры нельзя изменить.
- CONCAT_NULL_YIELDS_NULL
- QUOTED_IDENTIFIER, ARITHABORT
- NOCOUNT
- ANSI_NULLS
- ANSI_WARNINGS
Параметры SET нельзя изменить внутри блоков ATOMIC. Параметры SET пользовательского сеанса не используются в области скомпилированных в собственном коде хранимых процедур. Эти параметры фиксируются во время компиляции.
Операции BEGIN, ROLLBACK и COMMIT нельзя использовать внутри блока ATOMIC.
Для каждой скомпилированной в собственном коде хранимой процедуры существует один блок ATOMIC. Блок входит во внешнюю область процедуры. Блоки не могут быть вложенными. Дополнительные сведения о скомпилированных в собственном коде хранимых процедурах см. в разделе Хранимые процедуры, скомпилированные в собственном коде.
NULL | NOT NULL
Определяет, допустимы ли для параметра значения NULL. Значение по умолчанию — NULL.
NATIVE_COMPILATION
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Указывает, что процедура компилируется в собственном режиме. NATIVE_COMPILATION, SCHEMABINDING и EXECUTE AS можно указывать в любом порядке. Дополнительные сведения см. в статье Хранимые процедуры, скомпилированные в собственном коде.
SCHEMABINDING
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Гарантирует, что таблицы, на которые ссылается процедура, нельзя удалить или изменить. SCHEMABINDING требуется для хранимых процедур, скомпилированных в собственном коде. Дополнительные сведения см. в статье Хранимые процедуры, скомпилированные в собственном коде. Ограничения SCHEMABINDING такие же, как и для определяемых пользователем функций. Дополнительные сведения см. в подразделе SCHEMABINDING раздела CREATE FUNCTION (Transact-SQL).
LANGUAGE = [N] ‘language’
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Эквивалентно параметру сеанса SET LANGUAGE (Transact-SQL). LANGUAGE = [N] ‘language’ (обязательный параметр).
TRANSACTION ISOLATION LEVEL
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Требуется для хранимых процедур, скомпилированных в собственном коде. Указывает уровень изоляции транзакции для хранимой процедуры. Существуют следующие варианты выбора.
Дополнительные сведения об этих параметрах см. в разделе SET TRANSACTION ISOLATION LEVEL (Transact-SQL).
REPEATABLE READ
Указывает, что инструкции не могут считывать данные, которые были изменены другими транзакциями, но еще не были зафиксированы. Если другая транзакция изменяет данные, считанные текущей транзакцией, текущая транзакция завершится с ошибкой.
SERIALIZABLE
Указывает следующее.
- Инструкции не могут считывать данные, которые были изменены другими транзакциями, но еще не были зафиксированы.
- Если другая транзакция изменяет данные, считанные текущей транзакцией, текущая транзакция завершится с ошибкой.
- Если другая транзакция вставляет новые строки со значениями ключа, которые входят в диапазон ключей, считываемых любой инструкцией текущей транзакции, текущая транзакция завершается ошибкой.
SNAPSHOT
Указывает, что данные, считанные любым оператором в транзакции, согласованы с версией данных, которые существовали в начале транзакции.
DATEFIRST = number
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Указывает первый день недели в виде числа от 1 до 7. DATEFIRST — необязательный параметр. Если он не указан, то значение выводится из указанного языка.
Дополнительные сведения см. в разделе SET DATEFIRST (Transact-SQL).
DATEFORMAT = format
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Указывает порядок составляющих даты (месяца, дня и года) для интерпретации символьных строк date, smalldatetime, datetime, datetime2 и datetimeoffset. DATEFORMAT — необязательный параметр. Если он не указан, то значение выводится из указанного языка.
Дополнительные сведения см. в разделе SET DATEFORMAT (Transact-SQL).
DELAYED_DURABILITY = { OFF | ON }
Применимо к: SQL Server 2014 (12.x) и выше, а также База данных SQL Azure.
Фиксации транзакции SQL Server могут быть полностью устойчивыми, использовать настройки по умолчанию или быть отложенными устойчивыми.
Дополнительные сведения см. в разделе Управление устойчивостью транзакций.
Простые примеры
Чтобы помочь вам приступить к работе, рассмотрим два простых примера. SELECT DB_NAME() AS ThisDB;
возвращает имя текущей базы данных.
Можно создать оболочку этой инструкции в хранимой процедуре, например:
CREATE PROC What_DB_is_this
AS
SELECT DB_NAME() AS ThisDB;
Вызов хранимой процедуры с помощью инструкции: EXEC What_DB_is_this;
Немного более сложным вариантом является предоставление входного параметра для повышения уровня гибкости процедуры. Пример:
CREATE PROC What_DB_is_that @ID INT
AS
SELECT DB_NAME(@ID) AS ThatDB;
Укажите идентификационный номер базы данных при вызове процедуры. Например, EXEC What_DB_is_that 2;
возвращает tempdb
.
Множество других примеров см.в разделе Примеры в конце этой статьи.
Рекомендации
Это неполный список рекомендаций, однако данные советы помогут повысить производительность процедур.
- Начинайте текст процедуры с инструкции SET NOCOUNT ON (она должна следовать сразу за ключевым словом AS). В этом случае отключаются сообщения, отправляемые SQL Server клиенту после выполнения любых инструкций SELECT, INSERT, UPDATE, MERGE и DELETE. При этом для ясности создаются минимальные выходные данные. Но на доступном сегодня оборудовании не наблюдается ощутимого повышения производительности. Дополнительные сведения см. в разделе SET NOCOUNT (Transact-SQL).
- При создании или упоминании объектов базы данных в процедуре используйте имена схем. Отсутствие необходимости поиска в нескольких схемах экономит время обработки, затрачиваемое компонентом Компонент Database Engine на разрешение имен объектов. Кроме того, предотвращаются проблемы с разрешениями и доступом, вызываемые назначением схемы по умолчанию для пользователя, когда объекты создаются без указания схемы.
- Не используйте функции-оболочки для столбцов, указанных в предложениях WHERE и JOIN. В таком случае столбцы становятся недетерминированными, и обработчик запросов не может использовать индексы.
- Не используйте скалярные функции в инструкциях SELECT, возвращающих множество строк данных. Поскольку скалярная функция должна применяться к каждой строке, инструкция будет выполняться как обработка на уровне строк, что приводит к снижению производительности.
- Не используйте
SELECT *
. Вместо этого указывайте имена нужных столбцов. Это предотвращает некоторые ошибки компонента Компонент Database Engine, которые останавливают выполнение процедуры. Например, инструкцияSELECT *
, возвращающая данные из таблицы с 12 столбцами, а затем вставляющая эти данные во временную таблицу с 12 столбцами, выполняется успешно, пока не изменится число или порядок столбцов в любой из этих таблиц. - Не выполняйте обработку или передачу слишком большого объема данных. Как можно раньше ограничивайте область результатов в коде процедуры, чтобы все последующие операции, выполняемые процедурой, работали с минимально возможным набором данных. Отправляйте в клиентское приложение только необходимые данные. Это более эффективно, чем передача дополнительных данных по сети, при которой клиентскому приложению приходится обрабатывать необоснованно большие результирующие наборы.
- Используйте явные транзакции, указывая ключевые слова BEGIN/COMMIT TRANSACTION, и по возможности сокращайте транзакции. Длинные транзакции увеличивают время блокировки записей и повышают шанс возникновения взаимоблокировок.
- Используйте функцию Transact-SQL TRY…CATCH для обработки ошибок в пределах процедуры. В конструкцию TRY…CATCH можно инкапсулировать весь блок инструкций Transact-SQL. Это не только снижает расход ресурсов, но также повышает точность отчетов об ошибках и значительно сокращает труд программиста.
- Используйте ключевое слово DEFAULT для всех столбцов таблицы, на которые ссылаются инструкции Transact-SQL CREATE TABLE и ALTER TABLE в тексте процедуры. Это исключает передачу значений NULL в столбцы, которые не допускают значений NULL.
- Используйте ключевые слова NULL и NOT NULL для каждого столбца во временной таблице. Если атрибуты NULL или NOT NULL не указаны в инструкции CREATE TABLE или ALTER TABLE, то способ назначения этих атрибутов столбцам компонентом Компонент Database Engine определяется параметрами ANSI_DFLT_ON и ANSI_DFLT_OFF. Если в контексте соединения выполняется процедура, где значения этих параметров отличаются от значений в соединении, где была создана процедура, то столбцы таблицы, созданной для второго соединения, могут отличаться по признаку допустимости значений NULL и работать иначе. Если атрибут NULL или NOT NULL явно задан для каждого столбца, то временные таблицы создаются с одним и тем же признаком допустимости значений NULL во всех соединениях, где выполняется процедура.
- Используйте инструкции изменения, которые преобразуют значения NULL и исключают из запросов строки, содержащие значения NULL. Учтите, что в Transact-SQL значение NULL не означает пустое значение или отсутствие значения. Это заполнитель для неизвестного значения, который может вызвать непредвиденные результаты, особенно в случае запроса результирующих наборов или использования функций AGGREGATE.
- Используйте оператор UNION ALL вместо операторов UNION и OR, если нет необходимости получить уникальные значения. Для оператора UNION ALL требуется меньше затрат на обработку, поскольку из результирующего набора не исключаются повторы.
Стандартный максимальный размер процедуры не установлен.
Переменные, указанные в процедуре, могут определяться пользователем или быть системными, такими как @@SPID.
При выполнении процедуры в первый раз она компилируется, при этом определяется оптимальный план получения данных. При последующих вызовах процедуры можно снова использовать уже созданный план, если он еще находится в кэше планов компонента Компонент Database Engine.
Процедуры могут выполняться автоматически при запуске SQL Server. Они должны быть созданы системным администратором в базе данных master
и выполняться в контексте предопределенной роли сервера sysadmin в фоновом процессе. Они не могут иметь ни входных, ни выходных параметров. Дополнительные сведения см. в разделе Выполнение хранимых процедур.
Процедуры называются вложенными, если одна процедура вызывает другую или выполняет управляемый код по ссылке на подпрограмму, тип или статистическое выражение среды CLR. Процедуры и ссылки на управляемый код могут быть вложены не более чем на 32 уровня. Уровень вложенности увеличивается на единицу, когда вызванная процедура или управляемый код начинает выполняться, и уменьшается на единицу, когда их выполнение заканчивается. Методы, вызываемые из управляемого кода, не учитываются в этом ограничении. Однако когда хранимая процедура CLR выполняет операции доступа к данным через управляемый поставщик SQL Server, при переходе из управляемого кода в SQL добавляется дополнительный уровень вложенности.
Если уровень вложенности превышает максимальное значение, вся цепочка вызовов заканчивается ошибкой. Получить уровень вложенности текущей выполняемой хранимой процедуры можно через функцию @@NESTLEVEL.
Совместимость
При создании или изменении процедуры Компонент Database Engine компонент Transact-SQL сохраняет значения SET QUOTED_IDENTIFIER и SET ANSI_NULLS. Эти первоначальные значения используются при выполнении процедуры. Таким образом, пока процедура выполняется, любые значения SET QUOTED_IDENTIFIER и SET ANSI_NULLS, задаваемые во время клиентского сеанса, не учитываются.
Другие параметры SET, такие как SET ARITHABORT, SET ANSI_WARNINGS или SET ANSI_PADDINGS, при создании или изменении процедуры не сохраняются. Если логика процедуры зависит от конкретного значения параметра, включите в начало процедуры инструкцию SET, чтобы гарантировать нужное значение. Если инструкция SET выполняется из процедуры, то значение действует только до завершения процедуры. После этого оно принимает прежнее значение, которое имело место при вызове процедуры. Это позволяет клиентам задавать нужные им параметры без влияния на логику процедуры.
Внутри процедуры может быть указана любая инструкция SET, за исключением SET SHOWPLAN_TEXT и SET SHOWPLAN_ALL. Эти инструкции могут встречаться только в пакете. Выбранный параметр SET остается в силе до завершения процедуры, после чего восстанавливает прежнее значение.
Примечание
Значение SET ANSI_WARNINGS не учитывается при передаче параметров процедуре или определяемой пользователем функции, а также при объявлении и задании переменных в инструкции пакета. Например, если объявить переменную как char(3), а затем присвоить ей значение длиннее трех символов, данные будут усечены до размера переменной, а инструкция INSERT или UPDATE завершится без ошибок.
Ограничения
Инструкцию CREATE PROCEDURE нельзя объединять с другими инструкциями Transact-SQL в одном пакете.
Следующие инструкции нельзя использовать нигде в тексте хранимой процедуры.
CREATE | SET | USE |
---|---|---|
CREATE AGGREGATE | SET SHOWPLAN_TEXT | USE database_name |
CREATE DEFAULT | SET SHOWPLAN_XML | |
CREATE RULE | SET PARSEONLY | |
CREATE SCHEMA | SET SHOWPLAN_ALL | |
CREATE или ALTER TRIGGER | ||
CREATE или ALTER FUNCTION | ||
CREATE или ALTER PROCEDURE | ||
CREATE или ALTER VIEW |
Процедура может ссылаться на таблицы, которые еще не существуют. Во время создания хранимой процедуры выполняется только проверка синтаксиса. Процедура не компилируется до первого выполнения. Ссылки на все упоминаемые в процедуре объекты разрешаются только во время компиляции. Таким образом, ничто не мешает создать синтаксически правильную процедуру, ссылающуюся на несуществующие таблицы, однако если эти таблицы отсутствуют во время выполнения хранимой процедуры, она завершится с ошибкой.
Имя функции нельзя указать в качестве значения по умолчанию для параметра или в качестве значения, передаваемого для параметра во время выполнения процедуры. Однако функцию можно передать как переменную, как показано в следующем примере.
-- Passing the function value as a variable.
DECLARE @CheckDate DATETIME = GETDATE();
EXEC dbo.uspGetWhereUsedProductID 819, @CheckDate;
GO
Если процедура вносит изменения на удаленном экземпляре SQL Server, то откат этих изменений будет невозможен. Удаленные процедуры не участвуют в транзакциях.
Чтобы компонент Компонент Database Engine правильно выбрал перегруженную в .NET Framework версию метода, в предложении EXTERNAL NAME необходимо указывать метод следующим образом.
- Он должен быть объявлен как статический метод.
- Он должен принимать то же количество параметров, что и процедура.
- Типы параметров метода должны быть совместимы с типами данных соответствующих параметров процедуры SQL Server. Сведения о соответствии между типами данных SQL Server и .NET Framework см. в разделе Сопоставление данных параметров CLR.
В следующей таблице перечислены представления каталога и динамические административные представления, которые могут использоваться для получения сведений о хранимых процедурах.
Для оценки размера скомпилированной процедуры следует использовать следующие счетчики системного монитора.
Имя объекта системного монитора | Имя счетчика системного монитора |
---|---|
SQLServer: объект Plan Cache | Коэффициент попадания в кэш |
Страницы кэша | |
Счетчик объектов в кэше* |
*Эти счетчики доступны для разных категорий объектов кэша, включая нерегламентированные запросы Transact-SQL, подготовленные запросы Transact-SQL, процедуры, триггеры и т. д. Дополнительные сведения см. в статье SQL Server, объект Plan Cache.
Безопасность
Разрешения
Требуется разрешение CREATE PROCEDURE на базу данных и разрешение ALTER на схему, в которой создается процедура, либо членство в предопределенной роли базы данных db_ddladmin.
Для хранимых процедур CLR пользователь должен владеть сборкой, на которую ссылается предложение EXTERNAL NAME, или иметь разрешение REFERENCES на эту сборку.
CREATE PROCEDURE и таблицы, оптимизированные для памяти
Доступ к оптимизированным для памяти таблицам можно осуществлять из традиционных и скомпилированных в собственном коде хранимых процедур. В большинстве случаев использование собственных процедур является более эффективным способом. Дополнительные сведения см. в статье Хранимые процедуры, скомпилированные в собственном коде.
В следующем примере показано создание скомпилированной в собственном коде хранимой процедуре, имеющей доступ к таблице, оптимизированной для памяти dbo.Departments
.
CREATE PROCEDURE dbo.usp_add_kitchen @dept_id INT, @kitchen_count INT NOT NULL
WITH EXECUTE AS OWNER, SCHEMABINDING, NATIVE_COMPILATION
AS
BEGIN ATOMIC WITH (TRANSACTION ISOLATION LEVEL = SNAPSHOT, LANGUAGE = N'us_english')
UPDATE dbo.Departments
SET kitchen_count = ISNULL(kitchen_count, 0) + @kitchen_count
WHERE ID = @dept_id
END;
GO
Процедуру, созданную без параметра NATIVE_COMPILATION, нельзя преобразовать в хранимую процедуру, скомпилированную в собственном коде.
Описание возможностей программирования в откомпилированных в собственном коде хранимых процедурах, поддерживаемой контактной зоны запроса и операторов см. в разделе Поддерживаемые функции для модулей, скомпилированных в собственном коде T-SQL.
Примеры
Базовый синтаксис
В примерах из этого раздела показаны основные возможности инструкции CREATE PROCEDURE с применением минимально необходимого синтаксиса.
A. Создание простой процедуры Transact-SQL
В следующем примере создается хранимая процедура, возвращающая из представления всех сотрудников (с указанием имени и фамилии), их должности и названия отделов в базе данных AdventureWorks2012. Эта процедура не использует параметры. Далее в примере рассматриваются три метода выполнения процедуры.
CREATE PROCEDURE HumanResources.uspGetAllEmployees
AS
SET NOCOUNT ON;
SELECT LastName, FirstName, JobTitle, Department
FROM HumanResources.vEmployeeDepartment;
GO
SELECT * FROM HumanResources.vEmployeeDepartment;
Процедуру uspGetEmployees
можно выполнять следующими способами.
EXECUTE HumanResources.uspGetAllEmployees;
GO
-- Or
EXEC HumanResources.uspGetAllEmployees;
GO
-- Or, if this procedure is the first statement within a batch:
HumanResources.uspGetAllEmployees;
Б. Возвращение более чем одного результирующего набора
Следующая процедура возвращает два результирующих набора.
CREATE PROCEDURE dbo.uspMultipleResults
AS
SELECT TOP(10) BusinessEntityID, Lastname, FirstName FROM Person.Person;
SELECT TOP(10) CustomerID, AccountNumber FROM Sales.Customer;
GO
В. Создание хранимой процедуры CLR
В следующем примере создается процедура GetPhotoFromDB
, ссылающаяся на метод GetPhotoFromDB
класса LargeObjectBinary
из сборки HandlingLOBUsingCLR
. Перед созданием процедуры сборка HandlingLOBUsingCLR
регистрируется в локальной базе данных.
Применимо к: SQL Server 2008 и выше, База данных SQL (если используется сборка, созданная с помощью assembly_bits).
CREATE ASSEMBLY HandlingLOBUsingCLR
FROM 'MachineNameHandlingLOBUsingCLRbinDebugHandlingLOBUsingCLR.dll';
GO
CREATE PROCEDURE dbo.GetPhotoFromDB
(
@ProductPhotoID INT
, @CurrentDirectory NVARCHAR(1024)
, @FileName NVARCHAR(1024)
)
AS EXTERNAL NAME HandlingLOBUsingCLR.LargeObjectBinary.GetPhotoFromDB;
GO
Передача параметров
Примеры в этом разделе показывают, как использовать входные и выходные параметры для передачи значений в хранимую процедуру и возврата значений из нее.
Г. Создание простой процедуры со входными параметрами
В следующем примере показано создание хранимой процедуры, которая возвращает сведения об определенном сотруднике по переданным значениям фамилии и имени сотрудника. Эта процедура принимает только полные соответствия передаваемым параметрам.
IF OBJECT_ID ( 'HumanResources.uspGetEmployees', 'P' ) IS NOT NULL
DROP PROCEDURE HumanResources.uspGetEmployees;
GO
CREATE PROCEDURE HumanResources.uspGetEmployees
@LastName NVARCHAR(50),
@FirstName NVARCHAR(50)
AS
SET NOCOUNT ON;
SELECT FirstName, LastName, JobTitle, Department
FROM HumanResources.vEmployeeDepartment
WHERE FirstName = @FirstName AND LastName = @LastName;
GO
Процедуру uspGetEmployees
можно выполнять следующими способами.
EXECUTE HumanResources.uspGetEmployees N'Ackerman', N'Pilar';
-- Or
EXEC HumanResources.uspGetEmployees @LastName = N'Ackerman', @FirstName = N'Pilar';
GO
-- Or
EXECUTE HumanResources.uspGetEmployees @FirstName = N'Pilar', @LastName = N'Ackerman';
GO
-- Or, if this procedure is the first statement within a batch:
HumanResources.uspGetEmployees N'Ackerman', N'Pilar';
Д. Использование процедуры с параметрами-шаблонами
В следующем примере показано создание хранимой процедуры, которая возвращает сведения о сотрудниках по переданным полным или частичным значениям имени и фамилии. Эта процедура ищет соответствие полученным параметрам, а если параметры не предоставлены, то используется шаблон, заданный по умолчанию (фамилии, начинающиеся с буквы D
).
IF OBJECT_ID ( 'HumanResources.uspGetEmployees2', 'P' ) IS NOT NULL
DROP PROCEDURE HumanResources.uspGetEmployees2;
GO
CREATE PROCEDURE HumanResources.uspGetEmployees2
@LastName NVARCHAR(50) = N'D%',
@FirstName NVARCHAR(50) = N'%'
AS
SET NOCOUNT ON;
SELECT FirstName, LastName, JobTitle, Department
FROM HumanResources.vEmployeeDepartment
WHERE FirstName LIKE @FirstName AND LastName LIKE @LastName;
Процедуру uspGetEmployees2
можно выполнять во многих сочетаниях. Здесь показаны лишь некоторые из возможных сочетаний.
EXECUTE HumanResources.uspGetEmployees2;
-- Or
EXECUTE HumanResources.uspGetEmployees2 N'Wi%';
-- Or
EXECUTE HumanResources.uspGetEmployees2 @FirstName = N'%';
-- Or
EXECUTE HumanResources.uspGetEmployees2 N'[CK]ars[OE]n';
-- Or
EXECUTE HumanResources.uspGetEmployees2 N'Hesse', N'Stefen';
-- Or
EXECUTE HumanResources.uspGetEmployees2 N'H%', N'S%';
Е. Использование выходных параметров (OUTPUT)
В следующем примере создается процедура uspGetList
. Она возвращает список продуктов, цена на которые не превышает указанную сумму. Данный пример поясняет использование нескольких инструкций SELECT
и нескольких параметров OUTPUT
. Параметры OUTPUT предоставляют внешней процедуре, пакету или нескольким инструкциям Transact-SQL доступ к значениям, заданным во время выполнения процедуры.
IF OBJECT_ID ( 'Production.uspGetList', 'P' ) IS NOT NULL
DROP PROCEDURE Production.uspGetList;
GO
CREATE PROCEDURE Production.uspGetList @Product VARCHAR(40)
, @MaxPrice MONEY
, @ComparePrice MONEY OUTPUT
, @ListPrice MONEY OUT
AS
SET NOCOUNT ON;
SELECT p.[Name] AS Product, p.ListPrice AS 'List Price'
FROM Production.Product AS p
JOIN Production.ProductSubcategory AS s
ON p.ProductSubcategoryID = s.ProductSubcategoryID
WHERE s.[Name] LIKE @Product AND p.ListPrice < @MaxPrice;
-- Populate the output variable @ListPprice.
SET @ListPrice = (SELECT MAX(p.ListPrice)
FROM Production.Product AS p
JOIN Production.ProductSubcategory AS s
ON p.ProductSubcategoryID = s.ProductSubcategoryID
WHERE s.[Name] LIKE @Product AND p.ListPrice < @MaxPrice);
-- Populate the output variable @compareprice.
SET @ComparePrice = @MaxPrice;
GO
Процедура uspGetList
возвращает из базы данных Adventure Works список товаров (велосипедов) стоимостью менее $700
. Параметры OUTPUT``@Cost
и @ComparePrices
используются с языком управления выполнением для вывода информации в окне Сообщения.
Примечание
Переменная OUTPUT должна быть определена при создании процедуры и при использовании переменной. Имена параметра и переменной могут быть разными, однако типы данных и порядок расположения параметров должны совпадать, если только не используется @ListPrice
= variable.
DECLARE @ComparePrice MONEY, @Cost MONEY;
EXECUTE Production.uspGetList '%Bikes%', 700,
@ComparePrice OUT,
@Cost OUTPUT
IF @Cost <= @ComparePrice
BEGIN
PRINT 'These products can be purchased for less than
$'+RTRIM(CAST(@ComparePrice AS VARCHAR(20)))+'.'
END
ELSE
PRINT 'The prices for all products in this category exceed
$'+ RTRIM(CAST(@ComparePrice AS VARCHAR(20)))+'.';
Частичный результирующий набор:
Product List Price
-------------------------- ----------
Road-750 Black, 58 539.99
Mountain-500 Silver, 40 564.99
Mountain-500 Silver, 42 564.99
...
Road-750 Black, 48 539.99
Road-750 Black, 52 539.99
(14 row(s) affected)
These items can be purchased for less than $700.00.
Ж. Использование возвращающих табличные значения параметров
В следующем примере показано использование возвращающего табличное значение параметра для вставки в таблицу нескольких строк. В примере создается тип параметра, объявляется табличная переменная для ссылки, заполняется список параметров, а затем значения передаются в хранимую процедуру. Хранимая процедура использует эти значения для вставки в таблицу нескольких строк.
/* Create a table type. */
CREATE TYPE LocationTableType AS TABLE
( LocationName VARCHAR(50)
, CostRate INT );
GO
/* Create a procedure to receive data for the table-valued parameter. */
CREATE PROCEDURE usp_InsertProductionLocation
@TVP LocationTableType READONLY
AS
SET NOCOUNT ON
INSERT INTO [AdventureWorks2012].[Production].[Location]
([Name]
, [CostRate]
, [Availability]
, [ModifiedDate])
SELECT *, 0, GETDATE()
FROM @TVP;
GO
/* Declare a variable that references the type. */
DECLARE @LocationTVP
AS LocationTableType;
/* Add data to the table variable. */
INSERT INTO @LocationTVP (LocationName, CostRate)
SELECT [Name], 0.00
FROM
[AdventureWorks2012].[Person].[StateProvince];
/* Pass the table variable data to a stored procedure. */
EXEC usp_InsertProductionLocation @LocationTVP;
GO
З. Использование параметра-курсора OUTPUT
В следующем примере используется параметр курсора OUTPUT для возврата курсора, локального относительно процедуры, в вызывающий пакет, процедуру или триггер.
Сначала следует создать процедуру, объявляющую и открывающую курсор для таблицы Currency
:
CREATE PROCEDURE dbo.uspCurrencyCursor
@CurrencyCursor CURSOR VARYING OUTPUT
AS
SET NOCOUNT ON;
SET @CurrencyCursor = CURSOR
FORWARD_ONLY STATIC FOR
SELECT CurrencyCode, Name
FROM Sales.Currency;
OPEN @CurrencyCursor;
GO
Затем выполним пакет, в котором объявляется локальная переменная-курсор, выполняется процедура, назначающая курсор локальной переменной, и извлекаются строки из курсора.
DECLARE @MyCursor CURSOR;
EXEC dbo.uspCurrencyCursor @CurrencyCursor = @MyCursor OUTPUT;
WHILE (@@FETCH_STATUS = 0)
BEGIN;
FETCH NEXT FROM @MyCursor;
END;
CLOSE @MyCursor;
DEALLOCATE @MyCursor;
GO
Изменение данных с помощью хранимой процедуры
Примеры в этом разделе показывают, как производится вставка или изменение данных в таблицах и представлениях путем включения инструкции языка DML в определение процедуры.
И. Использование UPDATE в хранимой процедуре
В следующем примере инструкция UPDATE используется в хранимой процедуре. Процедура принимает один входной параметр @NewHours
и один выходной параметр @RowCount
. Значение параметра @NewHours
используется в инструкции UPDATE для обновления столбца VacationHours
в таблице HumanResources.Employee
. Выходной параметр @RowCount
используется для возврата значения числа задействованных строк в локальную переменную. Выражение CASE используется в предложении SET для условного определения значения, которое задано для столбца VacationHours
. Если для сотрудника применяется почасовая ставка оплаты (SalariedFlag
= 0), то в столбце VacationHours
устанавливается текущее количество часов плюс значение, заданное в @NewHours
. В противном случае в столбце VacationHours
указывается значение, заданное в @NewHours
.
CREATE PROCEDURE HumanResources.Update_VacationHours
@NewHours SMALLINT, @Rowcount INT OUTPUT
AS
SET NOCOUNT ON;
UPDATE HumanResources.Employee
SET VacationHours =
( CASE
WHEN SalariedFlag = 0 THEN VacationHours + @NewHours
ELSE @NewHours
END
)
WHERE CurrentFlag = 1;
SET @Rowcount = @@rowcount;
GO
DECLARE @Rowcount INT
EXEC HumanResources.Update_VacationHours 40, @Rowcount OUTPUT
PRINT @Rowcount;
Обработка ошибок
Примеры в этом разделе показывают, как производится обработка ошибок, которые могут возникнуть при выполнении хранимых процедур.
К. Использование конструкции TRY…CATCH
В следующем примере конструкция TRY…CATCH используется для возврата сведений об ошибках во время выполнения хранимой процедуры.
CREATE PROCEDURE Production.uspDeleteWorkOrder ( @WorkOrderID INT )
AS
SET NOCOUNT ON;
BEGIN TRY
BEGIN TRANSACTION
-- Delete rows from the child table, WorkOrderRouting, for the specified work order.
DELETE FROM Production.WorkOrderRouting
WHERE WorkOrderID = @WorkOrderID;
-- Delete the rows from the parent table, WorkOrder, for the specified work order.
DELETE FROM Production.WorkOrder
WHERE WorkOrderID = @WorkOrderID;
COMMIT
END TRY
BEGIN CATCH
-- Determine if an error occurred.
IF @@TRANCOUNT > 0
ROLLBACK
-- Return the error information.
DECLARE @ErrorMessage NVARCHAR(4000), @ErrorSeverity INT;
SELECT @ErrorMessage = ERROR_MESSAGE(),@ErrorSeverity = ERROR_SEVERITY();
RAISERROR(@ErrorMessage, @ErrorSeverity, 1);
END CATCH;
GO
EXEC Production.uspDeleteWorkOrder 13;
GO
/* Intentionally generate an error by reversing the order in which rows
are deleted from the parent and child tables. This change does not
cause an error when the procedure definition is altered, but produces
an error when the procedure is executed.
*/
ALTER PROCEDURE Production.uspDeleteWorkOrder ( @WorkOrderID INT )
AS
BEGIN TRY
BEGIN TRANSACTION
-- Delete the rows from the parent table, WorkOrder, for the specified work order.
DELETE FROM Production.WorkOrder
WHERE WorkOrderID = @WorkOrderID;
-- Delete rows from the child table, WorkOrderRouting, for the specified work order.
DELETE FROM Production.WorkOrderRouting
WHERE WorkOrderID = @WorkOrderID;
COMMIT TRANSACTION
END TRY
BEGIN CATCH
-- Determine if an error occurred.
IF @@TRANCOUNT > 0
ROLLBACK TRANSACTION
-- Return the error information.
DECLARE @ErrorMessage NVARCHAR(4000), @ErrorSeverity INT;
SELECT @ErrorMessage = ERROR_MESSAGE(),@ErrorSeverity = ERROR_SEVERITY();
RAISERROR(@ErrorMessage, @ErrorSeverity, 1);
END CATCH;
GO
-- Execute the altered procedure.
EXEC Production.uspDeleteWorkOrder 15;
GO
DROP PROCEDURE Production.uspDeleteWorkOrder;
Запутывание определений процедур
Примеры в этом разделе показывают, как применить запутывание к определению хранимой процедуры.
Л. Использование параметра WITH ENCRYPTION
В следующем примере создается процедура HumanResources.uspEncryptThis
.
Применимо к: SQL Server 2008 и выше, база данных SQL.
CREATE PROCEDURE HumanResources.uspEncryptThis
WITH ENCRYPTION
AS
SET NOCOUNT ON;
SELECT BusinessEntityID, JobTitle, NationalIDNumber,
VacationHours, SickLeaveHours
FROM HumanResources.Employee;
GO
Параметр WITH ENCRYPTION
запутывает определение процедуры при запросе системного каталога или использовании функций метаданных, как показано в следующих примерах.
Запустите sp_helptext
.
EXEC sp_helptext 'HumanResources.uspEncryptThis';
Результирующий набор:
The text for object 'HumanResources.uspEncryptThis' is encrypted.
Напрямую выполните запрос к представлению каталога sys.sql_modules
:
SELECT definition FROM sys.sql_modules
WHERE object_id = OBJECT_ID('HumanResources.uspEncryptThis');
Результирующий набор:
definition
--------------------------------
NULL
Примечание
Azure Synapse Analytics не поддерживает системную хранимую процедуру sp_helptext
. Вместо нее используйте представление каталога объектов sys.sql_modules
.
Принудительная перекомпиляция хранимой процедуры
В примерах этого раздела показано использование предложения WITH RECOMPILE для принудительной перекомпиляции процедуры при каждом ее выполнении.
М. Использование параметра WITH RECOMPILE
Предложение WITH RECOMPILE
полезно, если передаваемые в процедуру параметры являются нетипичными или если новый план выполнения процедуры не следует кэшировать или хранить в памяти.
IF OBJECT_ID ( 'dbo.uspProductByVendor', 'P' ) IS NOT NULL
DROP PROCEDURE dbo.uspProductByVendor;
GO
CREATE PROCEDURE dbo.uspProductByVendor @Name VARCHAR(30) = '%'
WITH RECOMPILE
AS
SET NOCOUNT ON;
SELECT v.Name AS 'Vendor name', p.Name AS 'Product name'
FROM Purchasing.Vendor AS v
JOIN Purchasing.ProductVendor AS pv
ON v.BusinessEntityID = pv.BusinessEntityID
JOIN Production.Product AS p
ON pv.ProductID = p.ProductID
WHERE v.Name LIKE @Name;
Задание контекста безопасности
В примерах этого раздела предложение EXECUTE AS используется для задания контекста безопасности, в котором выполняется хранимая процедура.
Н. Использование предложения EXECUTE AS
Следующий пример показывает использование предложения EXECUTE AS для указания контекста безопасности, в котором может выполняться процедура. В данном случае параметр CALLER
указывает, что процедура может выполняться в контексте вызывающего ее пользователя.
CREATE PROCEDURE Purchasing.uspVendorAllInfo
WITH EXECUTE AS CALLER
AS
SET NOCOUNT ON;
SELECT v.Name AS Vendor, p.Name AS 'Product name',
v.CreditRating AS 'Rating',
v.ActiveFlag AS Availability
FROM Purchasing.Vendor v
INNER JOIN Purchasing.ProductVendor pv
ON v.BusinessEntityID = pv.BusinessEntityID
INNER JOIN Production.Product p
ON pv.ProductID = p.ProductID
ORDER BY v.Name ASC;
GO
О. Создание пользовательских наборов разрешений
В следующем примере предложение EXECUTE AS используется для создания пользовательских разрешений для операции базы данных. Некоторые операции (например, TRUNCATE TABLE) не имеют предоставляемых разрешений. Включив инструкцию TRUNCATE TABLE в хранимую процедуру и указав, что эта процедура должна выполняться от имени пользователя, у которого есть разрешения на изменение таблицы, можно предоставить разрешение на усечение таблицы пользователю с разрешением EXECUTE на эту процедуру.
CREATE PROCEDURE dbo.TruncateMyTable
WITH EXECUTE AS SELF
AS TRUNCATE TABLE MyDB..MyTable;
Примеры: Azure Synapse Analytics и Система платформы аналитики (PDW)
П. Создание хранимой процедуры, которая выполняет инструкцию SELECT
В этом примере показан основной синтаксис для создания и выполнения процедуры. При выполнении пакета CREATE PROCEDURE должна быть первой инструкцией. Например, чтобы создать следующую хранимую процедуру в AdventureWorksPDW2012, сначала следует задать контекст базы данных, а затем выполнить инструкцию CREATE PROCEDURE.
-- Uses AdventureWorksDW database
--Run CREATE PROCEDURE as the first statement in a batch.
CREATE PROCEDURE Get10TopResellers
AS
BEGIN
SELECT TOP (10) r.ResellerName, r.AnnualSales
FROM DimReseller AS r
ORDER BY AnnualSales DESC, ResellerName ASC;
END
;
GO
--Show 10 Top Resellers
EXEC Get10TopResellers;
См. также:
- ALTER PROCEDURE (Transact-SQL)
- Язык управления потоком (Transact-SQL)
- Курсоры
- Типы данных (Transact-SQL)
- DECLARE @local_variable (Transact-SQL)
- DROP PROCEDURE (Transact-SQL)
- EXECUTE (Transact-SQL)
- EXECUTE AS (Transact-SQL)
- Хранимые процедуры (компонент Database Engine)
- sp_procoption (Transact-SQL)
- sp_recompile (Transact-SQL)
- sys.sql_modules (Transact-SQL)
- sys.parameters (Transact-SQL)
- sys.procedures (Transact-SQL)
- sys.sql_expression_dependencies (Transact-SQL)
- sys.assembly_modules (Transact-SQL)
- sys.numbered_procedures (Transact-SQL)
- sys.numbered_procedure_parameters (Transact-SQL)
- OBJECT_DEFINITION (Transact-SQL)
- Создание хранимой процедуры
- Использование параметров, возвращающих табличные значения (ядро СУБД)
- Функция динамического управления sys.dm_sql_referenced_entities (Transact-SQL)
- sys.dm_sql_referencing_entities (Transact-SQL)
К вековому юбилею «Дюжины ножей» мы собрали дюжину фактов из жизни одного из самых читаемых авторов последнего десятилетия Российской Империи.
visit-petersburg.ru
Севастополь образца 1880-х. Из собрания Русского музея.
1. Короткие штанишки
Он родился в Севастополе, в многодетной семье купца, и путаница с датой его рождения будет продолжаться больше века. На его могиле выбит год 1884-й, советская энциклопедия указывает 1881-й, и лишь относительно недавно доподлинно установлена точная дата – 15 (27) марта 1880-го. Образование – куценькое, в нынешней терминологии неполное среднее. Но шушукались, прежде всего в черносотенных кругах, о другом. Всякий раз, когда кто-то говорил ему: «Аркадий Тимофеевич, наверное, вы всё-таки еврей», он притворно вздыхал в ответ: «Ну вот… Опять раздеваться».
2. Во глубине Донбасских руд
С пятнадцати лет от роду Аверченко служил мальчиком на побегушках в частной транспортной конторе, а в 1897-м завербовался на Донбасс, конторщиком в правление рудников: «Это был самый грязный и глухой рудник в свете. Между осенью и другими временами года разница заключалась лишь в том, что осенью грязь была там выше колен, а в другое время — ниже. И все обитатели этого места пили, как сапожники, и я пил не хуже других». По счастью, в будущем контора правления перебазировалась в благородный и культурный Харьков. И Аверченко вместе с ней. В противном случае, кто знает, может, и в самом деле спился бы.
wikimedia.org
В своих харьковских журналах Аверченко не только писал сатирические тексты, но и недурно рисовал карикатуры. Фрагмент полосы журнала «Штык» №9, 1907.
3. Осерчавший губернатор
От унылой беспросветности канцелярского труда по-прежнему мелкий клерк Аверченко решает заняться литературным ремеслом. В октябре 1903-го в харьковской газете «Южный край» печатается его первый рассказ. Начало положено. В революционном 1905-м Аверченко запускает остросатирический журнал «Штык». А когда власти закрывают издание, начинает издавать еще более острый «Меч»: сам пишет, сам редактирует, сам рисует карикатуры. Журнал пользуется бешеной популярностью у всех харькивьян, за исключением здешнего генерал-губернатора Пешкова: в 1907-м своим волевым решением он закрывает «Меч», а заодно дает команду уволить нахального конторщика. «Вы хороший человек, но ни к черту не годитесь», — резюмировал директор рудников, визируя приказ об увольнении. Все, в Харькове Аверченко больше ловить нечего. В начале 1908-го он уезжает в столицу.
4. Куча поганок
В ту пору на лотках и прилавках Петербурга в глазах рябило от количества предлагаемых изданий. Александр Куприн вспоминал: «Тогда, как грибы поганки после дождя, начали ежедневно расти в большом количестве юмористические и сатирические журналы. Правда, большинство из них не успевало прожить больше недели». А чего стоили одни названия: «Адская Почта», «Бич», «Жало», «Пули», «Секира», «Яд». Большинство были оппозиционными, но беспартийными по сути. Перебравшийся в столицу Аверченко делает свой выбор и поступает в «Стрекозу». В тот самый журнал, где в 1880-м дебютировал Антон Палыч. Который Чехов.
из архива автора
Реклама ресторана «Вена» в журнале «Новый Сатирикон». 1913.
5. Взлетел стрекозой
Рассказывает Александр Куприн: «Вот именно в пивной лавке на углу Чернышева переулка и Фонтанки, где обычно заседали старые писари, специалисты писать на высочайшее имя, и где весьма искусно варили раков, там я прочитал впервые, в «Стрекозе», один из прелестных маленьких рассказов Аверченко, а прочитав, взволновался, умилился, рассмеялся и обрадовался…». Эти двое быстро сошлись и подружились. Помимо дел литературных, их объединили совместное увлечение французской борьбой и шумные кутежи в самом литературном питерском ресторане того времени – в «Вене», что на улице Гоголя, ныне – Малой Морской.
Фотопортрет А.Т.Аверченко. 1913, ателье Карла Буллы. Снимок находится в общественном достоянии.
6. Талантливый яд
Буквально за считанные месяцы провинциальный журналист Аверченко покорил столицу, став одним из ведущих сотрудников, а затем и редактором нового сатирического журнала «Сатирикон», созданного на базе терявшей популярность и нуждавшейся в реорганизации «Стрекозы». Уже в первом номере (1 апреля 1908) редакция дерзко заявила: «Мы будем хлестко и безжалостно бичевать все беззакония, ложь и пошлость, которые царят в нашей политической и общественной жизни. Смех, ужасный ядовитый смех, подобный жалам скорпионов, будет нашим оружием».
В «Сатириконе» у Аверченко обнаружился редкий дар объединять вокруг общего классного дела исключительно талантливых людей. В разные годы с журналом сотрудничали такие мастера, как Бакст, Добужинский, Билибин, Кустодиев, Тэффи, Саша Черный, Мандельштам, Маяковский, Куприн, Алексей Толстой, Леонид Андреев, Грин. При этом редактор Аверченко никогда не правил чужие рукописи: «Пусть сами за себя отвечают». Неурядицы с учредителями, в том числе финансовые, привели к тому, что в 1913 году Аверченко взялся самостоятельно издавать журнал «Новый Сатирикон». Большая часть старой команды переметнулась к нему, а популярность журнала с этого времени распространилась уже по всей империи.
wikimedia.org
Белые пятна на полосах «Сатирикона», в местах, где размещались зарезанные цензурой произведения или рисунки, это еще полбеды. Случалось, из продажи изымались целые номера журнала.
7. В гости к царю не пошел
В своих номерах «Сатирикон» часто обращался к политической сатире, по коей причине нередко выходил с белыми пятнами на полосах. Доведенный до бешенства придирками цензуры Аверченко отзывался об умственных способностях членов столичного цензурного комитета так: «Какое-то сплошное безысходное царство свинцовых голов, медных лбов и чугунных мозгов. Расцвет русской металлургии». И все же журналу удавалось держать марку, и, искусно лавируя меж цензурных подводных камней, оставаться острозлободневными.
От них изрядно доставалось всей российской политической элите, включая «святого старца» Распутина. Кстати сказать, через Главное управление по делам печати Николай II много раз пытался прекратить поток оскорблений и нападок, изливаемый прессой на Распутина, однако оснований не находилось – российский закон не препятствовал критиковать недостойные действия частных лиц. О как! Но в отношении самого монарха и членов его августейшей фамилии сатириконовцы вынужденно пользовались эзоповым языком. Впрочем, в части вынужденности момент дискуссионный, учитывая, что при всей своей внешней радикальности, на основы существующего строя журнал не посягал. За что, к слову, его всячески шпыняли большевики. Хотя тот же Урицкий вспоминал, что в эмиграции «для него, для Ленина и некоторых его друзей получение этого журнала было настоящим праздником».
wikimedia.org
Реклама новой книги Аверченко (1917), экземпляр которой находился в личной библиотеке императрицы Александры Федоровны. 7 мая 1918 года Николай II запишет в своем тобольском дневнике: «Вчера начал читать вслух книгу Аверченко «Синее с золотом»»… До расстрела царской семьи оставалось чуть более двух месяцев.
Занятно, что таким же праздником «Сатирикон» служил и для членов царской семьи – каждый новый выпуск в Царском Селе читали от корки до корки. Супруги Романовы и их дети особенно любили прозу Аверченко и Тэффи, и стихи Саши Черного. Каждая сольная новинка от этих авторов обязательно приобреталась в личную библиотеку, причем, говорят, император собственноручно переплетал их в кожу и атлас. Однажды Николай II даже пригласил Аверченко к себе, в Царское – почитать вслух. Но тот не поехал, притворившись больным. И все равно был подвергнут обструкции Куприным, который выговаривал другу: «Надо суметь так себя поставить в литературе и в жизни, чтобы самодержцу и в голову не могло прийти — звать тебя в гости!».
Карикатура из «Нового Сатирикона» (№42, 1917).
Фото: wikimedia.org
8. Одну революцию принял, другую нет
Февральскую 1917-го Аверченко принял с надеждой и радостью, а от октябрьского переворота пришел в ужас, поименовав его «пришествием Хама». И сам Аверченко, и большая часть редакции «Нового Сатирикона» заняли по отношению к советской власти резко отрицательную позицию. В августе 1918-го правительственным распоряжением журнал был закрыт. Даже странно, что не раньше. Часть сотрудников, включая самого Аверченко, подались в эмиграцию, а оставшиеся стали сотрудничать с советской прессой. Уже оказавшись в Европе на вопрос, как он относится к большевикам, Аркадий Тимофеевич ответит: «Это дело вкуса. Некоторым и индийская чума нравится. В особенности если она не у него, а у соседа».
9. Уходил на миноносце
После закрытия журнала, не без оснований опасаясь ареста Аверченко бежал из Петрограда в Москву. Оттуда, на пару с Тэффи, в Киев.
Рассказывает Надежда Тэффи: «Мои хлопоты по отъезду уже почти закончились. Сундук был уложен. Другой сундук, в котором были сложены (последнее мое увлечение) старинные русские шали, поставлен был в квартире Лоло.
– А вдруг за это время назначат какую-нибудь неделю бедноты или, наоборот, неделю элегантности, и все эти вещи конфискуют?
Я попросила в случае опасности заявить, что сундук пролетарского происхождения, принадлежит бывшей кухарке Федосье. А чтобы лучше поверили и вообще отнеслись с уважением – положила сверху портрет Ленина с надписью: «Душеньке Феничке в знак приятнейших воспоминаний. Любящий Вова». Впоследствии оказалось, что и это не помогло…».
Первую половину 1919-го Аверченко провел в городах занятого белыми юга России, а затем обосновался в родном Севастополе. Здесь он стал активно сотрудничать с газетой «Юг», сочиняя тексты в пользу Добровольческой армии: «После такого со мной обращения «рабоче-крестьянской», для меня золотопогонник приятнее родного любимого дяди! Потому, что ежели что выбирать из двух, то я предпочитаю, чтобы мне на ногу наступили, чем снесли полчерепа наганом». Остались свидетельства, что по заказу белогвардейского генштаба он порой сочинял шутливые тексты для прокламаций, которыми осыпали с аэропланов окопы красных бойцов. 15 ноября 1920-го Аверченко покинул Крым на миноносце, на котором, с его слов, находились три моряка и семь гимназистов: «Вот где я получил настоящее удовольствие! В течение двух дней я был заправским капитаном самого настоящего миноносца. Это, брат, тебе не фельетоны писать».
izbrannoe.com
Обложка первого издания «Дюжины ножей».
10. Ильича зацепило
Еще в Севастополе Аверченко написал большую часть текстов-памфлетов для сборника «Дюжина ножей в спину революции», который в 1921 году был издан в Париже. Удивительным образом экземпляр книги добрался до большевистской Москвы и попал в руки Ленину. Еще удивительнее, что Ильич не просто внимательно прочел ее, но написал отзыв и отослал для публикации в «Правду». Под псевдонимом «Н. Ленин» и под заголовком «Талантливая книжка». И это при том, что после октября 1917-го рецензий на художественные произведения Владимир Ильич не писал в принципе. Получается, сделал исключение только для Аверченко. Больше того: начав за упокой — «Это – книжка озлобленного почти до умопомрачения белогвардейца Аркадия Аверченко…», Ильич окончил текст сугубо за здравие — «Некоторые рассказы, по-моему, заслуживают перепечатки. Талант надо поощрять». Говорят, подобное внимание большевистского вождя самого Аркадия Тимофеевича раздосадовало. В ответ он написал фельетон «Pro doma sua», в котором грустно скаламбурил: «Сам Ленин вдруг меня заметил, и в гроб сходя благословил».
Аверченко, Николая II и Ленина связывало хотя бы то, что дореволюционное издание книги «Синее с золотом» обнаружили в Екатеринбурге, в комнате расстрелянного большевиками императора, а изданный в Париже сборник писателя «Дюжина ножей в спину революции» хранился в кабинете скончавшегося в Горках Ильича.
Та самая ленинская рецензия на Аверченко. «Правда», №263, 22 ноября 1921.
11. Не вывезли за ненадобностью
В 1922 году Аверченко поселился в Праге. За свои немногие эмигрантские годы он много мотался по Европе, читал на публике свои старые и новые рассказы. Правда, с новыми получалось не очень: «Тяжело как-то стало писать… Не пишется. Как будто не на настоящем стою». Вскоре он тяжело заболел. Казалось, начал поправляться, но после возвращения с курорта снова попал в больницу, и 12 марта 1925-го скончался на больничной койке в возрасте 44-х лет. Диагноз: полное ослабление сердечной мышцы, расширение аорты и склероз почек.
В своем завещании писатель просил вернуть его прах на родину. По этой причине тело Аверченко положили в металлический гроб и заключили в специальный футляр на случай, если кто-либо в будущем возьмется доставить гроб на родину. Но по сей день прах русского писателя покоится на Ольшанском кладбище Праги, где поставлен более чем скромный памятник. С высеченной на мраморе неверной датой рождения.
journal.spbu.ru
Могила Аверченко
12. Гордость не наш конёк
Рассказывает Аркадий Бухов (1889-1937; экс-сатириконовец, советский писатель): «Место, занимаемое Аверченкой в русской литературе, единственное, им созданное и незаменимое. Это русский Джером. Разница та, что Джеромом гордится Англия, а Россия Аверченко не гордится только потому, что гордость есть чувство нерусское… Будь Аверченко французом, его именем назвали бы улицу, площадь … «.
Игорь Шушарин,
47news
Чтобы первыми узнавать о главных событиях в Ленинградской области — подписывайтесь на канал 47news в Telegram