Registrazione di Integration Services (SSIS)Integration Services (SSIS) Logging

SQL ServerSQL Server Integration ServicesIntegration Services sono disponibili provider di log che è possibile utilizzare per implementare la registrazione in pacchetti, contenitori e attività. Integration ServicesIntegration Services includes log providers that you can use to implement logging in packages, containers, and tasks. 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.With logging, you can capture run-time information about a package, helping you audit and troubleshoot a package every time it is run. 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.For example, a log can capture the name of the operator who ran the package and the time the package began and finished.

È possibile configurare l'ambito di registrazione che si verifica durante l'esecuzione di un pacchetto nel server Integration ServicesIntegration Services .You can configure the scope of logging that occurs during a package execution on the Integration ServicesIntegration Services server. Per altre informazioni, vedere Enable Logging for Package Execution on the SSIS Server.For more information, see Enable Logging for Package Execution on the SSIS Server.

Si può anche includere la registrazione quando si esegue un pacchetto con l'utilità del prompt dei comandi dtexec .You can also include logging when you run a package using the dtexec command prompt utility. Per ulteriori informazioni sugli argomenti del prompt dei comandi che supportano la registrazione, vedere dtexec Utility.For more information about the command prompt arguments that support logging, see dtexec Utility.

Configurare la registrazione in SQL Server Data ToolsConfigure Logging in SQL Server Data Tools

I log sono associati ai pacchetti e vengono configurati a livello del pacchetto.Logs are associated with packages and are configured at the package level. Ogni attività o contenitore di un pacchetto può registrare informazioni in qualsiasi log del pacchetto.Each task or container in a package can log information to any package log. Le attività e i contenitori di un pacchetto possono essere abilitati per la registrazione anche se per il pacchetto la registrazione non è stata attivata.The tasks and containers in a package can be enabled for logging even if the package itself is not. È possibile, ad esempio, abilitare la registrazione in un'attività Esegui SQL senza abilitarla nel pacchetto padre.For example, you can enable logging on an Execute SQL task without enabling logging on the parent package. Un pacchetto, un contenitore o un'attività possono registrare voci in più log.A package, container, or task can write to multiple logs. È possibile scegliere di abilitare la registrazione solo sul pacchetto oppure su ogni singolo contenitore o attività presente nel pacchetto.You can enable logging on the package only, or you can choose to enable logging on any individual task or container that the package includes.

Quando si aggiunge un log a un pacchetto, è necessario scegliere il provider di log e il percorso del log.When you add the log to a package, you choose the log provider and the location of the log. Il provider di log specifica il formato dei dati del log, ad esempio un database di SQL ServerSQL Server o un file di testo.The log provider specifies the format for the log data: for example, a SQL ServerSQL Server database or text file.

Integration ServicesIntegration Services sono disponibili i provider di log seguenti: includes the following log providers:

  • Provider di log File di testo, che scrive le voci di log in file di testo ASCII in formato CSV.The Text File log provider, which writes log entries to ASCII text files in a comma-separated value (CSV) format. L'estensione predefinita dei file per questo provider è log.The default file name extension for this provider is .log.

  • Provider di log SQL Server ProfilerSQL Server Profiler , che scrive tracce che è possibile visualizzare utilizzando SQL ServerSQL Server Profiler.The SQL Server ProfilerSQL Server Profiler log provider, which writes traces that you can view using SQL ServerSQL Server Profiler. L'estensione predefinita dei file per questo provider è trc.The default file name extension for this provider is .trc.

    Nota

    In un pacchetto in esecuzione in modalità a 64 bit non è possibile usare il provider di log di SQL Server ProfilerSQL Server Profiler .You cannot use the SQL Server ProfilerSQL Server Profiler log provider in a package that is running in 64-bit mode.

  • Provider di log SQL ServerSQL Server , che scrive le voci di log nella tabella sysssislog di un database di SQL ServerSQL Server .The SQL ServerSQL Server log provider, which writes log entries to the sysssislog table in a SQL ServerSQL Server database.

  • Provider di log Registro eventi di Windows, che scrive le voci nel registro applicazioni del registro eventi di Windows sul computer locale.The Windows Event log provider, which writes entries to the Application log in the Windows Event log on the local computer.

  • Provider di log File XML, che scrive file di log in formato XML.The XML File log provider, which writes log files to an XML file. L'estensione predefinita dei file per questo provider è xml.The default file name extension for this provider is .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 SSISSSIS , nella finestra di dialogo Configura log SSIS .If you add a log provider to a package or configure logging programmatically, you can use either a ProgID or ClassID to identify the log provider, instead of using the names that SSISSSIS Designer displays in the Configure SSIS Logs dialog box.

    Nella tabella seguente sono elencati i ProgID e i ClassID per i provider di log disponibili in Integration ServicesIntegration Services e i percorsi dei log in cui scrivono i provider.The following table lists the ProgID and ClassID for the log providers that Integration ServicesIntegration Services includes, and the location of the logs to which log providers write.

Provider di logLog provider ProgIDProgID ClassIDClassID PercorsoLocation
File di testoText file DTS.LogProviderTextFileDTS.LogProviderTextFile {0A039101-ACC1-4E06-943F-279948323883}{0A039101-ACC1-4E06-943F-279948323883} La gestione connessione file utilizzata dal provider di log specifica il percorso del file di testo.The File connection manager that the log provider uses specifies the path of the text file.
SQL Server ProfilerSQL Server Profiler DTS.LogProviderSQLProfilerDTS.LogProviderSQLProfiler {E93F6300-AE0C-4916-A7BF-A8D0CE12C77A}{E93F6300-AE0C-4916-A7BF-A8D0CE12C77A} La gestione connessione file utilizzata dal provider di log specifica il percorso del file utilizzato da SQL Server ProfilerSQL Server Profiler.The File connection manager that the log provider uses specifies the path of the file used by SQL Server ProfilerSQL Server Profiler.
SQL ServerSQL Server DTS.LogProviderSQLServerDTS.LogProviderSQLServer {94150B25-6AEB-4C0D-996D-D37D1C4FDEDA}{94150B25-6AEB-4C0D-996D-D37D1C4FDEDA} La gestione connessione OLE DB usata dal provider di log indica il database di SQL ServerSQL Server in cui si trova la tabella sysssislog contenente le voci di log.The OLE DB connection manager that the log provider uses specifies the SQL ServerSQL Server database that contains the sysssislog table with the log entries.
Registro eventi di WindowsWindows Event Log DTS.LogProviderEventLogDTS.LogProviderEventLog {071CC8EB-C343-4CFF-8D58-564B92FCA3CF}{071CC8EB-C343-4CFF-8D58-564B92FCA3CF} Il registro applicazioni nel Visualizzatore eventi di Windows contiene le informazioni del log di Integration ServicesIntegration Services .The Application log in Windows Event Viewer contains the Integration ServicesIntegration Services log information.
File XMLXML File DTS.LogProviderXMLFileDTS.LogProviderXMLFile {440945A4-2A22-4F19-B577-EAF5FDDC5F7A}{440945A4-2A22-4F19-B577-EAF5FDDC5F7A} La gestione connessione file utilizzata dal provider di log specifica il percorso del file XML.The File connection manager that the log provider uses specifies the path of the XML file.

È inoltre possibile creare provider di log personalizzati.You can also create custom log providers. Per altre informazioni, vedere Creating a Custom Log Provider.For more information, see Creating a Custom Log Provider.

I provider di log di un pacchetto sono membri della raccolta dei provider di log del pacchetto.The log providers in a package are members of the log providers collection of the package. Se si crea un pacchetto e si implementa la registrazione tramite Progettazione SSISSSIS , sarà possibile visualizzare l'elenco dei membri della raccolta nelle cartelle Provider di log della scheda Esplora pacchetti di Progettazione SSISSSIS .When you create a package and implement logging by using SSISSSIS Designer, you can see a list of the collection members in the Log Provider folders on the Package Explorer tab of SSISSSIS Designer.

Per configurare un provider di log è necessario specificarne il nome, la descrizione e la gestione connessione utilizzata.You configure a log provider by providing a name and description for the log provider and specifying the connection manager that the log provider uses. Il provider di log SQL ServerSQL Server utilizza una gestione connessione OLE DB.The SQL ServerSQL Server log provider uses an OLE DB connection manager. I provider di log File di testo, SQL Server ProfilerSQL Server Profilere File XML utilizzano gestioni connessioni file.The Text File, SQL Server ProfilerSQL Server Profiler, and XML File log providers all use File connection managers. Il provider di log Registro eventi di Windows non utilizza invece una gestione connessione, perché scrive direttamente nel Registro eventi di Windows.The Windows Event log provider does not use a connection manager, because it writes directly to the Windows Event log. Per ulteriori informazioni, vedere OLE DB Connection Manager e File Connection Manager.For more information, see OLE DB Connection Manager and File Connection Manager.

Personalizzazione della registrazioneLogging Customization

Per la personalizzazione della registrazione di un evento o la creazione di un messaggio personalizzato, in Integration ServicesIntegration Services è disponibile uno schema di informazioni comunemente registrate, che è possibile includere nelle voci di log.To customize the logging of an event or custom message, Integration ServicesIntegration Services provides a schema of commonly logged information to include in log entries. Lo schema del log di Integration ServicesIntegration Services delinea le informazioni che è possibile registrare.The Integration ServicesIntegration Services log schema defines the information that you can log. È possibile selezionare elementi dallo schema per ogni voce di log.You can select elements from the log schema for each log entry.

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.A package and its containers and tasks do not have to log the same information, and tasks within the same package or container can log different information. 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.For example, a package can log operator information when the package starts, one task can log the source of the task's failure, and another task can log information when errors occur. Se un pacchetto e le attività e i contenitori associati utilizzano più log, in tutti i log vengono registrate le stesse informazioni.If a package and its containers and tasks use multiple logs, the same information is written to all the logs.

