EXECUTE (Transact-SQL)

  • Статья

Выполняет командную строку — строку символов, в которой содержится пакет Transact-SQL или один из следующих модулей: системная хранимая процедура, пользовательская хранимая процедура, хранимая процедура среды CLR, скалярная, определяемая пользователем функция или расширенная хранимая процедура. Инструкция EXECUTE может использоваться для отправки транзитных команд на связанные серверы. или явно указывать контекст, в котором выполняется команда. Метаданные для результирующего набора могут быть определены с помощью параметров WITH RESULT SETS.

Примечание по безопасностиПримечание по безопасности

Прежде чем передавать инструкции EXECUTE строку символов, выполните ее проверку.Ни в коем случае не запускайте на выполнение команду, которая сформирована на основе данных, введенных пользователем, и не проверена.

Применимо для следующих объектов: SQL Server (SQL Server 2008 по текущую версию), База данных SQL Windows Azure (С первоначального выпуска по текущий выпуск).

Значок ссылки на раздел Cинтаксические обозначения в Transact-SQL

Синтаксис

-- SQL Server Syntax

Execute a stored procedure or function
[ { EXEC | EXECUTE } ]
    { 
      [ @return_status = ]
      { module_name [ ;number ] | @module_name_var } 
        [ [ @parameter = ] { value 
                           | @variable [ OUTPUT ] 
                           | [ DEFAULT ] 
                           }
        ]
      [ ,...n ]
      [ WITH <execute_option> [ ,...n ] ]
    }
[;]

Execute a character string
{ EXEC | EXECUTE } 
    ( { @string_variable | [ N ]'tsql_string' } [ + ...n ] )
    [ AS { LOGIN | USER } = ' name ' ]
[;]

Execute a pass-through command against a linked server
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ] 'command_string [ ? ]' } [ + ...n ]
        [ { , { value | @variable [ OUTPUT ] } } [ ...n ] ]
    ) 
    [ AS { LOGIN | USER } = ' name ' ]
    [ AT linked_server_name ]
[;]

<execute_option>::=
{
        RECOMPILE 
    | { RESULT SETS UNDEFINED } 
    | { RESULT SETS NONE } 
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
} 

<result_sets_definition> ::= 
{
    (
         { column_name 
           data_type 
         [ COLLATE collation_name ] 
         [ NULL | NOT NULL ] }
         [,...n ]
    )
    | AS OBJECT 
        [ db_name . [ schema_name ] . | schema_name . ] 
        {table_name | view_name | table_valued_function_name }
    | AS TYPE [ schema_name.]table_type_name
    | AS FOR XML 
}

-- Windows Azure SQL Database 

Execute a stored procedure or function
[ { EXEC | EXECUTE } ]
    { 
      [ @return_status = ]
      { module_name  | @module_name_var } 
        [ [ @parameter = ] { value 
                           | @variable [ OUTPUT ] 
                           | [ DEFAULT ] 
                           }
        ]
      [ ,...n ]
      [ WITH RECOMPILE ]
    }
[;]

Execute a character string
{ EXEC | EXECUTE } 
    ( { @string_variable | [ N ]'tsql_string' } [ + ...n ] )
    [ AS {  USER } = ' name ' ]
[;]

<execute_option>::=
{
        RECOMPILE 
    | { RESULT SETS UNDEFINED } 
    | { RESULT SETS NONE } 
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
} 

