Registrazione di Integration Services (SSIS)

In SQL Server Integration Services sono disponibili provider di log che è possibile utilizzare per implementare la registrazione in pacchetti, contenitori e attività. Tramite la registrazione è possibile acquisire informazioni di run-time su un pacchetto, che consentono di controllare e risolvere i problemi del pacchetto ogni volta che viene eseguito. Nel log è ad esempio possibile acquisire il nome dell'operatore che ha eseguito il pacchetto, nonché la data e l'ora di inizio e di fine dell'esecuzione.

È possibile configurare l'ambito di registrazione che si verifica durante l'esecuzione di un pacchetto nel server Integration Services. Per ulteriori informazioni, vedere Abilitare la registrazione per l'esecuzione di pacchetti nel server SSIS.

È inoltre possibile includere la registrazione quando si esegue un pacchetto tramite l'utilità del prompt dei comandi dtexec. Per ulteriori informazioni sugli argomenti del prompt dei comandi che supportano la registrazione, vedere Utilità dtexec.

Configurare la registrazione in SQL Server Data Tools

I log sono associati ai pacchetti e vengono configurati a livello del pacchetto. Ogni attività o contenitore di un pacchetto può registrare informazioni in qualsiasi log del pacchetto. Le attività e i contenitori di un pacchetto possono essere abilitati per la registrazione anche se per il pacchetto la registrazione non è stata attivata. È possibile, ad esempio, abilitare la registrazione in un'attività Esegui SQL senza abilitarla nel pacchetto padre. Un pacchetto, un contenitore o un'attività possono registrare voci in più log. È possibile scegliere di abilitare la registrazione solo sul pacchetto oppure su ogni singolo contenitore o attività presente nel pacchetto.

Quando si aggiunge un log a un pacchetto, è necessario scegliere il provider di log e il percorso del log. Il provider di log specifica il formato dei dati del log, ad esempio un database di SQL Server o un file di testo.

In Integration Services sono disponibili i provider di log seguenti:

  • Provider di log File di testo, che scrive le voci di log in file di testo ASCII in formato CSV. L'estensione predefinita dei file per questo provider è log.

  • Provider di log SQL Server Profiler, che scrive tracce che è possibile visualizzare utilizzando SQL Server Profiler. L'estensione predefinita dei file per questo provider è trc.

    [!NOTA]

    In un pacchetto in esecuzione in modalità a 64 bit non è possibile utilizzare il provider di log di SQL Server Profiler.

  • Provider di log SQL Server, che scrive le voci di log nella tabella sysssislog di un database di SQL Server.

  • Provider di log Registro eventi di Windows, che scrive le voci nel registro applicazioni del registro eventi di Windows sul computer locale.

  • Provider di log File XML, che scrive file di log in formato XML. L'estensione predefinita dei file per questo provider è xml.

Se si aggiunge un provider di log a un pacchetto o si configura la registrazione a livello di codice, sarà possibile utilizzare un ProgID o un ClassID per identificare il provider di log, anziché utilizzare i nomi visualizzati in Progettazione SSIS, nella finestra di dialogo Configura log SSIS.

Nella tabella seguente sono elencati i ProgID e i ClassID per i provider di log disponibili in Integration Services e i percorsi dei log in cui scrivono i provider.

Provider di log

ProgID

ClassID

Percorso

File di testo

DTS.LogProviderTextFile

{0A039101-ACC1-4E06-943F-279948323883}

La gestione connessione file utilizzata dal provider di log specifica il percorso del file di testo.

SQL Server Profiler

DTS.LogProviderSQLProfiler

{E93F6300-AE0C-4916-A7BF-A8D0CE12C77A}

La gestione connessione file utilizzata dal provider di log specifica il percorso del file utilizzato da SQL Server Profiler.

SQL Server

DTS.LogProviderSQLServer

{94150B25-6AEB-4C0D-996D-D37D1C4FDEDA}

La gestione connessione OLE DB utilizzata dal provider di log indica il database di SQL Server in cui si trova la tabella sysssislog con le voci di log.