È possibile selezionare il livello di registrazione più adatto alle proprie esigenze specificando gli eventi e le informazioni di ogni evento da registrare.You can select a level of logging that suits your needs by specifying the events to log and the information to log for each event. A seconda delle specifiche esigenze le informazioni fornite da alcuni eventi potrebbero risultare più utili rispetto a quelle di altri eventi.You may find that some events provide more useful information than others. 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 .For example, you might want to log only the computer and operator names for the PreExecute event but all available information for the Error event.

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.To prevent log files from using large amounts of disk space, or to avoid excessive logging, which could degrade performance, you can limit logging by selecting specific events and information items to log. È possibile, ad esempio, configurare un log in modo che per ogni errore vengano registrati solo il nome del computer e la data.For example, you can configure a log to capture only the date and the computer name for each error.

Nella finestra di dialogo SSISSSIS Configura log SSIS di Progettazione sono disponibili le opzioni di registrazione.In SSISSSIS Designer, you define the logging options by using the Configure SSIS Logs dialog box.

Schema del logLog Schema

Nella tabella seguente vengono descritti gli elementi dello schema del log.The following table describes the elements in the log schema.

ElementoElement DescriptionDescription
ComputerComputer Nome del computer in cui è stato generato l'evento.The name of the computer on which the log event occurred.
OperatoreOperator Identifica l'utente che ha avviato il pacchetto.The identity of the user who launched the package.
SourceNameSourceName Nome del contenitore o dell'attività in cui è stato generato l'evento.The name of the container or task in which the log event occurred.
SourceIDSourceID Identificatore univoco del pacchetto, contenitore Ciclo For, Ciclo Foreach o Sequenza oppure attività in cui è stato generato l'evento.The unique identifier of the package; the For Loop, Foreach Loop, or Sequence container; or the task in which the log event occurred.
ExecutionIDExecutionID GUID dell'istanza di esecuzione del pacchetto.The GUID of the package execution instance.

L'esecuzione di un singolo pacchetto potrebbe creare voci di log con valori diversi per l'elemento ExecutionID.Note: Running a single package might create log entries with different values for the ExecutionID element. Ad esempio, quando si esegue un pacchetto in SQL Server Data ToolsSQL Server Data Tools, la fase di convalida potrebbe creare voci di log con un elemento ExecutionID che corrisponde a SQL Server Data ToolsSQL Server Data Tools.For example, when you run a package in SQL Server Data ToolsSQL Server Data Tools, the validation phase might create log entries with an ExecutionID element that corresponds to SQL Server Data ToolsSQL Server Data Tools. La fase di esecuzione potrebbe invece creare voci di log con un elemento ExecutionID che corrisponde a dtshost.exe.However, the execution phase might create log entries with an ExecutionID element that corresponds to 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.For another example, when you run a package that contains Execute Package tasks, each of these tasks runs a child package. Questi pacchetti figlio potrebbero creare voci di log con un elemento ExecutionID diverso rispetto alle voci di log create dal pacchetto.These child packages might create log entries that have a different ExecutionID element than the log entries that the parent package creates.
MessageTextMessageText Messaggio associato alla voce di log.A message associated with the log entry.
DataBytesDataBytes Matrice di byte specifica della voce di log.A byte array specific to the log entry. Il significato di questo campo varia a seconda della voce di log.The meaning of this field varies by log entry.

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 .The following table describes three additional elements in the log schema that are not available on the Details tab of the Configure SSIS Logs dialog box.

ElementoElement DescriptionDescription
StartTimeStartTime Ora di inizio dell'esecuzione del contenitore o dell'attività.The time at which the container or task starts to run.
EndTimeEndTime Ora di arresto dell'esecuzione del contenitore o dell'attività.The time at which the container or task stops running.
DataCodeDataCode Valore intero facoltativo che in genere contiene un valore dell'enumerazione DTSExecResult che indica il risultato dell'esecuzione del contenitore o dell'attività:An optional integer value that typically contains a value from the DTSExecResult enumeration that indicates the result of running the container or task:

0 - Esito positivo0 - Success

1 - Esito negativo1 - Failure

2 - Esecuzione completata2 - Completed

3 - Esecuzione annullata3 - Canceled

Voci di logLog Entries

Integration ServicesIntegration Services supporta voci di log per gli eventi predefiniti e offre voci di log personalizzate per molti oggetti di Integration ServicesIntegration Services . supports log entries on predefined events and provides custom log entries for many Integration ServicesIntegration Services objects. Tali eventi e voci di log personalizzate sono elencati nella finestra di dialogo Configura log SSIS di Progettazione SSISSSIS .The Configure SSIS Logs dialog box in SSISSSIS Designer lists these events and custom log entries.

Nella tabella seguente vengono descritti gli eventi predefiniti che è possibile abilitare per scrivere voci di log quando si verificano eventi di run-time.The following table describes the predefined events that can be enabled to write log entries when run-time events occur. Queste voci sono relative ai file eseguibili, al pacchetto e alle attività e ai contenitori inclusi nel pacchetto.These log entries apply to executables, the package, and the tasks and containers that the package includes. 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.The name of the log entry is the same as the name of the run-time event that was raised and caused the log entry to be written.

EventiEvents DescriptionDescription
OnErrorOnError Viene inserita una voce del registro quando si verifica un errore.Writes a log entry when an error occurs.
OnExecStatusChangedOnExecStatusChanged Viene scritta una voce del registro quando un'attività (non un contenitore) viene sospesa o ripresa durante il debug.Writes a log entry when a task (not a container) is suspended or resumed during debugging.
OnInformationOnInformation Viene scritta una voce del registro durante la convalida e l'esecuzione di un eseguibile per la segnalazione di informazioni.Writes a log entry during the validation and execution of an executable to report information.
OnPostExecuteOnPostExecute Viene registrata una voce di log non appena l'esecuzione del file eseguibile viene completata.Writes a log entry immediately after the executable has finished running.
OnPostValidateOnPostValidate Viene registrata una voce di log dopo la convalida del file eseguibile.Writes a log entry when the validation of the executable finishes.
OnPreExecuteOnPreExecute Viene registrata una voce di log immediatamente prima dell'esecuzione del file eseguibile.Writes a log entry immediately before the executable runs.
OnPreValidateOnPreValidate Viene registrata una voce di log all'avvio della convalida del file eseguibile.Writes a log entry when the validation of the executable starts.
OnProgressOnProgress Viene registrata una voce di log dopo un avanzamento percettibile dell'esecuzione del file eseguibile.Writes a log entry when measurable progress is made by the executable.
OnQueryCancelOnQueryCancel Viene registrata una voce di log in qualsiasi momento dell'elaborazione dell'attività in cui è possibile annullare l'esecuzione.Writes a log entry at any juncture in the task processing where it is feasible to cancel execution.
OnTaskFailedOnTaskFailed Viene registrata una voce di log quando un'attività ha esito negativo.Writes a log entry when a task fails.
OnVariableValueChangedOnVariableValueChanged Viene registrata una voce di log quando il valore di una variabile viene modificato.Writes a log entry when the value of a variable changes.
OnWarningOnWarning Viene registrata una voce di log in corrispondenza di un avviso.Writes a log entry when a warning occurs.
PipelineComponentTimePipelineComponentTime Per ogni componente del flusso di dati, viene registrata una voce di log per ogni fase di convalida ed esecuzione.For each data flow component, writes a log entry for each phase of validation and execution. La voce di log specifica il tempo di elaborazione per ogni fase.The log entry specifies the processing time for each phase.
DiagnosticDiagnostic

DiagnosticExDiagnosticEx
Viene registrata una voce di log che fornisce informazioni diagnostiche.Writes a log entry that provides diagnostic information.

È ad esempio possibile registrare un messaggio prima e dopo ogni chiamata a un provider di dati esterno.For example, you can log a message before and after every call to an external data provider. Per altre informazioni, vedere Risoluzione dei problemi relativi agli strumenti per l'esecuzione del pacchetto.For more information, see Troubleshooting Tools for Package Execution.

Registrare l'evento DiagnosticEx quando si vuole trovare i nomi delle colonne per le colonne nel flusso di dati che contengono errori.Log the DiagnosticEx event when you want to find the column names for columns in the data flow that have errors. Questo evento scrive una mappa di derivazione del flusso di dati nel log.This event writes a data flow lineage map to the log. È quindi possibile cercare il nome della colonna in questa mappa di derivazione usando l'identificatore della colonna acquisito da un output degli errori.You can then look up the column name in this lineage map by using the column identifier captured by an error output. Per ulteriori informazioni, vedere Error Handling in Data.For more info, see Error Handling in Data.

Notare che l'evento DiagnosticEx non mantiene gli spazi vuoti nel relativo output XML per ridurre le dimensioni del log.Note that the DiagnosticEx event does not preserve whitespace in its XML output to reduce the size of the log. Per migliorare la leggibilità, copiare il log in un editor XML come Visual Studio, che supporta la formattazione XML e l'evidenziazione della sintassi.To improve readability, copy the log into an XML editor - in Visual Studio, for example - that supports XML formatting and syntax highlighting.

Nota: se si registra l'evento DiagnosticEx con il provider di log di SQL Server, l'output potrebbe essere troncato.Note: If you log the DiagnosticEx event with the SQL Server log provider, the output may be truncated. Il campo message del provider di log di SQL Server è di tipo nvarchar(2048).The message field of the SQL Server log provider is of type nvarchar(2048). Per evitare il troncamento, usare un provider di log diverso quando si registra l'evento DiagnosticEx .To avoid truncation, use a different log provider when you log the DiagnosticEx event.

Per il pacchetto e per molte attività sono disponibili voci di log personalizzate che è possibile abilitare per la registrazione.The package and many tasks have custom log entries that can be enabled for logging. 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.For example, the Send Mail task provides the SendMailTaskBegin custom log entry, which logs information when the Send Mail task starts to run, but before the task sends an e-mail message. Per altre informazioni, vedere Custom Messages for Logging.For more information, see Custom Messages for Logging.

Differenziazione delle copie di un pacchettoDifferentiating Package Copies

