sp_batch_params (Transact-SQL)
Restituisce un set di righe contenente informazioni sui parametri inclusi in un batch Transact-SQL. sp_batch_params analizza solo il batch specificato e restituisce le informazioni sui valori dei parametri incorporati e non esegue il batch, né modifica l'ambiente di esecuzione.
Sintassi
sp_batch_params [ [ @tsqlbatch = ] 'tsqlbatch' ]
Argomenti
- [ @tsqlbatch =] 'tsqlbatch'
Stringa Unicode che include un'istruzione Transact-SQL o un batch per i quali si desidera recuperare le informazioni sui parametri. tsqlbatch è di tipo nvarchar(max) o convertibile in modo implicito nel tipo nvarchar(max).
Valori restituiti
Nessuno
Set di risultati
Nome colonna |
Tipo di dati |
Descrizione |
---|---|---|
PARAMETER_NAME |
sysname |
Nome del parametro rilevato nel batch da SQL Server. |
COLUMN_TYPE |
smallint |
Questo campo restituisce sempre uno dei valori seguenti: 0 = SQL_PARAM_TYPE_UNKNOWN 1 = SQL_PARAM_TYPE_INPUT 2 = SQL_PARAM_TYPE_OUTPUT 3 = SQL_RESULT_COL 4 = SQL_PARAM_OUTPUT 5 = SQL_RETURN_VALUE In SQL Server 2005 e versioni successive questa colonna corrisponde sempre a 0. |
DATA_TYPE |
smallint |
Tipo di dati del parametro (codice integer per un tipo di dati ODBC). Se non è possibile effettuare il mapping di questo tipo di dati a un tipo ISO, il valore è NULL. Il nome del tipo di dati nativo viene restituito nella colonna TYPE_NAME. In SQL Server 2005 e versioni successive questo valore è NULL. |
TYPE_NAME |
sysname |
Rappresentazione in forma di stringa del tipo di dati visualizzato dal sistema DBMS sottostante. In SQL Server 2005 e versioni successive questo valore è NULL |
PRECISION |
int |
Numero di cifre significative. Il valore restituito per la colonna PRECISION è in base 10. |
LENGTH |
int |
Dimensioni di trasferimento dei dati. In SQL Server 2005 e versioni successive questo valore è NULL. |
SCALE |
smallint |
Numero di cifre a destra del separatore decimale. In SQL Server 2005 e versioni successive questo valore è NULL. |
RADIX |
smallint |
Base per i tipi di dati numerici. In SQL Server 2005 e versioni successive questo valore è NULL. |
NULLABLE |
smallint |
Specifica se i valori Null sono supportati o meno: 1 = Per il parametro è possibile creare il tipo di dati con supporto per valori Null. 0 = I valori Null non sono supportati. In SQL Server 2005 e versioni successive questo valore è NULL. |
SQL_DATA_TYPE |
smallint |
Valore del tipo di dati di sistema di SQL Server visualizzato nel campo TYPE del descrittore. Questa colonna corrisponde alla colonna DATA_TYPE, tranne per i tipi di dati datetime e interval ISO. In questa colonna viene sempre restituito un valore. In SQL Server 2005 e versioni successive questo valore è NULL. |
SQL_DATETIME_SUB |
smallint |
Sottocodice datetime o interval ISO se il valore di SQL_DATA_TYPE è SQL_DATETIME o SQL_INTERVAL. Per i tipi di dati diversi da datetime e interval ISO, il valore di questa colonna è NULL. In SQL Server 2005 e versioni successive questo valore è NULL. |
CHAR_OCTET_LENGTH |
int |
Lunghezza massima in byte di un parametro di tipo character o binary. Per gli tutti gli altri tipi di dati, il valore di questa colonna è NULL. In SQL Server 2005 e versioni successive questo valore è sempre NULL. |
ORDINAL_POSITION |
int |
Posizione ordinale del parametro nel batch. Se il nome del parametro viene ripetuto più volte, questa colonna include il numero ordinale della prima occorrenza. Il primo parametro è associato al numero ordinale 1. Questa colonna restituisce sempre un valore. |
Autorizzazioni
L'autorizzazione per l'esecuzione di sp_batch_params viene concessa al ruolo public.
Esempi
Nell'esempio seguente una query viene passata a sp_batch_params. Il set di risultati enumera l'elenco dei valori dei parametri incorporati.
DECLARE @SQLString nvarchar(500);
/* Build the SQL string */
SET @SQLString =
N'SELECT * FROM AdventureWorks.HumanResources.Employee
WHERE ManagerID = @ManagerID';
EXECUTE sp_batch_params @SQLString
Vedere anche