Condividi tramite

catalog.set_execution_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 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

catalog.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 parametri seguenti impostare object_type su 50

  • LOGGING_LEVEL

  • CUSTOMIZED_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.

Commenti

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 Basic

Tutti gli eventi sono registrati, ad eccezione di eventi personalizzati e di diagnostica. Si tratta del 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 altre informazioni, vedere Messaggi personalizzati per la registrazione.
4 Derivazione di runtime

Raccoglie i dati necessari a tenere traccia della derivazione nel flusso di dati.
100 Livello di registrazione personalizzato

Specificare le impostazioni nel parametro CUSTOMIZED_LOGGING_LEVEL. Per altre informazioni sui valori che è possibile specificare, vedere 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.

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

Esempi

R. Generare file di dump per gli errori

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

B. Generare file di dump per gli eventi

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 del 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 del 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

catalog.execution_parameter_values (database SSISDB)
Generazione di file di dump per l'esecuzione dei pacchetti