I dati del log includono il nome e il GUID del pacchetto a cui appartengono le voci di log.Log data includes the name and the GUID of the package to which the log entries belong. Se si crea un nuovo pacchetto copiando un pacchetto esistente, verranno copiati anche il nome e il GUID del pacchetto esistente.If you create a new package by copying an existing package, the name and the GUID of the existing package are also copied. Possono essere pertanto presenti due pacchetti con nome e GUID uguali e questo può impedire di distinguere tali pacchetti nei dati del log.As a result, you may have two packages that have the same GUID and name, making it difficult to differentiate between the packages in the log data.

Per eliminare questa ambiguità, è consigliabile modificare il nome e il GUID dei nuovi pacchetti.To eliminate this ambiguity, you should update the name and the GUID of the new packages. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)è possibile rigenerare il GUID nella proprietà ID e modificare il valore della proprietà Name nella finestra Proprietà.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), you can regenerate the GUID in the ID property and update the value of the Name property in the Properties window. È inoltre possibile modificare il GUID e il nome a livello di codice oppure eseguendo dtutil dal prompt dei comandi.You can also change the GUID and the name programmatically, or by using the dtutil command prompt. Per altre informazioni, vedere Impostazione delle proprietà di un pacchetto e Utilità dtutil.For more information, see Set Package Properties and dtutil Utility.

Opzioni di registrazione padreParent Logging Options

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.Frequently, the logging options of tasks and For Loop, Foreach Loop, and Sequence containers match those of the package or a parent container. In questo caso è possibile configurarle in modo che ereditino l'impostazione delle opzioni di registrazione del contenitore padre.In that case, you can configure them to inherit their logging options from their parent container. Ad esempio, in un contenitore Ciclo For che include un'attività Esegui SQL l'attività può utilizzare le opzioni di registrazione impostate nel contenitore.For example, in a For Loop container that includes an Execute SQL task, the Execute SQL task can use the logging options that are set on the For Loop container. Per consentire l'utilizzo delle opzioni di registrazione padre, è necessario impostare la proprietà LoggingMode del contenitore su UseParentSetting.To use the parent logging options, you set the LoggingMode property of the container to UseParentSetting. Questa impostazione può essere eseguita nella finestra Proprietà di SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) o nella finestra di dialogo Configura log SSIS di Progettazione SSISSSIS .You can set this property in the Properties window of SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) or through the Configure SSIS Logs dialog box in SSISSSIS Designer.

Modelli di registrazioneLogging Templates

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.In the Configure SSIS Logs dialog box, you can also create and save frequently used logging configurations as templates, and then use the templates in multiple packages. 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.This makes it easy to apply a consistent logging strategy across multiple packages and to modify log settings on packages by updating and then applying the templates. I modelli vengono archiviati in file XML.The templates are stored in XML files.

Per configurare la registrazione tramite la finestra di dialogo Configura log SSISTo configure logging using the Configure SSIS Logs dialog box

  1. Abilitare il pacchetto e le attività associate per la registrazione.Enable the package and its tasks for logging. La registrazione può venire eseguita a livello del pacchetto, del contenitore e dell'attività.Logging can occur at the package, the container, and the task level. È possibile specificare log diversi per pacchetti, contenitori e attività.You can specify different logs for packages, containers, and tasks.

  2. Selezionare un provider di log e aggiungere un log per il pacchetto.Select a log provider and add a log for the package. È possibile creare log solo a livello di pacchetto. Inoltre attività o contenitori devono utilizzare uno dei log creati per il pacchetto.Logs can be created only at the package level, and a task or container must use one of the logs created for the package. I possibili provider di log a cui può essere associato un log sono file di testo, SQL Server ProfilerSQL Server Profiler, SQL ServerSQL Server, registro eventi di Windows o file XML.Each log is associated with one of the following log providers: Text file, SQL Server ProfilerSQL Server Profiler, SQL ServerSQL Server, Windows Event Log, or XML file. Per altre informazioni, vedere Abilitare la registrazione di pacchetti in SQL Server Data Tools.For more information, see Enable Package Logging in SQL Server Data Tools.

  3. Selezionare gli eventi e le informazioni dello schema del registro relative a ogni evento che si desidera registrare.Select the events and the log schema information about each event you want to capture in the log. Per altre informazioni, vedere Configurazione della registrazione tramite un file di configurazione salvato.For more information, see Configure Logging by Using a Saved Configuration File.

Configurazione del provider di logConfiguration of Log Provider

È possibile impostare le proprietà tramite Progettazione SSISSSIS o a livello di codice.You can set properties through SSISSSIS Designer or programmatically.

La creazione e la configurazione del provider di log avviene in un passaggio dell'implementazione della registrazione in un pacchetto.A log provider is created and configured as a step in implementing logging in a package.

Dopo avere creato un provider di log è possibile visualizzarne e modificarne le proprietà nella finestra Proprietà di SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).After you create a log provider, you can view and modify its properties in the Properties window of SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).

Per informazioni sull'impostazione di queste proprietà a livello di programmazione, vedere la documentazione per la classe LogProvider .For information about programmatically setting these properties, see the documentation for the LogProvider class.

Registrazione per le attività Flusso di datiLogging for Data Flow Tasks

L'attività Flusso di dati offre molte voci di log personalizzate che è possibile utilizzare per monitorare e regolare le prestazioni.The Data Flow task provides many custom log entries that can be used to monitor and adjust performance. È ad esempio possibile monitorare i componenti che potrebbero causare perdite di memoria o tenere traccia del tempo necessario per eseguire un componente specifico.For example, you can monitor components that might cause memory leaks, or keep track of how long it takes to run a particular component. Per un elenco di queste voci di log personalizzate e un output di registrazione di esempio, vedere Data Flow Task.For a list of these custom log entries and sample logging output, see Data Flow Task.

Acquisire i nomi delle colonne cui si verificano erroriCapture the names of columns in which errors occur

Quando si configura un output di errore errori nel flusso di dati, per impostazione predefinita l'output di errore fornisce solo l'identificatore numerico della colonna in cui si è verificato l'errore.When you configure an error output in the data flow, by default the error output provides only the numeric identifier of the column in which the error occurred. Per ulteriori informazioni, vedere Error Handling in Data.For more info, see Error Handling in Data.

È possibile trovare i nomi di colonna abilitando la registrazione e selezionando l'evento DiagnosticEx .You can find column names by enabling logging and selecting the DiagnosticEx event. Questo evento scrive una mappa di derivazione del flusso di dati nel log.This event writes a data flow lineage map to the log. È quindi possibile cercare il nome della colonna dal relativo identificatore in questa mappa di derivazione.You can then look up the column name from its identifier in this lineage map. Notare che l'evento DiagnosticEx non mantiene gli spazi vuoti nel relativo output XML per ridurre le dimensioni del log.Note that the DiagnosticEx event does not preserve whitespace in its XML output to reduce the size of the log. Per migliorare la leggibilità, copiare il log in un editor XML come Visual Studio, che supporta la formattazione XML e l'evidenziazione della sintassi.To improve readability, copy the log into an XML editor - in Visual Studio, for example - that supports XML formatting and syntax highlighting.

Utilizzo dell'evento PipelineComponentTimeUse the PipelineComponentTime Event

La voce di log personalizzata più utile è probabilmente l'evento PipelineComponentTime.Perhaps the most useful custom log entry is the PipelineComponentTime event. 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.This log entry reports the number of milliseconds that each component in the data flow spends on each of the five major processing steps. Nella tabella seguente vengono descritti i passaggi di elaborazione.The following table describes these processing steps. Integration ServicesIntegration Services Gli sviluppatori di Integration Services riconosceranno tali passaggi come i metodi principali di PipelineComponent. developers will recognize these steps as the principal methods of a PipelineComponent.

PassaggioStep DescriptionDescription
ConvalidaValidate Il componente verifica la presenza di impostazioni di configurazione e valori di proprietà validi.The component checks for valid property values and configuration settings.
PreExecutePreExecute Il componente esegue un'unica elaborazione prima di iniziare a elaborare le righe di dati.The component performs one-time processing before it starts to process rows of data.
PostExecutePostExecute Il componente esegue un'unica elaborazione dopo avere elaborato tutte le righe di dati.The component performs one-time processing after it has processed all rows of data.
ProcessInputProcessInput Il componente di destinazione o di trasformazione elabora le righe di dati in ingresso ricevute da un'origine o da una trasformazione a monte.The transformation or destination component processes the incoming rows of data that an upstream source or transformation has passed to it.
PrimeOutputPrimeOutput Il componente di origine o di trasformazione riempie i buffer di dati da passare a un componente di destinazione o di trasformazione a valle.The source or transformation component fills the buffers of data to be passed to a downstream transformation or destination component.

Quando si abilita l'evento PipelineComponentTime, in Integration ServicesIntegration Services viene registrato un messaggio per ogni passaggio dell'elaborazione eseguito da ogni componente.When you enable the PipelineComponentTime event, Integration ServicesIntegration Services logs one message for each processing step performed by each component. Nelle voci di log seguenti viene illustrato un subset dei messaggi registrati dal pacchetto di esempio CalculatedColumns di Integration ServicesIntegration Services :The following log entries show a subset of the messages that the Integration ServicesIntegration Services CalculatedColumns package sample logs:

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:These log entries show that the data flow task spent the most time on the following steps, shown here in descending order:

  • L'origine OLE DB denominata "Extract Data" ha dedicato 688 msThe OLE DB source that is named "Extract Data" spent 688 ms. al caricamento dei dati.loading data.

  • La trasformazione Colonna derivata denominata "Calculate LineItemTotalCost" ha dedicato 356 msThe Derived Column transformation that is named "Calculate LineItemTotalCost" spent 356 ms. per l'esecuzione dei calcoli sulle righe in ingresso.performing calculations on incoming rows.

  • 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.The Aggregate transformation that is named "Sum Quantity and LineItemTotalCost" spent a combined 220 ms—141 in PrimeOutput and 79 in ProcessInput—performing calculations and passing the data to the next transformation.