<result_sets_definition> ::= 
{
    (
         { column_name 
           data_type 
         [ COLLATE collation_name ] 
         [ NULL | NOT NULL ] }
         [,...n ]
    )
    | AS OBJECT 
        [ db_name . [ schema_name ] . | schema_name . ] 
        {table_name | view_name | table_valued_function_name }
    | AS TYPE [ schema_name.]table_type_name
    | AS FOR XML

Аргументы

  • @return\_status
    Необязательная целочисленная переменная, в которой сохраняется состояние возврата из модуля. Этот аргумент должен быть объявлен в пакете, хранимой процедуре или функции, прежде чем его можно будет указать в инструкции EXECUTE.

    Если используется для вызова скалярной, определяемой пользователем функции, переменная @return\_status может иметь любой скалярный тип данных.

  • module_name
    Полное или неполное имя вызываемой хранимой процедуры или скалярной пользовательской функции. Имена модулей должны соответствовать правилам для идентификаторов. В именах расширенных хранимых процедур учитывается регистр, вне зависимости от параметров сортировки сервера.

    Допускается выполнение модуля, созданного в другой базе данных, если пользователь, выполняющий этот модуль, является его владельцем или имеет соответствующие разрешения на его выполнение в этой базе данных. Модуль может быть выполнен на другом сервере SQL Server, если пользователь, запускающий модуль на выполнение, имеет соответствующие разрешения на этом сервере (удаленный доступ) и на выполнение модуля в этой базе данных. Если указано имя сервера, а имя базы данных не указано, компонент Компонент SQL Server Database Engine ищет модуль в базе данных пользователя по умолчанию.

  • ;number

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    Необязательный целочисленный аргумент, используемый для группирования одноименных процедур. Этот аргумент не предназначен для расширенных хранимых процедур.

    Примечание

    В будущей версии Microsoft SQL Server этот компонент будет удален. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется.

    Дополнительные сведения о группах процедур см. в разделе CREATE PROCEDURE (Transact-SQL).

  • @module\_name\_var
    Имя локально определенной переменной, которая содержит имя модуля.

  • @parameter
    Аргумент для модуля с именем module_name, как определено в модуле. Имена параметров должны предваряться символом (@). Если используется в формате @parameter\_name=value, то имена параметров и констант могут указываться не в том порядке, в котором они определены в модуле. Однако если какой-либо из параметров указан в формате @parameter\_name=value, то все последующие параметры должны быть указаны в том же формате.

    По умолчанию параметры могут допускать значения NULL.

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

    При выполнении транзитных команд для связанных серверов порядок значений параметров зависит от поставщика OLE DB связанного сервера. Большинство поставщиков OLE DB привязывают значения к аргументам слева направо.

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

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

    Значение по умолчанию может быть равно NULL. Как правило, действие, которое должно быть выполнено в этом случае, указывается в определении модуля.

  • @variable
    Переменная, в которой сохраняется или возвращается аргумент.

  • OUTPUT
    Указывает, что модуль или командная строка возвращает параметр. Совпадающий параметр модуля или командной строки также должен быть создан с ключевым словом OUTPUT. Это ключевое слово следует указывать для переменной курсора, если она передается в качестве аргумента.

    Если value определен как OUTPUT модуля, выполняемого для связанного сервера, то любые изменения в соответствующем параметре @parameter, произведенные поставщиком OLE DB, по окончании выполнения модуля будут скопированы обратно в переменную.

    Если используются параметры OUTPUT и предполагается использовать возвращаемые значения в других инструкциях вызываемого пакета или модуля, значение параметра должно передаваться в виде переменной, то есть @parameter = @variable. Выполнить модуль, указав OUTPUT для параметра, который не определен в модуле как параметр OUTPUT, нельзя. Константы в качестве аргументов OUTPUT в модуль не передаются, а для возврата аргумента необходимо указывать имя переменной. Перед выполнением процедуры для переменной должен быть объявлен тип данных и присвоено значение.

    Если EXECUTE выполняет удаленную хранимую процедуру или транзитную команду к связанному серверу, то параметры OUTPUT не могут иметь типы данных больших объектов (LOB).

    Возвращаемые аргументы могут иметь любой тип, кроме типов данных LOB.

  • DEFAULT
    Определяет значение параметра по умолчанию, как определено в модуле. Если в модуле для параметра не определено значения по умолчанию, а при вызове для этого параметра ни значение, ни ключевое слово DEFAULT не указаны, выдается ошибка.

  • @string\_variable
    Имя локальной переменной. Аргумент @string\_variable может иметь тип данных char, varchar, nchar или nvarchar. , в том числе с ключевым словом (max).

  • [N] 'tsql_string'
    Строковая константа. Аргумент tsql_string может иметь типу данных nvarchar или varchar. Если указано «N», строка интерпретируется как nvarchar.

  • AS <указание_контекста>
    Определяет контекст, в котором выполняется инструкция.

  • LOGIN

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    Указывает, что воплощаемым контекстом является имя входа, область олицетворения — сервер.

  • USER
    Определяет контекст для олицетворения пользователя в текущей базе данных. Область олицетворения ограничена текущей базой данных. При переключении контекста на пользователя базы данных разрешения уровня сервера этого пользователя не наследуются.

    Важное примечаниеВажно!

    Пока активно переключение контекста на пользователя базы данных, любая попытка доступа к ресурсам за ее пределами вызовет ошибку выполнения инструкции.Это относится к инструкциям USE database, распределенным запросам, а также запросам, содержащим ссылки на другие базы данных по идентификаторам, состоящим из трех или четырех элементов.

  • 'name'
    Допустимое имя пользователя или имя входа. Пользователь name должен принадлежать предопределенной роли сервера sysadmin либо быть участником в базе данных sys.database_principals или sys.server_principals соответственно.

    В качестве аргумента name не может быть указана встроенная учетная запись (например NT AUTHORITY\LocalService, NT AUTHORITY\NetworkService или NT AUTHORITY\LocalSystem).

    Дополнительные сведения см. в разделе Указание имени пользователя или имени входа далее.

  • [N] 'command_string'
    Строковая константа, содержащая транзитную команду, передаваемую связанному серверу. Если указано «N», строка интерпретируется как nvarchar.

  • [?]
    Обозначает параметры, для которых задаются значения в списке <arg-list> сквозных команд, используемых в инструкции EXEC('…', <arg-list>) AT <linkedsrv>.

  • AT linked_server_name

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    Указывает, что command_string выполняется для linked_server_name, а результаты, при их наличии, возвращаются клиенту. Значение linked_server_name должно указывать на существующее определение связанного сервера на локальном сервере. Определение связанного сервера производится при помощи хранимой процедуры sp_addlinkedserver.

  • WITH <execute_option>
    Возможные параметры выполнения. Параметры RESULT SETS нельзя указывать в инструкции INSERT…EXEC.

    Термин

    Определение

    RECOMPILE

    Инициирует перекомпиляцию нового плана, его использование и удаление после выполнения модуля. Если для модуля имеется существующий план запроса, то он остается в кэше.

    Следует указывать этот параметр в тех случаях, когда передаются нетипичные аргументы или если данные существенно изменились. Он не предназначен для расширенных хранимых процедур. Рекомендуется реже пользоваться этим параметром, поскольку он очень ресурсоемок.

    Примечание

    Использовать параметр WITH RECOMPILE при вызове хранимой процедуры, для которой применяется синтаксис OPENDATASOURCE, нельзя.Параметр WITH RECOMPILE не учитывается при указании четырехкомпонентного имени объекта.

    RESULT SETS UNDEFINED

    Применимо для следующих объектов: От SQL Server 2012 до SQL Server 2014, База данных SQL Windows Azure.

    		 
    </div>
<p>Этот параметр не дает гарантии, какие результаты, если они есть, будут возвращены. Определение также не предоставляется. Инструкция выполняется без ошибок, независимо от того, возвращаются ли какие-либо результаты. RESULT SETS UNDEFINED — действие по умолчанию, если не указан result_sets_option.</p></td>
</tr>
<tr class="odd">
<td><p>RESULT SETS NONE</p></td>
<td><div class="caption">

</div>
<div class="tableSection">
<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<tbody>
<tr class="odd">
<td><p><strong>Применимо для следующих объектов</strong>: От SQL Server 2012 до SQL Server 2014, База данных SQL Windows Azure.</p></td>
</tr>
</tbody>
</table>

</div>
<p>Гарантирует, что выполняемая инструкция не вернет никаких результатов. Если возвращены какие-либо результаты, то пакет отменяется.</p></td>
</tr>
<tr class="even">
<td><p>&lt;result_sets_definition&gt;</p></td>
<td><div class="caption">

</div>
<div class="tableSection">
<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<tbody>
<tr class="odd">
<td><p><strong>Применимо для следующих объектов</strong>: От SQL Server 2012 до SQL Server 2014, База данных SQL Windows Azure.</p></td>
</tr>
</tbody>
</table>

</div>
<p>Обеспечивает гарантию, что результат будет возвращен в виде, определенном в result_sets_definition. Укажите несколько разделов result_sets_definition для инструкций, которые возвращают несколько результирующих наборов. Заключите каждый раздел result_sets_definition в круглые скобки, разделяя их запятыми. Дополнительные сведения см. в подразделе &lt;result_sets_definition&gt; ниже в этом разделе.</p></td>
</tr>
</tbody>
</table>

    • <result_sets_definition>

      Применимо для следующих объектов: От SQL Server 2012 до SQL Server 2014, База данных SQL Windows Azure.

      Описывает результирующие наборы, возвращенные выполненными инструкциями. Предложения result_sets_definition имеют следующий смысл

      Термин

      Определение

      {

          column_name

          data_type

          [ COLLATE collation_name]

          [NULL | NOT NULL]

      }

      Термин

      Определение

      column_name

      Имена всех столбцов. Если число столбцов отличается от результирующего набора, возникнет ошибка и пакет будет отменен. Если имя столбца отличается от результирующего набора, то возвращаемое имя столбца будет установлено в имя из определения.

      Тип данных

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

      COLLATE collation_name

      Параметры сортировки для каждого из столбцов. При несоответствии параметров сортировки предпринимается попытка неявного его приведения. Если это сделать не удалось, пакет отменяется.

      NULL | NOT NULL

      Допустимость значения NULL для каждого из столбцов. Если определено NOT NULL, а возвращенные данные содержат значения NULL, то возникает ошибка и пакет отменяется. Если ничего не указано, то значение по умолчанию соответствует параметрам ANSI_NULL_DFLT_ON и ANSI_NULL_DFLT_OFF.

      db_name

      Имя базы данных, содержащей таблицу, представление или возвращающую табличное значение функцию.

      имя_схемы

      Имя схемы, являющейся владельцем таблицы, представления или возвращающей табличное значение функции.

      table_name | view_name | table_valued_function_name

      Указывает, что будут возвращены столбцы, указанные в таблице, представлении или возвращающей табличное значение функции. Табличные переменные, временные таблицы и синонимы не поддерживаются синтаксисом объектов AS.

      AS TYPE [schema_name.]table_type_name

      Указывает, что будут возвращены столбцы, указанные в типе таблицы.

      AS FOR XML

      Указывает, что результаты XML, полученные от инструкции или хранимой процедуры, которая вызывается с помощью инструкции EXECUTE, преобразуются в формат, как если бы они были сформированы инструкцией SELECT… FOR XML… Все форматирование директив типов удаляется из исходной инструкции, а результаты возвращаются, как если бы директива типа не была указана. AS FOR XML не преобразует в XML отличные от XML табличные результаты, полученные от выполненной инструкции или хранимой процедуры.

      Фактический результирующий набор, возвращаемый во время выполнения, может отличаться от результата, заданного в предложении WITH RESULT SETS по одному из следующих признаков: число результирующих наборов, число столбцов, имена столбцов, допустимость значений NULL или типы данных. Если отличается число результирующих наборов, возникнет ошибка, и пакет будет отменен.

    Замечания

    Параметры могут передаваться через value или с помощью @parameter\_name =value. Параметр не является частью транзакции, поэтому, если он изменился в транзакции, которая впоследствии была отменена, прежнее значение параметра не восстанавливается. Возвращаемым вызывающему значением всегда является то значение, которое существует на момент выхода из модуля.

    Если модуль вызывает другой модуль, выполняет управляемый код модуля среды CLR, определяемого пользователем типа или статистического выражения, возникает вложенность. Уровень вложенности увеличивается каждый раз, когда вызванный модуль или управляемый код начинает выполнение, и уменьшается при завершении его выполнения. Превышение максимальной вложенности (32 уровня) приводит к ошибке выполнения всей цепочки вызовов. Текущий уровень вложенности возвращает системная функция @@NESTLEVEL.

    Поскольку удаленные хранимые процедуры и расширенные хранимые процедуры не входят в область транзакции (это не относится к транзакциям, начатым инструкцией BEGIN DISTRIBUTED TRANSACTION или при указании различных параметров конфигурации), осуществить откат команд, выполняемых через вызовы к ним, невозможно. Дополнительные сведения см. в разделах Системные хранимые процедуры (Transact-SQL) и BEGIN DISTRIBUTED TRANSACTION (Transact-SQL).

    Если выполняется процедура, которая передает переменную типа cursor с размещенным в ней курсором, то возникает ошибка.

    Не надо указывать ключевое слово EXECUTE при выполнении модулей, если эта инструкция стоит первой в пакете.

    Дополнительные сведения, относящиеся к хранимым процедурам CLR, см. в разделе «Хранимые процедуры CLR».

    Выполнение хранимых процедур через EXECUTE

    Не надо указывать ключевое слово EXECUTE при выполнении хранимых процедур, если эта инструкция стоит первой в пакете.

    Имена системных хранимых процедур SQL Serverначинаются с префикса sp_. Физически они хранятся в базе данных Resource, но логически относятся к схеме sys любой системной или пользовательской базы данных. При выполнении системной расширенной хранимой процедуры (в пакете или в модуле, например в пользовательской хранимой процедуре или функции) рекомендуется предварять ее имя указанием схемы sys.

    Системные расширенные хранимые процедуры SQL Server имеют имена, начинающиеся с префикса xp_,, и хранятся в схеме dbo базы данных master. При выполнении системной расширенной хранимой процедуры (в пакете или в модуле, например в пользовательской хранимой процедуре или функции) рекомендуется предварять ее имя указанием master.dbo.

    При выполнении пользовательской хранимой процедуры (в пакете или в модуле, например в пользовательской хранимой процедуре или функции) рекомендуется предварять ее имя указанием схемы. Не рекомендуется давать пользовательским хранимым процедурам те же имена, что и системным. Дополнительные сведения о выполнении хранимых процедур см. в разделе Выполнение хранимой процедуры.

    Указание в EXECUTE символьных строк

    В предыдущих версиях SQL Server длина символьной строки была ограничена 8 000 байт. Это требовало динамического объединения длинных строк во время выполнения. В SQL Server можно указать тип данных varchar(max) или nvarchar(max), который позволяет символьным строкам содержать до 2 ГБ данных.

    Изменения в контексте базы данных действуют только до окончания инструкции EXECUTE. Например, после запуска инструкции EXEC контекстом базы данных становится master.

    USE master; EXEC ('USE AdventureWorks2012; SELECT BusinessEntityID, JobTitle FROM HumanResources.Employee;');

    Переключение контекста

    Предложение AS { LOGIN | USER } = ' name ' переключает контекст выполнения динамической инструкции. Если переключение контекста указано в виде EXECUTE ('string') AS <context_specification>, его длительность ограничена областью действия запроса, в котором он выполняется.

    Указание имени пользователя или имени входа

    Пользователь или имя входа, указанные в AS { LOGIN | USER } = ' name ', должны существовать в качестве участников в sys.database_principals или sys.server_principals соответственно, в противном случае инструкция завершится ошибкой. Кроме того, этому участнику должны быть предоставлены разрешения IMPERSONATE. Если процедура вызывается не владельцем базы данных и не членом предопределенной роли сервера sysadmin, указанный участник должен существовать даже в том случае, если пользователь производит доступ к базе данных или экземпляру SQL Server через членство в группе Windows. Для примера рассмотрим следующие условия.

    • Группа CompanyDomain\SQLUsers имеет доступ к базе данных Sales.

    • CompanyDomain\SqlUser1 является членом SQLUsers и поэтому имеет открытый доступ к базе данных Sales.

    Хотя CompanyDomain\SqlUser1 имеет доступ к базе данных через членство в группе SQLUsers, инструкция EXECUTE @string\_variable AS USER = 'CompanyDomain\SqlUser1' завершится ошибкой, так как CompanyDomain\SqlUser1 не существует в качестве участника в базе данных.

    Рекомендации

    Указывайте имя входа или пользователя, имеющего минимальные права на операции, выполняемые в инструкции или модуле. Например: не следует указывать имя входа, которое обладает разрешениями уровня сервера, если необходимы только разрешения уровня базы данных. Учетную запись владельца базы данных следует указывать только тогда, когда разрешения, которыми он обладает, действительно необходимы.

    Разрешения

    На выполнение инструкции EXECUTE разрешения не требуются. Однако необходимы разрешения на защищаемые объекты, на которые ссылается командная строка в инструкции EXECUTE. Например, если строка содержит инструкцию INSERT, вызывающий инструкцию EXECUTE пользователь должен иметь разрешение INSERT на целевую таблицу. Разрешения проверяются в месте нахождения инструкции EXECUTE, даже если она содержится внутри модуля.

    Разрешение EXECUTE на модуль по умолчанию имеет владелец модуля, который может передать его другим пользователям. При запуске модуля, выполняющего командную строку, разрешения проверяются в контексте того пользователя, который выполняет модуль, а не того, который его создал. Но в случае, если владельцем вызывающего и вызываемого модуля является один и тот же пользователь, проверка разрешений EXECUTE для второго модуля не выполняется.

    Если модуль производит доступ к другому объекту базы данных, то выполнение завершится успешно при наличии разрешения EXECUTE на модуль и при выполнении одного из следующих условий.

    • Модуль помечен как EXECUTE AS USER или SELF, и владелец модуля обладает соответствующими разрешениями на данный объект. Дополнительные сведения об олицетворении в модуле см. в документации по пакету EXECUTE AS, предложение (Transact-SQL).

    • Модуль помечен как EXECUTE AS CALLER, и есть соответствующие разрешения на данный объект.

    • Модуль помечен как EXECUTE AS user_name, и user_name имеет соответствующие разрешения на объект.

    Разрешения для переключения контекста

    Чтобы указать в предложении EXECUTE AS имя входа, вызывающая сторона должна иметь разрешения IMPERSONATE на указанное имя входа. Чтобы указать в предложении EXECUTE AS пользователя базы данных, вызывающая сторона должна иметь разрешения IMPERSONATE на указанное имя входа. Если контекст выполнения не указан или указано EXECUTE AS CALLER, никакие разрешения IMPERSONATE не требуются.

    Примеры

    А.Вызов EXECUTE с передачей единственного аргумента

    Хранимая процедура uspGetEmployeeManagers в базе данных AdventureWorks2012 ожидает один параметр (@EmployeeID). В следующем примере производится выполнение хранимой процедуры uspGetEmployeeManagers со значением 6 аргумента Employee ID 6.

    EXEC dbo.uspGetEmployeeManagers 6;
GO

    При выполнении переменная может быть явно поименована.

    EXEC dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

    Если приведенная инструкция является первой в пакете или скрипте osql или sqlcmd, то указывать EXEC не требуется.

    dbo.uspGetEmployeeManagers 6;
GO
--Or
dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

    Б.Передача нескольких аргументов

    В следующем примере выполняется хранимая процедура spGetWhereUsedProductID в базе данных AdventureWorks2012. которой передаются два аргумента: код продукта 819 и дата проверки @CheckDate, имеющая значение типа datetime.

    DECLARE @CheckDate datetime;
SET @CheckDate = GETDATE();
EXEC dbo.uspGetWhereUsedProductID 819, @CheckDate;
GO

    В.Использование EXECUTE tsql_string с переменной

    Следующий пример показывает, как инструкция EXECUTE обрабатывает динамически построенные строки, содержащие переменные. В примере производится создание курсора tables_cursor, в который помещается список всех пользовательских таблиц в базе данных AdventureWorks2012 , а затем на основе этого списка перестраиваются индексы всех таблиц.

    DECLARE tables_cursor CURSOR
   FOR
   SELECT s.name, t.name 
   FROM sys.objects AS t
   JOIN sys.schemas AS s ON s.schema_id = t.schema_id
   WHERE t.type = 'U';
OPEN tables_cursor;
DECLARE @schemaname sysname;
DECLARE @tablename sysname;
FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
WHILE (@@FETCH_STATUS <> -1)
BEGIN;
   EXECUTE ('ALTER INDEX ALL ON ' + @schemaname + '.' + @tablename + ' REBUILD;');
   FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
END;
PRINT 'The indexes on all tables have been rebuilt.';
CLOSE tables_cursor;
DEALLOCATE tables_cursor;
GO

    Г.Использование EXECUTE с удаленной хранимой процедурой

    В следующем примере производится выполнение хранимой процедуры uspGetEmployeeManagers на удаленном сервере SQLSERVER1 и сохранение возвращенного состояния выполнения в переменной @retstat.

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    		 
    DECLARE @retstat int;
EXECUTE @retstat = SQLSERVER1.AdventureWorks2012.dbo.uspGetEmployeeManagers @BusinessEntityID = 6;

    Д.Использование в инструкции EXECUTE переменной хранимой процедуры

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

    DECLARE @proc_name varchar(30);
SET @proc_name = 'sys.sp_who';
EXEC @proc_name;

    Е.Указание в инструкции EXECUTE ключевого слова DEFAULT

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

    IF OBJECT_ID(N'dbo.ProcTestDefaults', N'P')IS NOT NULL
   DROP PROCEDURE dbo.ProcTestDefaults;
GO
-- Create the stored procedure.
CREATE PROCEDURE dbo.ProcTestDefaults (
@p1 smallint = 42, 
@p2 char(1), 
@p3 varchar(8) = 'CAR')
AS 
   SET NOCOUNT ON;
   SELECT @p1, @p2, @p3
;
GO

    Хранимая процедура Proc_Test_Defaultsможет быть выполнена во множестве разных сочетаний.

    -- Specifying a value only for one parameter (@p2).
EXECUTE dbo.ProcTestDefaults @p2 = 'A';
-- Specifying a value for the first two parameters.
EXECUTE dbo.ProcTestDefaults 68, 'B';
-- Specifying a value for all three parameters.
EXECUTE dbo.ProcTestDefaults 68, 'C', 'House';
-- Using the DEFAULT keyword for the first parameter.
EXECUTE dbo.ProcTestDefaults @p1 = DEFAULT, @p2 = 'D';
-- Specifying the parameters in an order different from the order defined in the procedure.
EXECUTE dbo.ProcTestDefaults DEFAULT, @p3 = 'Local', @p2 = 'E';
-- Using the DEFAULT keyword for the first and third parameters.
EXECUTE dbo.ProcTestDefaults DEFAULT, 'H', DEFAULT;
EXECUTE dbo.ProcTestDefaults DEFAULT, 'I', @p3 = DEFAULT;

    Ж.Указание AT имя_связанного_сервера в инструкции EXECUTE

    В следующем примере командная строка передается удаленному серверу. Создается связанный сервер SeattleSales, который указывает на другой экземпляр SQL Server, а затем на нем выполняется инструкция DDL (CREATE TABLE).

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    		 
    EXEC sp_addlinkedserver 'SeattleSales', 'SQL Server'
GO
EXECUTE ( 'CREATE TABLE AdventureWorks2012.dbo.SalesTbl 
(SalesID int, SalesName varchar(10)) ; ' ) AT SeattleSales;
GO

    З.Использование инструкции EXECUTE с аргументом WITH RECOMPILE

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

    EXECUTE dbo.Proc_Test_Defaults @p2 = 'A' WITH RECOMPILE;
GO

    И.Выполнение определяемой пользователем функции с помощью инструкции EXECUTE

    В следующем примере выполняется скалярная, определяемая пользователем функция ufnGetSalesOrderStatusText в базе данных AdventureWorks2012. Возвращенное значение сохраняется в переменной @returnstatus. Функции передается один входной аргумент @Status, который имеет тип данных tinyint.

    DECLARE @returnstatus nvarchar(15);
SET @returnstatus = NULL;
EXEC @returnstatus = dbo.ufnGetSalesOrderStatusText @Status = 2;
PRINT @returnstatus;
GO

    К.Применение инструкции EXECUTE для запроса к базе данных Oracle на связанном сервере

    Следующий пример демонстрирует выполнение нескольких инструкций SELECT на удаленном сервере Oracle. Пример начинается с добавления сервера Oracle в качестве связанного и создания имени входа на этом сервере.

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    		 
    -- Setup the linked server.
EXEC sp_addlinkedserver  
        @server='ORACLE',
        @srvproduct='Oracle',
        @provider='OraOLEDB.Oracle', 
        @datasrc='ORACLE10';

EXEC sp_addlinkedsrvlogin 
    @rmtsrvname='ORACLE',
    @useself='false', 
    @locallogin=null, 
    @rmtuser='scott', 
    @rmtpassword='tiger';
 
EXEC sp_serveroption 'ORACLE', 'rpc out', true;
GO
 
-- Execute several statements on the linked Oracle server.
EXEC ( 'SELECT * FROM scott.emp') AT ORACLE;
GO
EXEC ( 'SELECT * FROM scott.emp WHERE MGR = ?', 7902) AT ORACLE;
GO
DECLARE @v INT; 
SET @v = 7902;
EXEC ( 'SELECT * FROM scott.emp WHERE MGR = ?', @v) AT ORACLE;
GO

    Л.Переключение контекста на другого пользователя с помощью инструкции EXECUTE AS USER

    В следующем примере выполняется командная строка Transact-SQL, которая создает таблицу и указывает предложение AS USER для переключения контекста выполнения инструкции с вызывающего на пользователя User1. При запуске инструкции компонент Компонент Database Engine проверит разрешения пользователя User1. Пользователь User1 должен присутствовать в базе данных как пользователь и должен иметь разрешения на создание таблиц в схеме Sales; в противном случае инструкция завершается ошибкой.

    EXECUTE ('CREATE TABLE Sales.SalesTable (SalesID int, SalesName varchar(10));')
AS USER = 'User1';
GO

    М.Использование параметра с командами AT имя_связанного_сервера и EXECUTE

    В следующем примере командная строка передается удаленному серверу со знаком вопроса (?) в качестве заполнителя для параметра. Пример создает связанный сервер SeattleSales, который указывает на другой экземпляр SQL Server, а затем выполняется инструкция SELECT по отношению к этому связанному серверу. Инструкция SELECT использует знак вопроса в качестве заполнителя для параметра ProductID (952), предоставляемого после инструкции.

    Применимо для следующих объектов: С SQL Server 2008 по SQL Server 2014 включительно.

    		 
    -- Setup the linked server.
EXEC sp_addlinkedserver 'SeattleSales', 'SQL Server'
GO
-- Execute the SELECT statement.
EXECUTE ('SELECT ProductID, Name 
    FROM AdventureWorks2012.Production.Product
    WHERE ProductID = ? ', 952) AT SeattleSales;
GO

    Н.Использование инструкции EXECUTE для переопределения одного результирующего набора

    В некоторых из предыдущих примеров выполнялась инструкция EXEC dbo.uspGetEmployeeManagers 6;, которая возвращала 7 столбцов. Следующий пример показывает использование синтаксиса WITH RESULT SET для изменения имени и типов данных возвращаемого результирующего набора.

    Применимо для следующих объектов: От SQL Server 2012 до SQL Server 2014, База данных SQL Windows Azure.

    		 
    EXEC uspGetEmployeeManagers 16
WITH RESULT SETS
( 
   ([Reporting Level] int NOT NULL,
    [ID of Employee] int NOT NULL,
    [Employee First Name] nvarchar(50) NOT NULL,
    [Employee Last Name] nvarchar(50) NOT NULL,
    [Employee ID of Manager] nvarchar(max) NOT NULL,
    [Manager First Name] nvarchar(50) NOT NULL,
    [Manager Last Name] nvarchar(50) NOT NULL )
);

    О.Использование инструкции EXECUTE для переопределения двух результирующих наборов

    При выполнении инструкции, возвращающей более одного результирующего набора, необходимо определить каждый из ожидаемых результирующих наборов. В следующем примере в AdventureWorks2012 создается процедура, которая возвращает два результирующих набора. Затем процедура выполняется с предложением WITH RESULT SETS и указывается два определения результирующих наборов.

    Применимо для следующих объектов: От SQL Server 2012 до SQL Server 2014, База данных SQL Windows Azure.

    		 
    --Create the procedure
CREATE PROC Production.ProductList @ProdName nvarchar(50)
AS
-- First result set
SELECT ProductID, Name, ListPrice
    FROM Production.Product
    WHERE Name LIKE @ProdName;
-- Second result set 
SELECT Name, COUNT(S.ProductID) AS NumberOfOrders
    FROM Production.Product AS P
    JOIN Sales.SalesOrderDetail AS S
        ON P.ProductID  = S.ProductID 
    WHERE Name LIKE @ProdName
    GROUP BY Name;
GO

-- Execute the procedure 
EXEC Production.ProductList '%tire%'
WITH RESULT SETS 
(
    (ProductID int,   -- first result set definition starts here
    Name Name,
    ListPrice money)
    ,                 -- comma separates result set definitions
    (Name Name,       -- second result set definition starts here
    NumberOfOrders int)
);

    См. также

    Справочник

    @@NESTLEVEL (Transact-SQL)

    DECLARE @local\_variable (Transact-SQL)

    EXECUTE AS, предложение (Transact-SQL)

    Программа osql

    REVERT (Transact-SQL)

    sp_addlinkedserver (Transact-SQL)

    Программа sqlcmd

    SUSER_NAME (Transact-SQL)

    sys.database_principals (Transact-SQL)

    sys.server_principals (Transact-SQL)

    USER_NAME (Transact-SQL)

    OPENDATASOURCE (Transact-SQL)

    Основные понятия

    Участники (компонент Database Engine)