catalog.set_execution_parameter_value (database SSISDB)

  • Articolo

Imposta il valore di un parametro per un'istanza di esecuzione nel catalogo di Integration Services.

Non è possibile modificare un valore di parametro in seguito all'avvio di un'istanza di esecuzione.

Sintassi

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

Argomenti

  • [ @execution\_id = ] execution_id
    Identificatore univoco per l'istanza di esecuzione. execution_id è di tipo bigint.

  • [ @object\_type = ] object_type
    Tipo di parametro.

    Per i seguenti parametri impostare object_type su 50

    • LOGGING_LEVEL

    • DUMP_ON_ERROR

    • DUMP_ON_EVENT

    • DUMP_EVENT_CODE

    • CALLER_INFO

    • SYNCHRONIZED

    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.

  • [ @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.

Osservazioni

Per individuare i valori dei parametri utilizzati per una determinata esecuzione, eseguire una query sulla vista catalog.execution_parameter_values.

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.

Impostare il parametro object_type su 50.

Valore

Descrizione

0

Nessuno

La registrazione è disabilitata. Solo lo stato dell'esecuzione del pacchetto viene registrato.

1

Di base

Tutti gli eventi sono registrati, ad eccezione di eventi personalizzati e di diagnostica. Valore predefinito.

2

Prestazioni

Vengono registrati solo le statistiche sulle prestazioni e gli eventi OnError e OnWarning.

3

Dettagliato

Tutti gli eventi vengono registrati, inclusi gli eventi personalizzati e di diagnostica.
Gli eventi personalizzati includono gli eventi registrati dalle attività di Integration Services. Per ulteriori informazioni, vedere Messaggi personalizzati per la registrazione

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.

Parametro

Valore

execution_id

Identificatore univoco per l'istanza di esecuzione

object_type

50

parameter_name

‘DUMP_ON_ERROR

parameter_value

1

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.

Parametro

Valore

execution_id

Identificatore univoco per l'istanza di esecuzione

object_type

50

parameter_name

‘DUMP_ON_EVENT

parameter_value

1

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. Separare più codici evento utilizzando un punto e virgola.

Parametro

Valore

execution_id

Identificatore univoco per l'istanza di esecuzione

object_type

50

parameter_name

DUMP_EVENT_CODE

parameter_value

Uno o più codici evento

Esempio

Nell'esempio seguente viene specificato che il server di Integration Services genera file di dump quando si verificano errori durante un'esecuzione del pacchetto.

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

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.

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 codice restituito

0 (esito positivo)

Set di risultati

Nessuno

Autorizzazioni

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:

  • Autorizzazioni READ e MODIFY per l'istanza di esecuzione

  • Appartenenza al ruolo del database ssis_admin

  • Appartenenza al ruolo server sysadmin

Errori e avvisi

Nell'elenco seguente vengono descritte alcune condizioni che possono generare un errore o un avviso:

  • Utente senza autorizzazioni appropriate

  • Identificatore di esecuzione non valido

  • Nome del parametro non valido

  • Tipo di dati del valore del parametro non corrispondente al tipo di dati del parametro.

Vedere anche

Riferimento

catalog.execution_parameter_values (database SSISDB)

Concetti

Generazione di file di dump per l'esecuzione del pacchetto