Abilitare la registrazione di pacchetti in SQL Server Data Tools Enable Package Logging in SQL Server Data Tools

In questo argomento viene descritta la procedura per aggiungere log in un pacchetto, configurare la registrazione a livello di pacchetto e salvare la configurazione di registrazione in un file XML.This procedure describes how to add logs to a package, configure package-level logging, and save the logging configuration to an XML file. È possibile aggiungere log solo a livello di pacchetto. Il pacchetto, tuttavia, non deve eseguire necessariamente la registrazione per consentire la registrazione nei contenitori del pacchetto.You can add logs only at the package level, but the package does not have to perform logging to enable logging in the containers that the package includes.

Importante

Se si distribuisce il progetto Integration ServicesIntegration Services nel server Integration ServicesIntegration Services , il livello di registrazione impostato per l'esecuzione del pacchetto esegue l'override della registrazione del pacchetto configurata mediante SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).If you deploy the Integration ServicesIntegration Services project to the Integration ServicesIntegration Services server, the logging level that you set for the package execution overrides the package logging that you configure using SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).

Per impostazione predefinita, i contenitori del pacchetto utilizzano la stessa configurazione di registrazione del contenitore padre.By default, the containers in the package use the same logging configuration as their parent container. Per informazioni sull'impostazione delle opzioni di registrazione per singoli contenitori, vedere Configurazione della registrazione tramite un file di configurazione salvato.For information about setting logging options for individual containers, see Configure Logging by Using a Saved Configuration File.

Per abilitare la registrazione in un pacchettoTo enable logging in a package

  1. In SQL Server Data ToolsSQL Server Data Toolsaprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data ToolsSQL Server Data Tools, open the Integration ServicesIntegration Services project that contains the package you want.

  2. Scegliere Registrazione dal menu SSIS.On the SSIS menu, click Logging.

  3. Selezionare un provider di log nell'elenco Tipo provider e quindi fare clic su Aggiungi.Select a log provider in the Provider type list, and then click Add.

  4. Nel configurazione colonna, selezionare una gestione connessione oppure fare clic su <nuova connessione > per creare una nuova gestione connessione del tipo appropriato per il provider di log.In the Configuration column, select a connection manager or click <New connection> to create a new connection manager of the appropriate type for the log provider. A seconda del provider selezionato, utilizzare una delle gestioni connessioni seguenti:Depending on the selected provider, use one of the following connection managers:

    • Per file di testo utilizzare una gestione connessione file.For Text files, use a File connection manager. Per altre informazioni, vedere Gestione connessione fileFor more information, see File Connection Manager

    • Per SQL Server ProfilerSQL Server Profilerusare una gestione connessione file.For SQL Server ProfilerSQL Server Profiler, use a File connection manager.

    • Per SQL ServerSQL Serverutilizzare una gestione connessione OLE DB.For SQL ServerSQL Server, use an OLE DB connection manager. Per altre informazioni, vedere Gestione connessione OLE DB.For more information, see OLE DB Connection Manager.

    • Per il Registro eventi di Windows, non eseguire alcuna operazione.For Windows Event Log, do nothing. SSISSSISCrea automaticamente il log. automatically creates the log.

    • Per file XML utilizzare una gestione connessione file.For XML files, use a File connection manager.

  5. Ripetere i passaggi 3 e 4 per ogni log da utilizzare nel pacchetto.Repeat steps 3 and 4 for each log to use in the package.

    Nota

    In un pacchetto possono venire utilizzati più log di ognuno dei tipi di log.A package can use more than one log of each type.

  6. Facoltativamente, selezionare la casella di controllo a livello di pacchetto, selezionare i log da usare per la registrazione a livello di pacchetto e quindi fare clic sulla scheda Dettagli .Optionally, select the package-level check box, select the logs to use for package-level logging, and then click the Details tab.

  7. Nella scheda Dettagli selezionare Eventi per registrare tutte le voci di log oppure deselezionare l'opzione Eventi se si desidera selezionare singoli eventi.On the Details tab, select Events to log all log entries, or clear Events to select individual events.

  8. Facoltativamente, fare clic su Avanzate per specificare le informazioni da registrare.Optionally, click Advanced to specify which information to log.

    Nota

    Per impostazione predefinita vengono registrate tutte le informazioni.By default, all information is logged.

  9. Nella scheda Dettagli fare clic su Salva.On the Details tab, click Save. Verrà visualizzata la finestra di dialogo Salva con nome .The Save As dialog box appears. Individuare la cartella in cui salvare la configurazione di registrazione, digitare un nome di file per la nuova configurazione e quindi fare clic su Salva.Locate the folder in which to save the logging configuration, type a file name for the new log configuration, and then click Save.

  10. Scegliere OK.Click OK.

  11. Per salvare il pacchetto aggiornato, scegliere Salva elementi selezionati dal menu File .To save the updated package, click Save Selected Items on the File menu.

Finestra di dialogo Configura log SSIS Configure SSIS Logs Dialog Box

Utilizzare la finestra di dialogo Configura log SSIS per definire le opzioni di registrazione per un pacchetto.Use the Configure SSIS Logs dialog box to define logging options for a package.

Per saperne di piùWhat do you want to do?

  1. Apertura della finestra di dialogo Configura log SSISOpen the Configure SSIS Logs Dialog Box

  2. Configurazione delle opzioni nel riquadro ContenitoriConfigure the Options in the Containers Pane

  3. Configurazione delle opzioni nella scheda Provider e logConfigure the Options on the Providers and Logs Tab

  4. Configurazione delle opzioni nella scheda DettagliConfigure the Options on the Details Tab

Apertura della finestra di dialogo Configura log SSIS Open the Configure SSIS Logs Dialog Box

Per aprire la finestra di dialogo Configura log SSISTo open the Configure SSIS Logs dialog box

  • In Progettazione SSISSSIS scegliere Registrazione nel menu SSIS .In the SSISSSIS Designer, click Logging on the SSIS menu.

Configurazione delle opzioni nel riquadro Contenitori Configure the Options in the Containers Pane

Utilizzare il riquadro Contenitori della finestra di dialogo Configura log SSIS per abilitare il pacchetto e i relativi contenitori per la registrazione.Use the Containers pane of the Configure SSIS Logs dialog box to enable the package and its containers for logging.

OpzioniOptions

ContenitoriContainers
Nella visualizzazione gerarchica selezionare le caselle di controllo in modo da abilitare il pacchetto e i relativi contenitori per la registrazione:Select the check boxes in the hierarchical view to enable the package and its containers for logging:

  • Se deselezionato, il contenitore non è abilitato per la registrazione.If cleared, the container is not enabled for logging. Selezionarlo per abilitare la registrazione.Select to enable logging.

  • Se visualizzato in grigio, il contenitore utilizza le opzioni di registrazione dell'elemento padre.If dimmed, the container uses the logging options of its parent. Questa opzione non è disponibile per il pacchetto.This option is not available for the package.

  • Se selezionato, il contenitore definisce opzioni di registrazione specifiche.If checked, the container defines its own logging options.

    Se si desidera impostare le opzioni di registrazione per un contenitore visualizzato in grigio, fare doppio clic sulla casella di controllo corrispondente al contenitore in questione.If a container is dimmed and you want to set logging options on the container, click its check box twice. Al primo clic la casella di controllo viene deselezionata e al secondo clic viene selezionata, consentendo di scegliere il provider di log da utilizzare e di specificare le informazioni da registrare.The first click clears the check box, and the second click selects it, enabling you to choose the log providers to use and select the information to log.

Configurazione delle opzioni nella scheda Provider e log Configure the Options on the Providers and Logs Tab

Usare la scheda Provider e log della finestra di dialogo Configura log SSIS per creare e configurare log per l'acquisizione di eventi di runtime.Use the Providers and Logs tab of the Configure SSIS Logs dialog box to create and configure logs for capturing run-time events.

OpzioniOptions

Tipo providerProvider type
Consente di selezionare un tipo di logger nell'elenco.Select a type of log provider from the list.

AggiungiAdd
Consente di aggiungere un log del tipo specificato alla raccolta di logger del pacchetto.Add a log of the specified type to the collection of log providers of the package.

NomeName
Consente di abilitare o disabilitare log per contenitori o attività selezionati nel riquadro Contenitori della finestra di dialogo Configura log SSIS usando le caselle di controllo.Enable or disable logs for containers or tasks selected in the Containers pane of the Configure SSIS Logs dialog box, by using the check boxes. Il campo del nome è modificabile.The name field is editable. Utilizzare il nome predefinito per il provider oppure digitare un nome descrittivo univoco.Use the default name for the provider, or type a unique descriptive name.

DescriptionDescription
Il campo della descrizione è modificabile.The description field is editable. Fare clic nel campo e quindi modificare la descrizione predefinita del log.Click and then modify the default description of the log.

ConfigurazioneConfiguration
Selezionare una gestione connessione esistente nell'elenco oppure fare clic su < nuova connessione... > per creare una nuova gestione connessione.Select an existing connection manager in the list, or click <New connection...> to create a new connection manager. A seconda del tipo di logger, è possibile configurare una gestione connessione OLE DB o una gestione connessione file.Depending on the type of log provider, you can configure an OLE DB connection manager or a File connection manager. Il logger per il registro eventi di MicrosoftMicrosoft non necessita di connessioni.The log provider for the MicrosoftMicrosoft Windows Event Log requires no connection.

Argomenti correlati: OLE DB Connection Manager e File Connection ManagerRelated Topics: OLE DB Connection Manager manager, File Connection Manager

DeleteDelete
Selezionare un provider di log e fare clic su Elimina.Select a log provider and then click Delete.

Configurazione delle opzioni nella scheda Dettagli Configure the Options on the Details Tab

