catalog.set_execution_parameter_value (database SSISDB)

Articolo
05/23/2023

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