Registro eventi di Windows

DTS.LogProviderEventLog

{071CC8EB-C343-4CFF-8D58-564B92FCA3CF}

Il registro applicazioni nel Visualizzatore eventi di Windows contiene le informazioni del log di Integration Services.

File XML

DTS.LogProviderXMLFile

{440945A4-2A22-4F19-B577-EAF5FDDC5F7A}

La gestione connessione file utilizzata dal provider di log specifica il percorso del file XML.

È inoltre possibile creare provider di log personalizzati. Per ulteriori informazioni, vedere Creazione di un provider di log personalizzato.

I provider di log di un pacchetto sono membri della raccolta dei provider di log del pacchetto. Se si crea un pacchetto e si implementa la registrazione tramite Progettazione SSIS, sarà possibile visualizzare l'elenco dei membri della raccolta nelle cartelle Provider di log della scheda Esplora pacchetti di Progettazione SSIS.

Per configurare un provider di log è necessario specificarne il nome, la descrizione e la gestione connessione utilizzata. Il provider di log SQL Server utilizza una gestione connessione OLE DB. I provider di log File di testo, SQL Server Profiler e File XML utilizzano gestioni connessioni file. Il provider di log Registro eventi di Windows non utilizza invece una gestione connessione, perché scrive direttamente nel Registro eventi di Windows. Per ulteriori informazioni, vedere Gestione connessione OLE DB e Gestione connessione file.

Personalizzazione della registrazione

Per la personalizzazione della registrazione di un evento o la creazione di un messaggio personalizzato, in Integration Services è disponibile uno schema di informazioni comunemente registrate, che è possibile includere nelle voci di log. Lo schema del log di Integration Services delinea le informazioni che è possibile registrare. È possibile selezionare elementi dallo schema per ogni voce di log.

Un pacchetto e le attività e i contenitori associati non devono necessariamente registrare le stesse informazioni. Inoltre le singole attività incluse in un pacchetto o contenitore possono registrare informazioni diverse. Ad esempio, un pacchetto potrebbe registrare informazioni relative agli operatori quando viene avviato, una delle attività potrebbe registrare la causa dell'esito negativo dell'attività e un'altra attività potrebbe registrare informazioni quando si verificano errori. Se un pacchetto e le attività e i contenitori associati utilizzano più log, in tutti i log vengono registrate le stesse informazioni.

È possibile selezionare il livello di registrazione più adatto alle proprie esigenze specificando gli eventi e le informazioni di ogni evento da registrare. A seconda delle specifiche esigenze le informazioni fornite da alcuni eventi potrebbero risultare più utili rispetto a quelle di altri eventi. Potrebbe risultare utile, ad esempio, registrare solo il nome del computer e dell'operatore dell'evento PreExecute, ma tutte le informazioni disponibili per l'evento Error.

Per impedire che i file di log utilizzino una quantità di spazio su disco elevata o per evitare un'attività di registrazione eccessiva che potrebbe influire negativamente sulle prestazioni, è possibile selezionare gli eventi e le informazioni da registrare. È possibile, ad esempio, configurare un log in modo che per ogni errore vengano registrati solo il nome del computer e la data.

Nella finestra di dialogo Configura log SSIS di Progettazione SSIS sono disponibili le opzioni di registrazione.

Schema del log

Nella tabella seguente vengono descritti gli elementi dello schema del log.

Elemento

Descrizione

Computer

Nome del computer in cui è stato generato l'evento.

Operator

Identifica l'utente che ha avviato il pacchetto.

SourceName

Nome del contenitore o dell'attività in cui è stato generato l'evento.

SourceID

Identificatore univoco del pacchetto, contenitore Ciclo For, Ciclo Foreach o Sequenza oppure attività in cui è stato generato l'evento.

ExecutionID

GUID dell'istanza di esecuzione del pacchetto.

[!NOTA]