Utilizzare la scheda Dettagli della finestra di dialogo Configura log SSIS per indicare gli eventi da abilitare per la registrazione e specificare le informazioni da registrare.Use the Details tab of the Configure SSIS Logs dialog box to specify the events to enable for logging and the information details to log. Le informazioni selezionate saranno valide per tutti i provider di log nel pacchetto.The information that you select applies to all the log providers in the package. Non è ad esempio possibile scrivere informazioni nell'istanza di SQL ServerSQL Server diverse da quelle specificate in un file di testo.For example, you cannot write some information to the SQL ServerSQL Server instance and different information to a text file.

OpzioniOptions

EventiEvents
Consente di abilitare o disabilitare gli eventi per la registrazione.Enable or disable events for logging.

DescriptionDescription
Consente di visualizzare una descrizione dell'evento.View a description of the event.

AvanzateAdvanced
Consente di selezionare o deselezionare gli eventi da registrare, nonché le informazioni da registrare per ogni evento.Select or clear events to log, and select or clear information to log for each event. Fare clic su Standard per nascondere tutti i dettagli di registrazione, ad eccezione dell'elenco di eventi.Click Basic to hide all logging details, except the list of events. Per la registrazione sono disponibili le informazioni seguenti:The following information is available for logging:

ValoreValue DescriptionDescription
ComputerComputer Nome del computer in cui si è verificato l'evento registrato.The name of the computer on which the logged event occurred.
OperatoreOperator Nome utente dell'utente che ha avviato il pacchetto.The user name of the person who started the package.
SourceNameSourceName Nome del pacchetto, contenitore o attività in cui si è verificato l'evento registrato.The name of the package, container, or task in which the logged event occurred.
SourceIDSourceID Identificatore univoco globale (GUID, Global Unique Identifier) del pacchetto, contenitore o attività in cui si è verificato l'evento registrato.The global unique identifier (GUID) of the package, container, or task in which the logged event occurred.
ExecutionIDExecutionID Identificatore univoco globale dell'istanza di esecuzione del pacchetto.The global unique identifier of the package execution instance.
MessageTextMessageText Messaggio associato alla voce di log.A message associated with the log entry.
DataBytesDataBytes Riservato per utilizzi futuri.Reserved for future use.

StandardBasic
Consente di selezionare o deselezionare gli eventi da registrare.Select or clear events to log. Questa opzione può essere utilizzata per nascondere i dettagli di registrazione, ad eccezione dell'elenco di eventi.This option hides logging details except the list of events. Se si seleziona un evento, per impostazione predefinita verranno selezionati anche tutti i relativi dettagli di registrazione.If you select an event, all logging details are selected for the event by default. Fare clic su Avanzate per visualizzarli.Click Advanced to show all logging details.

LoadLoad
Consente di specificare un file XML esistente da utilizzare come modello per l'impostazione delle opzioni di registrazione.Specify an existing XML file to use as a template for setting logging options.

SalvareSave
Consente di salvare i dettagli di configurazione come modello in un file XML.Save configuration details as a template to an XML file.

Configurazione della registrazione tramite un file di configurazione salvato Configure Logging by Using a Saved Configuration File

In questo argomento viene descritta la procedura per configurare la registrazione per nuovi contenitori di un pacchetto semplicemente caricando un file di configurazione della registrazione.This procedure describes how to configure logging for new containers in a package by loading a previously saved logging configuration file.

Per impostazione predefinita, tutti i contenitori di un pacchetto utilizzano la stessa configurazione di registrazione del contenitore padre.By default, all containers in a package use the same logging configuration as their parent container. Le attività del contenitore Ciclo Foreach, ad esempio, utilizzano la stessa configurazione di registrazione del contenitore.For example, the tasks in a Foreach Loop use the same logging configuration as the Foreach Loop.

Per configurare la registrazione per un contenitoreTo configure logging for a container

  1. In SQL Server Data ToolsSQL Server Data Toolsaprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data ToolsSQL Server Data Tools, open the Integration ServicesIntegration Services project that contains the package you want.

  2. Scegliere Registrazione dal menu SSIS.On the SSIS menu, click Logging.

  3. Espandere la visualizzazione albero dei pacchetti e selezionare il contenitore da configurare.Expand the package tree view and select the container to configure.

  4. Nella scheda Provider e log selezionare i log da usare per il contenitore.On the Providers and Logs tab, select the logs to use for the container.

    Nota

    È possibile creare log solo a livello di pacchetto.You can create logs only at the package level. Per altre informazioni, vedere Abilitare la registrazione di pacchetti in SQL Server Data Tools.For more information, see Enable Package Logging in SQL Server Data Tools.

  5. Nella scheda Dettagli fare clic su Carica.Click the Details tab and click Load.

  6. Individuare il file di configurazione della registrazione desiderato e quindi fare clic su Apri.Locate the logging configuration file you want to use and click Open.

  7. Facoltativamente, selezionare una voce di log diversa selezionando la casella di controllo corrispondente nella colonna Eventi .Optionally, select a different log entry to log by selecting its check box in the Events column. Fare clic su Avanzate per selezionare il tipo di informazioni da registrare per tale voce.Click Advanced to select the type of information to log for this entry.

    Nota

    Il nuovo contenitore potrebbe includere voci di log aggiuntive non disponibili per il contenitore inizialmente utilizzato per creare la configurazione della registrazione.The new container may include additional log entries that are not available for the container originally used to create the logging configuration. Se si desidera registrare queste voci, è necessario selezionarle in modo manuale.These additional log entries must be selected manually if you want them to be logged.

  8. Per salvare la configurazione della registrazione aggiornata, fare clic su Salva.To save the updated version of the logging configuration, click Save.

  9. Per salvare il pacchetto aggiornato, scegliere Salva elementi selezionati dal menu File .To save the updated package, click Save Selected Items on the File menu.

Enable Logging for Package Execution on the SSIS Server Enable Logging for Package Execution on the SSIS Server

Questo argomento descrive come impostare o modificare il livello di registrazione per un pacchetto quando si esegue un pacchetto che è stato distribuito nel server Integration ServicesIntegration Services .This topic describes how to set or change the logging level for a package when you run a package that you have deployed to the Integration ServicesIntegration Services server. Il livello di registrazione impostato quando si esegue il pacchetto sostituisce il livello di registrazione del pacchetto configurato in fase di progettazione in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).The logging level you set when you run the package overrides the package logging you configure at design time in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Vedere Abilitare la registrazione di pacchetti in SQL Server Data Tools per altre informazioni.See Enable Package Logging in SQL Server Data Tools for more information.

In Proprietà serverdi SQL Server, nella proprietà Server logging level (Livello di registrazione del server), è possibile selezionare un livello di registrazione predefinito per l'intero server.In SQL Server Server Properties, under the Server logging level property, you can select a default server-wide logging level. È possibile scegliere uno dei livelli di registrazione predefiniti descritti in questo argomento oppure è possibile selezionare un livello di registrazione personalizzato esistente.You can pick from one of the built-in logging levels described in this topic, or you can pick an existing customized logging level. Il livello di registrazione selezionato viene applicato per impostazione predefinita a tutti i pacchetti distribuiti nel catalogo SSIS.The selected logging level applies by default to all packages deployed to the SSIS Catalog. Si applica anche per impostazione predefinita a un passaggio del processo di SQL Agent che esegue un pacchetto SSIS.It also applies by default to a SQL Agent job step that runs an SSIS package.

È anche possibile specificare il livello di registrazione per un singolo pacchetto con uno dei metodi indicati di seguito.You can also specify the logging level for an individual package by using one of the following methods. In questo argomento viene illustrato il primo metodo.This topic covers the first method.

  • Configurazione di un'istanza di esecuzione di un pacchetto tramite la finestra di dialogo Esegui pacchettoConfiguring an instance of a package execution by using the Execute Package dialog box

  • Impostazione dei parametri per un'istanza di esecuzione usando il valore catalog.set_execution_parameter_value (SSISDB Database)Setting parameters for an instance of an execution by using the catalog.set_execution_parameter_value (SSISDB Database)

  • Configurazione di un processo di SQL Server Agent per l'esecuzione di un pacchetto tramite la finestra di dialogo Nuovo passaggio di processo.Configuring a SQL Server Agent job for a package execution by using the New Job Step dialog box.

Per impostare il livello di registrazione per un pacchetto mediante la finestra di dialogo Esegui pacchettoSet the logging level for a package by using the Execute Package dialog box

  1. In SQL Server Management StudioSQL Server Management Studio, passare al pacchetto in Esplora oggetti.In SQL Server Management StudioSQL Server Management Studio, navigate to the package in Object Explorer.

  2. Fare clic con il pulsante destro del mouse sul pacchetto e selezionare Esegui.Right-click the package and select Execute.

  3. Selezionare la scheda Avanzate nella finestra di dialogo Esecuzione pacchetto .Select the Advanced tab in the Execute Package dialog box.

  4. In Livello di registrazione, selezionare il livello di registrazione.Under Logging level, select the logging level. Questo argomento contiene una descrizione dei valori disponibili.This topic contains a description of available values.

  5. Completare le eventuali altre configurazione pacchetto, quindi fare clic su OK per eseguire il pacchetto.Complete any other package configurations, then click OK to run the package.

Selezionare un livello di registrazioneSelect a logging level

Sono disponibili i livelli di registrazione predefiniti seguenti.The following built-in logging levels are available. È anche possibile selezionare un livello di registrazione personalizzato esistente.You can also select an existing customized logging level. Questo argomento contiene una descrizione dei livelli di registrazione personalizzati.This topic contains a description of customized logging levels.

Livello di registrazioneLogging Level DescriptionDescription
NessunoNone La registrazione è disabilitata.Logging is turned off. Solo lo stato dell'esecuzione del pacchetto viene registrato.Only the package execution status is logged.
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.
RuntimeLineageRuntimeLineage Raccoglie i dati necessari a tenere traccia delle informazioni di derivazione nel flusso di dati.Collects the data required to track lineage information in the data flow. È possibile analizzare queste informazioni di derivazione per mappare la relazione di derivazione tra attività.You can parse this lineage information to map the lineage relationship between tasks. Gli ISV e sviluppatori possono creare strumenti personalizzati di mapping della derivazione con queste informazioni.ISVs and developers can build custom lineage mapping tools with this information.
PrestazioniPerformance Vengono registrati solo le statistiche sulle prestazioni e gli eventi OnError e OnWarning.Only performance statistics, and OnError and OnWarning events, are logged.

