catalog.set_object_parameter_value (database SSISDB)

  • Articolo

Si applica a:SQL Server Integration Runtime SSIS in Azure Data Factory

Si applica a:SQL Server

Imposta 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 viene usato per impostazione predefinita nel caso non siano assegnati altri valori.

Sintassi

catalog.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. Usare il carattere V per indicare che parameter_value è un valore letterale che viene usato per impostazione predefinita quando non viene assegnato nessun altro valore prima dell'esecuzione. Usare 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 del 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 value_type non viene specificato, per impostazione predefinita viene usato un valore letterale per parameter_value. Quando viene usato un valore letterale, il parametro value_set nella vista object_parameters viene impostato su 1. Un valore di parametro NULL non è consentito.

  • Se value_type contiene 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 usato per il parametro object_type per indicare un parametro del progetto. In questo caso, un valore per 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 usato per il parametro object_type per indicare un parametro del pacchetto. In questo caso, un valore di object_name viene usato per indicare il pacchetto corrispondente. Se object_name non è specificato, la stored procedure restituisce un errore e viene terminata.