sp_prepare (Transact SQL)

  • Статья

Подготавливает параметризованную инструкцию Transact-SQL и возвращает дескриптор инструкции для выполнения. Процедура sp_prepare вызывается указанием ID = 11 в пакете потока табличных данных (TDS).

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

Синтаксис

sp_prepare handle OUTPUT, params, stmt, options

Аргументы

  • handle
    Идентификатор подготовленного дескриптора, сформированный SQL Server. Параметр handle является обязательным и имеет возвращаемое значение типа int.

  • params
    Указывает параметризованные инструкции. Определение переменных params подставляется вместо маркеров параметров в инструкции. Параметр params является обязательным и требует входного значения типа ntext, nchar или nvarchar . Если инструкция не параметризована, необходимо ввести значение NULL.

  • stmt
    Определяет результирующий набор курсора. Параметр stmt обязателен и требует входного значения типа ntext, nchar или nvarchar.

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

    Значение

    Описание

    0x0001

    RETURN_METADATA

Примеры

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

Declare @P1 int;
Exec sp_prepare @P1 output, 
    N'@P1 nvarchar(128), @P2 nvarchar(100)',
    N'SELECT database_id, name FROM sys.databases WHERE name=@P1 AND state_desc = @P2';
Exec sp_execute @P1, N'tempdb', N'ONLINE';
EXEC sp_unprepare @P1;

См. также

Справочник

Системные хранимые процедуры (Transact-SQL)