Nel report Prestazioni di esecuzione vengono visualizzati il tempo di attività e il tempo totale per i componenti flusso di dati del pacchetto.The Execution Performance report displays Active Time and Total Time for package data flow components. Queste informazioni sono disponibili se il livello di registrazione dell'ultima esecuzione del pacchetto è stato impostato su Prestazioni o Dettagliato.This information is available when the logging level of the last package execution was set to Performance or Verbose. Per altre informazioni, vedere Report per il server Integration Services.For more information, see Reports for the Integration Services Server.

La vista catalog.execution_component_phases visualizza le ore di inizio e di fine per i componenti flusso di dati, per ogni fase di esecuzione.The catalog.execution_component_phases view displays the start and end times for the data flow components, for each phase of an execution. In questa vista vengono visualizzate le informazioni per i componenti solo quando il livello di registrazione dell'esecuzione del pacchetto è impostato su Prestazioni o Dettagliato.This view displays this information for these components only when the logging level of the package execution is set to Performance or Verbose.
DettagliatoVerbose 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 quelli registrati dalle attività di Integration ServicesIntegration Services .Custom events include those events that are logged by Integration ServicesIntegration Services tasks. Per altre informazioni sugli eventi personalizzati, vedere Messaggi personalizzati per la registrazione.For more information about custom events, see Custom Messages for Logging.

L'evento DiagnosticEx rappresenta un esempio di un evento di diagnostica.An example of a diagnostic event is the DiagnosticEx event. Ogni volta che un'attività Esegui pacchetto esegue un pacchetto figlio, l'evento acquisisce i valori dei parametri passati ai pacchetti figlio.Whenever an Execute Package task executes a child package, this event captures the parameter values passed to child packages.

L'evento DiagnosticEx consente inoltre di ottenere i nomi delle colonne in cui si verificano errori a livello di riga.The DiagnosticEx event also helps you to get the names of columns in which row-level errors occur. Questo evento scrive una mappa di derivazione del flusso di dati nel log.This event writes a data flow lineage map to the log. È quindi possibile cercare il nome della colonna in questa mappa di derivazione usando l'identificatore della colonna acquisito da un output degli errori.You can then look up the column name in this lineage map by using the column identifier captured by an error output. Per ulteriori informazioni, vedere Error Handling in Data.For more info, see Error Handling in Data.

Il valore della colonna di messaggio per DiagnosticEx è testo XML.The value of the message column for DiagnosticEx is XML text. Per visualizzare il testo del messaggio per l'esecuzione del pacchetto, eseguire una query nella vista catalog.operation_messages (database SSISDB).To view the message text for a package execution, query the catalog.operation_messages (SSISDB Database) view. Notare che l'evento DiagnosticEx non mantiene gli spazi vuoti nel relativo output XML per ridurre le dimensioni del log.Note that the DiagnosticEx event does not preserve whitespace in its XML output to reduce the size of the log. Per migliorare la leggibilità, copiare il log in un editor XML come Visual Studio, che supporta la formattazione XML e l'evidenziazione della sintassi.To improve readability, copy the log into an XML editor - in Visual Studio, for example - that supports XML formatting and syntax highlighting.

Nella vista catalog.execution_data_statistics viene visualizzata una riga ogni volta che un componente flusso di dati invia dati a un componente downstream, per l'esecuzione di un pacchetto.The catalog.execution_data_statistics view displays a row each time a data flow component sends data to a downstream component, for a package execution. Il livello di registrazione deve essere impostato su Dettagliato per acquisire queste informazioni nella vista.The logging level must be set to Verbose to capture this information in the view.

Creare e gestire i livelli di registrazione personalizzati con la finestra di dialogo Gestione del livello di registrazione personalizzatoCreate and manage customized logging levels by using the Customized Logging Level Management dialog box

È possibile creare livelli di registrazione personalizzati che raccolgono solo le statistiche e gli eventi desiderati.You can create customized logging levels that collect only the statistics and events that you want. Facoltativamente, è anche possibile acquisire il contesto degli eventi, che include i valori delle variabili, le stringhe di connessione e le proprietà del componente.Optionally you can also capture the context of events, which includes variable values, connection strings, and component properties. Quando si esegue un pacchetto, è possibile selezionare un livello di registrazione personalizzato in tutti i casi in cui è possibile selezionare un livello di registrazione predefinito.When you run a package, you can select a customized logging level wherever you can select a built-in logging level.

Suggerimento

Per acquisire i valori delle variabili del pacchetto, la proprietà IncludeInDebugDump delle variabili deve essere impostata su True.To capture the values of package variables, the IncludeInDebugDump property of the variables must be set to True.

  1. Per creare e gestire i livelli di registrazione personalizzati, in SQL Server Management StudioSQL Server Management Studiofare clic con il pulsante destro del mouse sul database SSISDB e scegliere Livello di registrazione personalizzato per aprire la finestra di dialogo Gestione del livello di registrazione personalizzato .To create and manage customized logging levels, in SQL Server Management StudioSQL Server Management Studio, right-click on the SSISDB database and select Customized Logging Level to open the Customized Logging Level Management dialog box. L'elenco Livelli di registrazione personalizzati contiene tutti i livelli di registrazione personalizzati esistenti.The Customized Logging Levels list contains all the existing customized logging levels.

  2. Per creare un nuovo livello di registrazione personalizzato, fare clic su Crea, quindi specificare un nome e una descrizione.To create a new customized logging level, click Create, and then provide a name and description. Nelle schede Statistiche ed Eventi selezionare le statistiche e gli eventi da raccogliere.On the Statistics and Events tabs, select the statistics and events that you want to collect. Nella scheda Eventi selezionare facoltativamente Includi contesto per singoli eventi.On the Events tab, optionally select Include Context for individual events. Fare quindi clic su Salva.Then click Save.

  3. Per aggiornare un livello di registrazione personalizzato esistente, selezionarlo nell'elenco, riconfigurarlo, quindi fare clic su Salva.To update an existing customized logging level, select it in the list, reconfigure it, and then click Save.

  4. Per eliminare un livello di registrazione personalizzato esistente, selezionarlo nell'elenco, quindi fare clic su Elimina.To delete an existing customized logging level, select it in the list, and then click Delete.

    Autorizzazioni per i livelli di registrazione personalizzati.Permissions for customized logging levels.

  • Tutti gli utenti del database SSISDB possono visualizzare i livelli di registrazione personalizzati e selezionare un livello di registrazione personalizzato quando eseguono i pacchetti.All users of the SSISDB database can see customized logging levels and select a customized logging level when they run packages.

  • Solo gli utenti nel ruolo ssis_admin o sysadmin possono creare, aggiornare o eliminare i livelli di registrazione personalizzati.Only users in the ssis_admin or sysadmin role can create, update, or delete customized logging levels.

Custom Messages for Logging Custom Messages for Logging

SQL Server Integration Services offre numerosi eventi personalizzati per la scrittura di voci di log per i pacchetti e per molte attività.SQL Server Integration Services provides a rich set of custom events for writing log entries for packages and many tasks. È possibile utilizzare tali voci per salvare informazioni dettagliate su stato di esecuzione, risultati e problemi, tramite la registrazione di eventi predefiniti o messaggi definiti dall'utente da analizzare in un secondo momento.You can use these entries to save detailed information about execution progress, results, and problems by recording predefined events or user-defined messages for later analysis. È ad esempio possibile registrare la data e l'ora di inizio e di fine di un'operazione di inserimento bulk per identificare problemi di prestazioni durante l'esecuzione del pacchetto.For example, you can record when a bulk insert begins and ends to identify performance issues when the package runs.

Le voci di log personalizzate costituiscono un set diverso da quello degli eventi di registrazione standard, disponibili per i pacchetti e per tutti i contenitori e le attività.The custom log entries are a different set of entries than the set of standard logging events that are available for packages and all containers and tasks. Le voci di log personalizzate vengono create appositamente per acquisire informazioni utili su specifiche attività di un pacchetto.The custom log entries are tailored to capture useful information about a specific task in a package. Per l'attività Esegui SQL è ad esempio disponibile una voce di log personalizzata che registra nel log l'istruzione SQL eseguita dall'attività.For example, one of the custom log entries for the Execute SQL task records the SQL statement that the task executes in the log.

Tutte le voci di log includono informazioni di data e ora, comprese le voci di log scritte automaticamente all'inizio e alla fine dell'esecuzione di un pacchetto.All log entries include date and time information, including the log entries that are automatically written when a package begins and finishes. Per molti eventi vengono scritte più voci nel log.Many of the log events write multiple entries to the log. Questo avviene in genere per gli eventi che includono varie fasi.This typically occurs when the event has different phases. Per l'evento ExecuteSQLExecutingQuery , ad esempio, vengono scritte tre voci di log: una dopo l'acquisizione di una connessione al database da parte dell'attività, una dopo l'inizio della preparazione dell'istruzione SQL da parte dell'attività e un'altra al termine dell'esecuzione dell'istruzione SQL.For example, the ExecuteSQLExecutingQuery log event writes three entries: one entry after the task acquires a connection to the database, another after the task starts to prepare the SQL statement, and one more after the execution of the SQL statement is completed.

Sono disponibili voci di log personalizzate per gli oggetti Integration ServicesIntegration Services seguenti:The following Integration ServicesIntegration Services objects have custom log entries:

PacchettoPackage

Attività Inserimento bulkBulk Insert Task

Attività Flusso di datiData Flow Task

Attività Esegui pacchetto DTS 2000Execute DTS 2000 Task

Attività Esegui processoExecute Process Task

Attività Esegui SQLExecute SQL Task

Attività File systemFile System Task

Attività FTPFTP Task

Attività Message QueueMessage Queue Task

Attività ScriptScript Task

Attività Invia messaggiSend Mail Task