L'esecuzione di un singolo pacchetto potrebbe creare voci di log con valori diversi per l'elemento ExecutionID. Ad esempio, quando si esegue un pacchetto in SQL Server Data Tools, la fase di convalida potrebbe creare voci di log con un elemento ExecutionID che corrisponde a SQL Server Data Tools. La fase di esecuzione potrebbe invece creare voci di log con un elemento ExecutionID che corrisponde a dtshost.exe. Per fornire un altro esempio, quando si esegue un pacchetto che contiene attività Esegui pacchetto, ognuna di queste attività esegue un pacchetto figlio. Questi pacchetti figlio potrebbero creare voci di log con un elemento ExecutionID diverso rispetto alle voci di log create dal pacchetto.

MessageText

Messaggio associato alla voce di log.

DataBytes

Matrice di byte specifica della voce di log. Il significato di questo campo varia a seconda della voce di log.

Nella tabella seguente sono descritti tre elementi aggiuntivi dello schema del log che non sono disponibili nella scheda Dettagli della finestra di dialogo Configura log SSIS.

Elemento

Descrizione

StartTime

Ora di inizio dell'esecuzione del contenitore o dell'attività.

EndTime

Ora di arresto dell'esecuzione del contenitore o dell'attività.

DataCode

Valore intero facoltativo che in genere contiene un valore dell'enumerazione DTSExecResult che indica il risultato dell'esecuzione del contenitore o dell'attività:

  • 0 - Esito positivo

  • 1 - Esito negativo

  • 2 - Esecuzione completata

  • 3 - Esecuzione annullata

Voci di log

Integration Services supporta voci di log per gli eventi predefiniti e offre voci di log personalizzate per molti oggetti di Integration Services. Tali eventi e voci di log personalizzate sono elencati nella finestra di dialogo Configura log SSIS di Progettazione SSIS.

Nella tabella seguente vengono descritti gli eventi predefiniti che è possibile abilitare per scrivere voci di log quando si verificano eventi di run-time. Queste voci sono relative ai file eseguibili, al pacchetto e alle attività e ai contenitori inclusi nel pacchetto. Il nome della voce di log corrisponde al nome dell'evento di run-time che è stato generato e che ha causato la scrittura della voce.

Eventi

Descrizione

OnError

Viene inserita una voce del registro quando si verifica un errore.

OnExecStatusChanged

Viene scritta una voce del registro quando un'attività (non un contenitore) viene sospesa o ripresa durante il debug.

OnInformation

Viene scritta una voce del registro durante la convalida e l'esecuzione di un eseguibile per la segnalazione di informazioni.

OnPostExecute

Viene registrata una voce di log non appena l'esecuzione del file eseguibile viene completata.

OnPostValidate

Viene registrata una voce di log dopo la convalida del file eseguibile.

OnPreExecute

Viene registrata una voce di log immediatamente prima dell'esecuzione del file eseguibile.

OnPreValidate

Viene registrata una voce di log all'avvio della convalida del file eseguibile.

OnProgress

Viene registrata una voce di log dopo un avanzamento percettibile dell'esecuzione del file eseguibile.

OnQueryCancel

Viene registrata una voce di log in qualsiasi momento dell'elaborazione dell'attività in cui è possibile annullare l'esecuzione.

OnTaskFailed

Viene registrata una voce di log quando un'attività ha esito negativo.

OnVariableValueChanged

Viene registrata una voce di log quando il valore di una variabile viene modificato.

OnWarning

Viene registrata una voce di log in corrispondenza di un avviso.

PipelineComponentTime

Per ogni componente del flusso di dati, viene registrata una voce di log per ogni fase di convalida ed esecuzione. La voce di log specifica il tempo di elaborazione per ogni fase.

Diagnostic

Viene registrata una voce di log che fornisce informazioni diagnostiche.

È ad esempio possibile registrare un messaggio prima e dopo ogni chiamata a un provider di dati esterno. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi agli strumenti per l'esecuzione del pacchetto.

