sp_prepare (Transact SQL)

Prepara un'istruzione Transact-SQL con parametri e restituisce un handle dell'istruzione per l'esecuzione. È possibile richiamare sp_prepare specificando ID = 11 in un pacchetto del flusso TDS.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_prepare handle OUTPUT, params, stmt, options

Argomenti

• handle
  Identificatore dell'handle preparato generato da SQL Server. handle è un parametro obbligatorio con un valore restituito int.

• params
  Identifica le istruzioni con parametri. La definizione del parametro params delle variabili viene sostituita per i marcatori di parametro nell'istruzione. params è un parametro obbligatorio che richiede un valore di input ntext, nchar o nvarchar . Immettere un valore NULL se l'istruzione non è con parametri.

• stmt
  Definisce il set di risultati del cursore. Il parametro stmt è obbligatorio e richiede un valore di input ntext, nchar oppure nvarchar.

• options
  Parametro facoltativo tramite cui viene restituita una descrizione delle colonne dei set di risultati del cursore. Per options è necessario il valore di input int seguente.

  Valore	Descrizione
  0x0001	RETURN_METADATA

Esempi

Nell'esempio seguente si prepara e si esegue un'istruzione semplice.

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;

Vedere anche

Riferimento

Stored procedure di sistema (Transact-SQL)