Attività Trasferisci databaseTransfer Database Task

Attività Trasferisci messaggi di erroreTransfer Error Messages Task

Attività Trasferisci processiTransfer Jobs Task

Attività Trasferisci account di accessoTransfer Logins Task

Attività Trasferisci stored procedure masterTransfer Master Stored Procedures Task

Attività Trasferisci oggetti di SQL ServerTransfer SQL Server Objects Task

Attività Servizio WebWeb Services Task

Attività Lettore di dati WMIWMI Data Reader Task

Attività Monitoraggio eventi WMIWMI Event Watcher Task

Attività XMLXML Task

Voci di logLog Entries

Pacchetto Package

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per i pacchetti.The following table lists the custom log entries for packages.

Voce di logLog entry DescriptionDescription
PackageStartPackageStart Indica che l'esecuzione del pacchetto è iniziata.Indicates that the package began to run. Questa voce di log viene scritta automaticamente nel logThis log entry is automatically written to the log. e non può essere esclusa.You cannot exclude it.
Fine pacchettoPackageEnd Indica che l'esecuzione del pacchetto è stata completata.Indicates that the package completed. Questa voce di log viene scritta automaticamente nel logThis log entry is automatically written to the log. e non può essere esclusa.You cannot exclude it.
DiagnosticDiagnostic Offre informazioni sulla configurazione del sistema che influisce sull'esecuzione dei pacchetti, ad esempio il numero di file eseguibili che è possibile eseguire simultaneamente.Provides information about the system configuration that affects package execution such as the number executables that can be run concurrently.

La voce di log Diagnostic include anche le voci precedenti e seguenti alle chiamate a provider di dati esterni.The Diagnostic log entry also includes before and after entries for calls to external data providers.

Attività Inserimento bulk Bulk Insert Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Inserimento bulk.The following table lists the custom log entries for the Bulk Insert task.

Voce di logLog entry DescriptionDescription
DTSBulkInsertTaskBeginDTSBulkInsertTaskBegin Indica che l'inserimento bulk è iniziato.Indicates that the bulk insert began.
DTSBulkInsertTaskEndDTSBulkInsertTaskEnd Indica che l'inserimento bulk è terminato.Indicates that the bulk insert finished.
DTSBulkInsertTaskInfosDTSBulkInsertTaskInfos Offre informazioni descrittive sull'attività.Provides descriptive information about the task.

Attività Flusso di dati Data Flow Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Flusso di dati.The following table lists the custom log entries for the Data Flow task.

Voce di logLog entry DescriptionDescription
BufferSizeTuningBufferSizeTuning Indica che l'attività Flusso di dati ha modificato le dimensioni del buffer.Indicates that the Data Flow task changed the size of the buffer. In questa voce di log vengono indicati i motivi della modifica delle dimensioni del buffer e le nuove dimensioni temporanee del buffer.The log entry describes the reasons for the size change and lists the temporary new buffer size.
OnPipelinePostEndOfRowsetOnPipelinePostEndOfRowset Indica che a un componente è stato inviato il segnale di fine del set di righe, che viene impostato dall'ultima chiamata al metodo ProcessInput .Denotes that a component has been given its end-of-rowset signal, which is set by the last call of the ProcessInput method. Viene scritta una voce per ogni componente del flusso di dati che elabora dati di input.An entry is written for each component in the data flow that processes input. Tale voce include il nome del componente.The entry includes the name of the component.
OnPipelinePostPrimeOutputOnPipelinePostPrimeOutput Indica che il componente ha completato l'ultima chiamata al metodo PrimeOutput .Indicates that the component has completed its last call to the PrimeOutput method. A seconda del flusso di dati, è possibile che vengano scritte più voci di log.Depending on the data flow, multiple log entries may be written. Se il componente è un'origine, indica che tale componente ha terminato l'elaborazione delle righe.If the component is a source, this means that the component has finished processing rows.
OnPipelinePreEndOfRowsetOnPipelinePreEndOfRowset Indica che un componente sta per ricevere il segnale di fine del set di righe, che viene impostato dall'ultima chiamata al metodo ProcessInput .Indicates that a component is about to receive its end-of-rowset signal, which is set by the last call of the ProcessInput method. Viene scritta una voce per ogni componente del flusso di dati che elabora dati di input.An entry is written for each component in the data flow that processes input. Tale voce include il nome del componente.The entry includes the name of the component.
OnPipelinePrePrimeOutputOnPipelinePrePrimeOutput Indica che il componente sta per ricevere una chiamata dal metodo PrimeOutput .Indicates that the component is about to receive its call from the PrimeOutput method. A seconda del flusso di dati, è possibile che vengano scritte più voci di log.Depending on the data flow, multiple log entries may be written.
OnPipelineRowsSentOnPipelineRowsSent Specifica il numero delle righe inviate all'input di un componente da una chiamata al metodo ProcessInput .Reports the number of rows provided to a component input by a call to the ProcessInput method. La voce di log include il nome del componente.The log entry includes the component name.
PipelineBufferLeakPipelineBufferLeak Fornisce informazioni su tutti i componenti che hanno mantenuto attivi i buffer dopo la chiusura di Gestione buffer.Provides information about any component that kept buffers alive after the buffer manager goes away. Questo significa che le risorse dei buffer non sono state rilasciate e potrebbero verificarsi perdite di memoria.This means that buffers resources were not released and may cause memory leaks. Nella voce di log vengono indicati il nome del componente e l'ID del buffer.The log entry provides the name of the component and the ID of the buffer.
PipelineExecutionPlanPipelineExecutionPlan Specifica il piano di esecuzione del flusso di dati.Reports the execution plan of the data flow. Fornisce informazioni sulle modalità di invio dei buffer ai componenti.It provides information about how buffers will be sent to components. Insieme alla voce PipelineExecutionTrees, queste informazioni illustrano ciò che avviene nell'ambito dell'attività.This information, in combination with the PipelineExecutionTrees entry, describes what is occurring in the task.
PipelineExecutionTreesPipelineExecutionTrees Specifica gli alberi di esecuzione del layout nel flusso di dati.Reports the execution trees of the layout in the data flow. L'utilità di pianificazione del motore flusso di dati utilizza tali alberi per compilare il piano di esecuzione del flusso di dati.The scheduler of the data flow engine use the trees to build the execution plan of the data flow.
PipelineInitializationPipelineInitialization Fornisce le informazioni di inizializzazione relative all'attività,Provides initialization information about the task. che includono le directory da utilizzare per l'archiviazione temporanea dei dati BLOB, le dimensioni predefinite del buffer e il numero di righe in un buffer.This information includes the directories to use for temporary storage of BLOB data, the default buffer size, and the number of rows in a buffer. A seconda della configurazione dell'attività Flusso di dati, è possibile che vengano scritte più voci di log.Depending on the configuration of the Data Flow task, multiple log entries may be written.

Attività Esegui pacchetto DTS 2000 Execute DTS 2000 Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Esegui pacchetto DTS 2000.The following table lists the custom log entries for the Execute DTS 2000 task.

Voce di logLog entry DescriptionDescription
ExecuteDTS80PackageTaskBeginExecuteDTS80PackageTaskBegin Indica che l'attività ha iniziato a eseguire un pacchetto DTS 2000.Indicates that the task began to run a DTS 2000 package.
ExecuteDTS80PackageTaskEndExecuteDTS80PackageTaskEnd Indica che l'attività è terminata.Indicates that the task finished.

Nota: l'esecuzione del pacchetto DTS 2000 può continuare anche dopo il termine dell'attività.Note: The DTS 2000 package may continue to run after the task ends.
ExecuteDTS80PackageTaskTaskInfoExecuteDTS80PackageTaskTaskInfo Offre informazioni descrittive sull'attività.Provides descriptive information about the task.
ExecuteDTS80PackageTaskTaskResultExecuteDTS80PackageTaskTaskResult Restituisce il risultato dell'esecuzione del pacchetto DTS 2000 eseguito dall'attività.Reports the execution result of the DTS 2000 package that the task ran.

Attività Esegui processo Execute Process Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Esegui processo.The following table lists the custom log entries for the Execute Process task.

Voce di logLog entry DescriptionDescription
ExecuteProcessExecutingProcessExecuteProcessExecutingProcess Fornisce informazioni sul processo di esecuzione del file eseguibile che l'attività dovrà eseguire.Provides information about the process of running the executable that the task is configured to run.

Vengono scritte due voci di log.Two log entries are written. Una contiene informazioni sul nome e la posizione del file eseguibile eseguito dall'attività, l'altra registra l'uscita dall'eseguibile.One contains information about the name and location of the executable that the task runs, and the other records the exit from the executable.
ExecuteProcessVariableRoutingExecuteProcessVariableRouting Fornisce informazioni sulle variabili indirizzate all'input e agli output del file eseguibile.Provides information about which variables are routed to the input and outputs of the executable. Vengono scritte voci di log per stdin (l'input), stdout (l'output) e stderr (l'output degli errori).Log entries are written for stdin (the input), stdout (the output), and stderr (the error output).

Attività Esegui SQL Execute SQL Task

Nella tabella seguente è indicata la voce di log personalizzata disponibile per l'attività Esegui SQL.The following table describes the custom log entry for the Execute SQL task.

Voce di logLog entry DescriptionDescription
ExecuteSQLExecutingQueryExecuteSQLExecutingQuery Fornisce informazioni sulle fasi di esecuzione dell'istruzione SQL.Provides information about the execution phases of the SQL statement. Vengono scritte voci di log quando l'attività acquisisce la connessione al database, quando inizia a preparare l'istruzione SQL e al termine dell'esecuzione dell'istruzione SQL.Log entries are written when the task acquires connection to the database, when the task starts to prepare the SQL statement, and after the execution of the SQL statement is completed. La voce di log per la fase di preparazione include l'istruzione SQL utilizzata dall'attività.The log entry for the prepare phase includes the SQL statement that the task uses.

Attività File system File System Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività File system.The following table describes the custom log entry for the File System task.