Per il pacchetto e per molte attività sono disponibili voci di log personalizzate che è possibile abilitare per la registrazione. Per l'attività Invia messaggi è ad esempio disponibile la voce di log personalizzata SendMailTaskBegin, che registra informazioni quando l'attività viene avviata, ma prima che invii un messaggio di posta elettronica. Per ulteriori informazioni, vedere Messaggi personalizzati per la registrazione.

Differenziazione delle copie di un pacchetto

I dati del log includono il nome e il GUID del pacchetto a cui appartengono le voci di log. Se si crea un nuovo pacchetto copiando un pacchetto esistente, verranno copiati anche il nome e il GUID del pacchetto esistente. Possono essere pertanto presenti due pacchetti con nome e GUID uguali e questo può impedire di distinguere tali pacchetti nei dati del log.

Per eliminare questa ambiguità, è consigliabile modificare il nome e il GUID dei nuovi pacchetti. In SQL Server Data Tools (SSDT) è possibile rigenerare il GUID nella proprietà ID e modificare il valore della proprietà Name nella finestra Proprietà. È inoltre possibile modificare il GUID e il nome a livello di codice oppure eseguendo dtutil dal prompt dei comandi. Per ulteriori informazioni, vedere Impostazione delle proprietà di un pacchetto e Utilità dtutil.

Opzioni di registrazione padre

Spesso le opzioni di registrazione delle attività e dei contenitori Ciclo For, Ciclo Foreach e Sequenza corrispondono a quelle del pacchetto o di un contenitore padre. In questo caso è possibile configurarle in modo che ereditino l'impostazione delle opzioni di registrazione del contenitore padre. Ad esempio, in un contenitore Ciclo For che include un'attività Esegui SQL l'attività può utilizzare le opzioni di registrazione impostate nel contenitore. Per consentire l'utilizzo delle opzioni di registrazione padre, è necessario impostare la proprietà LoggingMode del contenitore su UseParentSetting. Questa impostazione può essere eseguita nella finestra Proprietà di SQL Server Data Tools (SSDT) o nella finestra di dialogo Configura log SSIS di Progettazione SSIS.

Modelli di registrazione

Nella finestra di dialogo Configura log SSIS è inoltre possibile creare e salvare come modelli le configurazioni di registrazione utilizzate di frequente. I modelli possono essere quindi applicati in più pacchetti. Ciò consente di applicare una strategia di registrazione consistente tra più pacchetti e di modificare le impostazione di log dei pacchetti semplicemente aggiornando e applicando i modelli. I modelli vengono archiviati in file XML.

Per configurare la registrazione tramite la finestra di dialogo Configura log SSIS

  1. Abilitare il pacchetto e le attività associate per la registrazione. La registrazione può venire eseguita a livello del pacchetto, del contenitore e dell'attività. È possibile specificare log diversi per pacchetti, contenitori e attività.

  2. Selezionare un provider di log e aggiungere un log per il pacchetto. È possibile creare log solo a livello di pacchetto. Inoltre attività o contenitori devono utilizzare uno dei log creati per il pacchetto. I possibili provider di log a cui può essere associato un log sono file di testo, SQL Server Profiler, SQL Server, registro eventi di Windows o file XML. Per ulteriori informazioni, vedere Abilitare la registrazione di pacchetti in SQL Server Data Tools.

  3. Selezionare gli eventi e le informazioni dello schema del registro relative a ogni evento che si desidera registrare. Per ulteriori informazioni, vedere Configurazione della registrazione tramite un file di configurazione salvato.

Configurazione del provider di log

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

La creazione e la configurazione del provider di log avviene in un passaggio dell'implementazione della registrazione in un pacchetto. Per ulteriori informazioni, vedere Registrazione di Integration Services (SSIS).

Dopo avere creato un provider di log è possibile visualizzarne e modificarne le proprietà nella finestra Proprietà di SQL Server Data Tools (SSDT).

Per informazioni sull'impostazione di queste proprietà a livello di codice, vedere la documentazione per la classe LogProvider:

Registrazione per le attività Flusso di dati

