catalog.set_execution_parameter_value (database SSISDB)catalog.set_execution_parameter_value (SSISDB Database)

QUESTO ARGOMENTO SI APPLICA A: sìSQL Server (a partire dalla versione 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Imposta il valore di un parametro per un'istanza di esecuzione nel catalogo di Integration ServicesIntegration Services.Sets the value of a parameter for an instance of execution in the Integration ServicesIntegration Services catalog.

Non è possibile modificare un valore di parametro in seguito all'avvio di un'istanza di esecuzione.A parameter value cannot be changed after an instance of execution has started.

SintassiSyntax

set_execution_parameter_value [ @execution_id = execution_id  
    , [ @object_type = ] object_type  
    , [ @parameter_name = ] parameter_name  
    , [ @parameter_value = ] parameter_value  

ArgomentiArguments

[ @execution_id =] valore di execution_id[ @execution_id = ] execution_id
Identificatore univoco per l'istanza di esecuzione.The unique identifier for the instance of execution. Il valore di execution_id è bigint.The execution_id is bigint.

[ @object_type =] object_type[ @object_type = ] object_type
Tipo di parametro.The type of parameter.

Per i seguenti parametri impostare object_type a 50For the following parameters, set object_type to 50

  • LOGGING_LEVELLOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVELCUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERRORDUMP_ON_ERROR

  • DUMP_ON_EVENTDUMP_ON_EVENT

  • DUMP_EVENT_CODEDUMP_EVENT_CODE

  • CALLER_INFOCALLER_INFO

  • SYNCHRONIZEDSYNCHRONIZED

    Utilizzare il valore 20 per indicare un parametro del progetto o il valore 30 per indicare un parametro del pacchetto.Use the value 20 to indicate a project parameter or the value 30 to indicate a package parameter.

    Il object_type è smallint.The object_type is smallint.

    [ @parameter_name =] parameter_name[ @parameter_name = ] parameter_name
    Nome del parametro.The name of the parameter. Il parameter_name è nvarchar (128).The parameter_name is nvarchar(128).

    [ @parameter_value =] parameter_value[ @parameter_value = ] parameter_value
    Valore del parametro.The value of the parameter. Il parameter_value è sql_variant.The parameter_value is sql_variant.

OsservazioniRemarks

Per individuare i valori dei parametri utilizzati per una determinata esecuzione, eseguire una query sulla vista catalog.execution_parameter_values.To find out the parameter values that were used for a given execution, query the catalog.execution_parameter_values view.

Per specificare l'ambito delle informazioni che viene registrate durante l'esecuzione di un pacchetto, impostare parameter_name su LOGGING_LEVEL e parameter_value a uno dei valori seguenti.To specify the scope of information that is logged during a package execution, set parameter_name to LOGGING_LEVEL and set parameter_value to one of the following values.

Impostare il object_type parametro su 50.Set the object_type parameter to 50.

ValoreValue DescrizioneDescription
00 NessunoNone

La registrazione è disabilitata.Logging is turned off. Solo lo stato dell'esecuzione del pacchetto viene registrato.Only the package execution status is logged.
11 BasicBasic

Tutti gli eventi sono registrati, ad eccezione di eventi personalizzati e di diagnostica.All events are logged, except custom and diagnostic events. Si tratta del valore predefinito.This is the default value.
22 restazioniPerformance

Vengono registrati solo le statistiche sulle prestazioni e gli eventi OnError e OnWarning.Only performance statistics, and OnError and OnWarning events, are logged.
33 DettagliatoVerbose

Tutti gli eventi vengono registrati, inclusi gli eventi personalizzati e di diagnostica.All events are logged, including custom and diagnostic events.
Gli eventi personalizzati includono gli eventi registrati dalle attività di Integration Services.Custom events include those events that are logged by Integration Services tasks. Per ulteriori informazioni, vedere Custom Messages for LoggingFor more information, see Custom Messages for Logging
44 Derivazione di runtimeRuntime lineage

Raccoglie i dati necessari per tenere traccia di derivazione nel flusso di dati.Collects the data required to track lineage in the data flow.
100100 Livello di registrazione personalizzatoCustom logging level

Specificare le impostazioni nel parametro CUSTOMIZED_LOGGING_LEVEL.Specify the settings in the CUSTOMIZED_LOGGING_LEVEL parameter. Per ulteriori informazioni sui valori che è possibile specificare, vedere catalog.create_customized_logging_level.For more info about the values that you can specify, see catalog.create_customized_logging_level.

Per ulteriori informazioni sui livelli di registrazione personalizzati, vedere Enable Logging for Package Execution on the SSIS Server.For more info about customized logging levels, see Enable Logging for Package Execution on the SSIS Server.

Per specificare che il server di Integration Services generi file di dump quando si verifica qualsiasi errore durante un'esecuzione del pacchetto, impostare i valori dei parametri seguenti per un'istanza di esecuzione che non è stata eseguita.To specify that the Integration Services server generates dump files when any error occurs during a package execution, set the following parameter values for an execution instance that hasn’t run.

ParametroParameter ValoreValue
valore di execution_idexecution_id Identificatore univoco per l'istanza di esecuzioneThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name ‘DUMP_ON_ERROR‘DUMP_ON_ERROR
parameter_valueparameter_value 11

Per specificare che il server di Integration Services generi file di dump quando si verificano eventi durante un'esecuzione del pacchetto, impostare i valori dei parametri seguenti per un'istanza di esecuzione che non è stata eseguita.To specify that the Integration Services server generates dump files when events occur during a package execution, set the following parameter values for an execution instance that hasn’t run.

ParametroParameter ValoreValue
valore di execution_idexecution_id Identificatore univoco per l'istanza di esecuzioneThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name ‘DUMP_ON_EVENT‘DUMP_ON_EVENT
parameter_valueparameter_value 11

Per specificare gli eventi durante l'esecuzione del pacchetto che inducono il server di Integration Services a generare file di dump, impostare i valori dei parametri seguenti per un'istanza di esecuzione che non è stata eseguita.To specify the events during package execution that cause the Integration Services server to generate dump files, set the following parameter values for an execution instance that hasn’t run. Separare più codici evento utilizzando un punto e virgola.Separate multiple event codes using a semi-colon.

ParametroParameter ValoreValue
valore di execution_idexecution_id Identificatore univoco per l'istanza di esecuzioneThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name DUMP_EVENT_CODEDUMP_EVENT_CODE
parameter_valueparameter_value Uno o più codici eventoOne or more event codes

EsempioExample

Nell'esempio seguente viene specificato che il server di Integration Services genera file di dump quando si verificano errori durante un'esecuzione del pacchetto.The following example specifies that the Integration Services server generates dump files when any error occurs during a package execution.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1  

EsempioExample

Nell'esempio seguente si specifica che il server di Integration Services genera file di dump quando si verificano eventi durante un'esecuzione del pacchetto e si specifica l'evento che induce il server a generare i file.The following example specifies that the Integration Services server generates dump files when events occur during a package execution, and specifies the event that causes the server to generate the files.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1  

declare @event_code nvarchar(50)  
set @event_code = '0xC020801C'  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code  

Valore del codice restituitoReturn Code Value

0 (esito positivo)0 (success)

Set di risultatiResult Sets

NessunoNone

AutorizzazioniPermissions

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:This stored procedure requires one of the following permissions:

  • Autorizzazioni READ e MODIFY per l'istanza di esecuzioneREAD and MODIFY permissions on the instance of execution

  • L'appartenenza al ssis_admin ruolo del databaseMembership to the ssis_admin database role

  • L'appartenenza al sysadmin ruolo del serverMembership to the sysadmin server role

Errori e avvisiErrors and Warnings

Nell'elenco seguente vengono descritte alcune condizioni che possono generare un errore o un avviso:The following list describes some conditions that may raise an error or warning:

  • Utente senza autorizzazioni appropriate.The user does not have the appropriate permissions

  • Identificatore di esecuzione non validoThe execution identifier is not valid

  • Nome del parametro non validoThe parameter name is not valid

  • Tipo di dati del valore del parametro non corrispondente al tipo di dati del parametro.The data type of the parameter value does not match the data type of the parameter

Vedere ancheSee Also

Catalog. execution_parameter_values ( Database SSISDB ) catalog.execution_parameter_values (SSISDB Database)
Generazione di file di dump per l'esecuzione del pacchettoGenerating Dump Files for Package Execution