Voce di logLog entry DescriptionDescription
FileSystemOperationFileSystemOperation Indica l'operazione eseguita dall'attività.Reports the operation that the task performs. Questa voce di log viene scritta all'inizio dell'operazione sul file system e include informazioni sull'origine e sulla destinazione.The log entry is written when the file system operation starts and includes information about the source and destination.

Attività FTP FTP Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività FTP.The following table lists the custom log entries for the FTP task.

Voce di logLog entry DescriptionDescription
FTPConnectingToServerFTPConnectingToServer Indica che l'attività ha stabilito una connessione al server FTP.Indicates that the task initiated a connection to the FTP server.
FTPOperationFTPOperation Specifica l'inizio e il tipo dell'operazione FTP eseguita dall'attività.Reports the beginning of and the type of FTP operation that the task performs.

Attività Message Queue Message Queue Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Message Queue.The following table lists the custom log entries for the Message Queue task.

Voce di logLog entry DescriptionDescription
MSMQAfterOpenMSMQAfterOpen Indica che l'attività ha terminato l'apertura della coda di messaggi.Indicates that the task finished opening the message queue.
MSMQBeforeOpenMSMQBeforeOpen Indica che l'attività ha iniziato ad aprire la coda di messaggi.Indicates that the task began to open the message queue.
MSMQBeginReceiveMSMQBeginReceive Indica che l'attività ha iniziato a ricevere un messaggio.Indicates that the task began to receive a message.
MSMQBeginSendMSMQBeginSend Indica che l'attività ha iniziato a inviare un messaggio.Indicates that the task began to send a message.
MSMQEndReceiveMSMQEndReceive Indica che l'attività ha terminato la ricezione di un messaggio.Indicates that the task finished receiving a message.
MSMQEndSendMSMQEndSend Indica che l'attività ha terminato l'invio di un messaggio.Indicates that the task finished sending a message
MSMQTaskInfoMSMQTaskInfo Offre informazioni descrittive sull'attività.Provides descriptive information about the task.
MSMQTaskTimeOutMSMQTaskTimeOut Indica che si è verificato il timeout dell'attività.Indicates that the task timed out.

Attività Script Script Task

Nella tabella seguente è indicata la voce di log personalizzata disponibile per l'attività Script.The following table describes the custom log entry for the Script task.

Voce di logLog entry DescriptionDescription
ScriptTaskLogEntryScriptTaskLogEntry Restituisce i risultati dell'implementazione della registrazione nell'ambito dello script.Reports the results of implementing logging in the script. Viene scritta una voce di log per ogni chiamata al metodo Log dell'oggetto Dts .A log entry is written for each call to the Log method of the Dts object. Tale voce viene scritta al momento dell'esecuzione del codice.The entry is written when the code is run. Per altre informazioni, vedere Registrazione nell'attività Script.For more information, see Logging in the Script Task.

Attività Invia messaggi Send Mail Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Invia messaggi.The following table lists the custom log entries for the Send Mail task.

Voce di logLog entry DescriptionDescription
SendMailTaskBeginSendMailTaskBegin Indica che l'attività ha iniziato a inviare un messaggio di posta elettronica.Indicates that the task began to send an e-mail message.
SendMailTaskEndSendMailTaskEnd Indica che l'attività ha terminato l'invio di un messaggio di posta elettronica.Indicates that the task finished sending an e-mail message.
SendMailTaskInfoSendMailTaskInfo Offre informazioni descrittive sull'attività.Provides descriptive information about the task.

Attività Trasferisci database Transfer Database Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Trasferisci database.The following table lists the custom log entries for the Transfer Database task.

Voce di logLog entry DescriptionDescription
SourceDBSourceDB Specifica il database copiato dall'attività.Specifies the database that the task copied.
SourceSQLServerSourceSQLServer Specifica il computer da cui è stato copiato il database.Specifies the computer from which the database was copied.

Attività Trasferisci messaggi di errore Transfer Error Messages Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Trasferisci messaggi di errore.The following table lists the custom log entries for the Transfer Error Messages task.

Voce di logLog entry DescriptionDescription
TransferErrorMessagesTaskFinishedTransferringObjectsTransferErrorMessagesTaskFinishedTransferringObjects Indica che l'attività ha terminato il trasferimento dei messaggi di errore.Indicates that the task finished transferring error messages.
TransferErrorMessagesTaskStartTransferringObjectsTransferErrorMessagesTaskStartTransferringObjects Indica che l'attività ha iniziato a trasferire messaggi di errore.Indicates that the task started to transfer error messages.

Attività Trasferisci processi Transfer Jobs Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Trasferisci processi.The following table lists the custom log entries for the Transfer Jobs task.

Voce di logLog entry DescriptionDescription
TransferJobsTaskFinishedTransferringObjectsTransferJobsTaskFinishedTransferringObjects Indica che l'attività ha terminato il trasferimento dei processi di SQL ServerSQL Server Agent.Indicates that the task finished transferring SQL ServerSQL Server Agent jobs.
TransferJobsTaskStartTransferringObjectsTransferJobsTaskStartTransferringObjects Indica che l'attività ha iniziato a trasferire processi di SQL ServerSQL Server Agent.Indicates that the task started to transfer SQL ServerSQL Server Agent jobs.

Attività Trasferisci account di accesso Transfer Logins Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Trasferisci account di accesso.The following table lists the custom log entries for the Transfer Logins task.

Voce di logLog entry DescriptionDescription
TransferLoginsTaskFinishedTransferringObjectsTransferLoginsTaskFinishedTransferringObjects Indica che l'attività ha terminato il trasferimento degli account di accesso.Indicates that the task finished transferring logins.
TransferLoginsTaskStartTransferringObjectsTransferLoginsTaskStartTransferringObjects Indica che l'attività ha iniziato a trasferire account di accesso.Indicates that the task started to transfer logins.

Attività Trasferisci stored procedure master Transfer Master Stored Procedures Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Trasferisci stored procedure master.The following table lists the custom log entries for the Transfer Master Stored Procedures task.

Voce di logLog entry DescriptionDescription
TransferStoredProceduresTaskFinishedTransferringObjectsTransferStoredProceduresTaskFinishedTransferringObjects Indica che l'attività ha terminato il trasferimento delle stored procedure definite dall'utente archiviate nel database master .Indicates that the task finished transferring user-defined stored procedures that are stored in the master database.
TransferStoredProceduresTaskStartTransferringObjectsTransferStoredProceduresTaskStartTransferringObjects Indica che l'attività ha iniziato a trasferire le stored procedure definite dall'utente archiviate nel database master .Indicates that the task started to transfer user-defined stored procedures that are stored in the master database.

Attività Trasferisci oggetti di SQL Server Transfer SQL Server Objects Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Trasferisci oggetti di SQL ServerSQL Server .The following table lists the custom log entries for the Transfer SQL ServerSQL Server Objects task.

Voce di logLog entry DescriptionDescription
TransferSqlServerObjectsTaskFinishedTransferringObjectsTransferSqlServerObjectsTaskFinishedTransferringObjects Indica che l'attività ha terminato il trasferimento degli oggetti di database di SQL ServerSQL Server .Indicates that the task finished transferring SQL ServerSQL Server database objects.
TransferSqlServerObjectsTaskStartTransferringObjectsTransferSqlServerObjectsTaskStartTransferringObjects Indica che l'attività ha iniziato a trasferire oggetti di database di SQL ServerSQL Server .Indicates that the task started to transfer SQL ServerSQL Server database objects.

Attività Servizio Web Web Services Task

Nella tabella seguente sono elencate le voci di log personalizzate che è possibile abilitare per l'attività Servizio Web.The following table lists the custom log entries that you can enable for the Web Services task.

Voce di logLog entry DescriptionDescription
WSTaskBeginWSTaskBegin Indica che l'attività ha iniziato ad accedere a un servizio Web.The task began to access a Web service.
WSTaskEndWSTaskEnd Indica che l'attività ha completato un metodo per il servizio Web.The task completed a Web service method.
WSTaskInfoWSTaskInfo Offre informazioni descrittive sull'attività.Descriptive information about the task.

Attività Lettore di dati WMI WMI Data Reader Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Lettore di dati WMI.The following table lists the custom log entries for the WMI Data Reader task.

Voce di logLog entry DescriptionDescription
WMIDataReaderGettingWMIDataWMIDataReaderGettingWMIData Indica che l'attività ha iniziato a leggere dati WMI.Indicates that the task began to read WMI data.
WMIDataReaderOperationWMIDataReaderOperation Specifica la query WQL eseguita dall'attività.Reports the WQL query that the task ran.

Attività Monitoraggio eventi WMI WMI Event Watcher Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Monitoraggio eventi WMI.The following table lists the custom log entries for the WMI Event Watcher task.

Voce di logLog entry DescriptionDescription
WMIEventWatcherEventOccurredWMIEventWatcherEventOccurred Indica che l'evento monitorato dall'attività si è verificato.Denotes that the event occurred that the task was monitoring.
WMIEventWatcherTimedoutWMIEventWatcherTimedout Indica che si è verificato il timeout dell'attività.Indicates that the task timed out.
WMIEventWatcherWatchingForWMIEventsWMIEventWatcherWatchingForWMIEvents Indica che l'attività ha iniziato a eseguire la query WQL.Indicates that the task began to execute the WQL query. La voce include la query.The entry includes the query.

Attività XML XML Task

Nella tabella seguente è indicata la voce di log personalizzata disponibile per l'attività XML.The following table describes the custom log entry for the XML task.

Voce di logLog entry DescriptionDescription
XMLOperationXMLOperation Fornisce informazioni sull'operazione eseguita dall'attività.Provides information about the operation that the task performs

Nell'elenco seguente sono contenuti collegamenti ad argomenti che illustrano come eseguire attività correlate alla funzionalità di registrazione.The following list contains links to topics that show how to perform tasks related to the logging feature.

Strumento DTLoggedExec per la registrazione completa e dettagliata (progetto CodePlex)DTLoggedExec Tool for Full and Detail Logging (CodePlex Project)