L'attività Flusso di dati offre molte voci di log personalizzate che è possibile utilizzare per monitorare e regolare le prestazioni. È ad esempio possibile monitorare i componenti che potrebbero causare perdite di memoria o tenere traccia del tempo necessario per eseguire un componente specifico. Per un elenco di queste voci di log personalizzate e un output di registrazione di esempio, vedere Attività Flusso di dati.

Utilizzo dell'evento PipelineComponentTime

La voce di log personalizzata più utile è probabilmente l'evento PipelineComponentTime. Questa voce di log indica il numero di millisecondi che ogni componente del flusso di dati dedica a ognuno dei cinque passaggi principali dell'elaborazione. Nella tabella seguente vengono descritti i passaggi di elaborazione. Tali passaggi verranno considerati dagli sviluppatori Integration Services come i metodi principali di un oggetto PipelineComponent.

Passaggio

Descrizione

Validate

Il componente verifica la presenza di impostazioni di configurazione e valori di proprietà validi.

PreExecute

Il componente esegue un'unica elaborazione prima di iniziare a elaborare le righe di dati.

PostExecute

Il componente esegue un'unica elaborazione dopo avere elaborato tutte le righe di dati.

ProcessInput

Il componente di destinazione o di trasformazione elabora le righe di dati in ingresso ricevute da un'origine o da una trasformazione a monte.

PrimeOutput

Il componente di origine o di trasformazione riempie i buffer di dati da passare a un componente di destinazione o di trasformazione a valle.

Quando si abilita l'evento PipelineComponentTime, in Integration Services viene registrato un messaggio per ogni passaggio dell'elaborazione eseguito da ogni componente. Nelle voci di log seguenti viene illustrato un subset dei messaggi registrati dal pacchetto di esempio CalculatedColumns di Integration Services:

The component "Calculate LineItemTotalCost" (3522) spent 356 milliseconds in ProcessInput.

The component "Sum Quantity and LineItemTotalCost" (3619) spent 79 milliseconds in ProcessInput.

The component "Calculate Average Cost" (3662) spent 16 milliseconds in ProcessInput.

The component "Sort by ProductID" (3717) spent 125 milliseconds in ProcessInput.

The component "Load Data" (3773) spent 0 milliseconds in ProcessInput.

The component "Extract Data" (3869) spent 688 milliseconds in PrimeOutput filling buffers on output "OLE DB Source Output" (3879).

The component "Sum Quantity and LineItemTotalCost" (3619) spent 141 milliseconds in PrimeOutput filling buffers on output "Aggregate Output 1" (3621).

The component "Sort by ProductID" (3717) spent 16 milliseconds in PrimeOutput filling buffers on output "Sort Output" (3719).

Queste voci di log indicano che l'attività Flusso di dati ha dedicato la maggior parte del tempo ai passaggi seguenti, riportati in ordine decrescente:

  • L'origine OLE DB denominata "Extract Data" ha dedicato 688 ms al caricamento dei dati.

  • La trasformazione Colonna derivata denominata "Calculate LineItemTotalCost" ha dedicato 356 ms per l'esecuzione dei calcoli sulle righe in ingresso.

  • La trasformazione Aggregazione denominata "Sum Quantity and LineItemTotalCost" ha dedicato in tutto 220 ms (141 per PrimeOutput e 79 per ProcessInput) per l'esecuzione di calcoli e il passaggio di dati alla trasformazione successiva.

Attività correlate

Nell'elenco seguente sono contenuti collegamenti ad argomenti che illustrano come eseguire attività correlate alla funzionalità di registrazione.

Contenuto correlato

Icona di Integration Services (piccola) Rimanere aggiornati con Integration Services

Per i download, gli articoli, gli esempi e i video Microsoft più recenti, oltre alle soluzioni selezionate dalla community, visitare la pagina Integration Services sul sito MSDN:


Per ricevere notifiche automatiche su questi aggiornamenti, sottoscrivere i feed RSS disponibili nella pagina.

Strumento DTLoggedExec per la registrazione completa e dettagliata (progetto CodePlex)

Vedere anche

Attivitá

Visualizzazione delle voci di log nella finestra Registra eventi