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

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

ArgomentiArguments

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

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

Per i parametri seguenti impostare object_type su 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.

    object_type è di tipo smallint.The object_type is smallint.

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

    [ @parameter_value = ] parameter_value[ @parameter_value = ] parameter_value
    Valore del parametro.The value of the parameter. parameter_value è di tipo 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 registrate durante un'esecuzione del pacchetto, impostare parameter_name su LOGGING_LEVEL e parameter_value su 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 parametro object_type 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 PrestazioniPerformance

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

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 altre informazioni, vedere Messaggi personalizzati per la registrazione.For more information, see Custom Messages for Logging
44 Derivazione di runtimeRuntime lineage

Raccoglie i dati necessari a tenere traccia della 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 altre 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 altre informazioni sui livelli di registrazione personalizzati, vedere Abilitare la registrazione per l'esecuzione di pacchetti nel server SSIS.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
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
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
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

PermissionsPermissions

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

  • Appartenenza al ruolo del database ssis_adminMembership to the ssis_admin database role

  • Appartenenza al ruolo del server sysadminMembership 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 dei pacchettiGenerating Dump Files for Package Execution