catalog.set_object_parameter_value (database SSISDB)
Viene impostato il valore di un parametro nel catalogo di Integration Services. Viene associato il valore a una variabile di ambiente o viene assegnato un valore letterale che sarà utilizzato per impostazione predefinita nel caso non venga assegnato nessun altro valore.
Sintassi
set_object_parameter_value [ @object_type = ] object_type
, [ @folder_name = ] folder_name
, [ @project_name = ] project_name
, [ @parameter_name = ] parameter _name
, [ @parameter_value = ] parameter_value
[ , [ @object_name = ] object_name ]
[ , [ @value_type = ] value_type ]
Argomenti
[ @object\_type = ] object_type
Tipo di parametro. Utilizzare il valore 20 per indicare un parametro del progetto o il valore 30 per indicare un parametro del pacchetto. object_type è di tipo smallInt.[ @folder\_name = ] folder_name
Nome della cartella in cui è contenuto il parametro. folder_name è di tipo nvarchar(128).[ @project\_name = ] project_name
Nome del progetto in cui è contenuto il parametro. project_name è di tipo nvarchar(128).[ @parameter\_name = ] parameter_name
Nome del parametro. parameter_name è di tipo nvarchar(128).[ @parameter\_value = ] parameter_value
Valore del parametro. parameter_value è di tipo sql_variant.[ @object\_name = ] object_name
Nome del pacchetto. Questo argomento è necessario quando il parametro è un parametro del pacchetto. object_name è di tipo nvarchar(260).[ @value\_type = ] value_type
Tipo di valore del parametro. Utilizzare il carattere V per indicare che parameter_value è un valore letterale che sarà utilizzato per impostazione predefinita nel caso non venga assegnato nessun altro valore prima dell'esecuzione. Utilizzare il carattere R per indicare che parameter_value è un valore di riferimento ed è stato impostato sul nome di una variabile di ambiente. Questo argomento è facoltativo. Per impostazione predefinita, viene utilizzato il carattere V. value_type è di tipo char(1).
Valore del codice restituito
0 (esito positivo)
Set di risultati
Nessuno
Autorizzazioni
Per questa stored procedure è necessaria una delle autorizzazioni seguenti:
Autorizzazioni READ e MODIFY sul progetto
Appartenenza al ruolo del database ssis_admin
Appartenenza al ruolo server sysadmin
Errori e avvisi
Nell'elenco seguente vengono descritte alcune condizioni che possono determinare la generazione di un errore da parte della stored procedure:
Tipo di parametro non valido
Nome del progetto non valido
Per parametri del pacchetto, nome del pacchetto non valido
Tipo di valore non valido
Utente senza autorizzazioni appropriate.
Osservazioni
Se non viene specificato alcun parametro value_type, per impostazione predefinita verrà utilizzato un valore letterale di parameter_value. Quando viene utilizzato un valore letterale, il parametro value_set nella vista object_parameters viene impostato su 1. Un valore di parametro NULL non è consentito.
Se nel parametro value_type è contenuto il carattere R, che indica un valore a cui si fa riferimento, parameter_value fa riferimento al nome di una variabile di ambiente.
Il valore 20 può essere utilizzato per il parametro object_type per indicare un parametro del progetto. In questo caso, un valore di object_name non è necessario e qualsiasi valore specificato per object_name verrà ignorato. Questo valore viene utilizzato quando l'utente desidera impostare un parametro del progetto.
Il valore 30 può essere utilizzato per il parametro object_type per indicare un parametro del pacchetto. In questo caso, un valore di object_name viene utilizzato per indicare il pacchetto corrispondente. Se non è specificato object_name, verrà restituito un errore dalla stored procedure e quest'ultima verrà terminata.