sp_prepare (Transact-SQL)
Bereitet eine parametrisierte Transact-SQL-Anweisung vor und gibt ein Anweisungshandle zur Ausführung zurück. sp_prepare wird aufgerufen, indem ID = 11 in einem Tabular Data Stream-Paket (TDS) angegeben wird.
Transact-SQL-Syntaxkonventionen
Syntax
sp_prepare handle OUTPUT, params, stmt, options
Argumente
handle
Ein von SQL Server generierter, vorbereiteter Handlebezeichner handle ist ein erforderlicher Parameter mit einem int-Rückgabewert.params
Identifiziert parametrisierte Anweisungen. Die params -Definition der Variablen wird in der Anweisung an die Stelle der Parametermarkierungen gesetzt. params ist ein erforderlicher Parameter, der einen Eingabewert vom Typ ntext, nchar,oder nvarchar erfordert. Geben Sie einen NULL-Wert ein, wenn die Anweisung nicht parametrisiert ist.stmt
Definiert das Resultset des Cursors. Der stmt-Parameter ist erforderlich und erfordert einen der Eingabewerte ntext, nchar oder nvarchar.options
Ein optionaler Parameter, der eine Beschreibung der Spalten im Cursorresultset zurückgibt. options erfordert den folgenden int-Eingabewert.Wert
Beschreibung
0x0001
RETURN_METADATA
Beispiele
Im folgenden Beispiel wird eine einfache Anweisung vorbereitet und ausgeführt.
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;