Włączanie rejestrowania programowe

The run-time engine provides a collection of LogProvider objects that enable event-specific information to be captured during package validation and execution.LogProvider objects are available to DtsContainer objects, including the TaskHost, Package, ForLoop, and ForEachLoop objects.Rejestrowanie jest włączone w poszczególnych pojemników lub całego pakiet.

Istnieje kilka typów dziennika dostawców, którzy są dostępni dla kontener użyć.Zapewnia to możliwość tworzenia i przechowywania informacji dziennika w wielu formatach.Rejestrowanie obiektu kontener podczas rejestrowania jest procesem dwuetapowym: najpierw rejestrowanie jest włączone, a następnie wybrano dostawca dziennika. The LoggingOptions() and LoggingMode() properties of the kontener are used to specify the logged events and to select the dostawca dziennika.

Włączanie rejestrowania

The LoggingMode() właściwość, found in each kontener that can perform logging, determines whether the kontener's zdarzenie information is recorded to the zdarzenie log. Ta właściwość jest przypisywana wartość z DTSLoggingMode struktury i jest dziedziczone z kontener nadrzędnego domyślnie. Jeśli pojemnik jest pakiet, w związku z tym ma nadrzędny nie korzysta z właściwość UseParentSetting(), które domyślnie Disabled.

Zaznaczenie dostawca dziennika

Po LoggingMode() Właściwość jest zestaw do Enabled, dostawca dziennika jest dodawany do SelectedLogProviders Kolekcja kontener, aby zakończyć proces. The SelectedLogProviders kolekcja is available on the LoggingOptions object, and contains the log providers selected for the kontener. The Add(LogProvider) metoda is called to create a dostawca and add it to the kolekcja. Metoda zwraca dostawca dziennika, który został dodany do kolekcja.Każdy dostawca ma ustawienia konfiguracja, które są unikatowe dla tego dostawcy, a te właściwości są ustawiane przy użyciu ConfigString() Właściwość.

W poniższej tabela przedstawiono dostępne włączeni, ich opis, a ich ConfigString() informacje.

Dostawca	Description	Właściwość Ciąg_konfiguracji
SQL Server Profiler	Generuje ślady SQL, które mogą być przechwycone i wyświetlać w SQL Server Profiler. Domyślne rozszerzenie nazwy pliku dla tego dostawca jest .trc.	Konfiguracja nie jest wymagane.
SQL Server	Zapisuje zdarzenie wpisy do dziennika sysssislog wszelkie tabelaSQL Server Baza danych.	SQL Server Dostawca wymaga określenia połączenia z bazą danych, a także nazwa bazy danych na obiekt miejsce docelowe.
Plik tekstowy	Zapisuje zdarzenie rejestrować wpisy do plików tekstowych ASCII w formacie wartości rozdzielanych przecinkami (CSV).To domyślne rozszerzenie nazwy pliku dla tego dostawca. dziennika.	Nazwa pliku menedżer połączeń.
Dziennik zdarzenie systemu Windows	Loguje użytkownika do systemu Windows zdarzenie dziennika na komputerze lokalnym w dzienniku aplikacji.	Konfiguracja nie jest wymagane.
Plik XML	Zapisuje zdarzenie pliku w formacie wpisów dziennika do formatu XML.XML jest domyślne rozszerzenie nazwy pliku dla tego dostawca.	Nazwa pliku menedżer połączeń.

zdarzenie są zawarte w lub wykluczone z dziennika zdarzeń, ustawiając EventFilterKind oraz EventFilter Właściwości kontener. The EventFilterKind structure contains two values, ExclusionFilter and InclusionFilter, that indicate whether the events that are added to the EventFilter are included in the zdarzenie log. The EventFilter właściwość is then assigned a ciąg array that contains the names of the events that are the subject of the filtering.

Poniższy kod umożliwia rejestrowanie na opakowaniu, dodaje dostawca dziennika, pliki tekstowe się SelectedLogProviders Kolekcja i określa listę zdarzeń, które mają zostać uwzględnione w danych wyjściowych rejestrowania.

Przykład

using System;
using Microsoft.SqlServer.Dts.Runtime;

namespace Microsoft.SqlServer.Dts.Samples
{
  class Program
  {
    static void Main(string[] args)
    {
      Package p = new Package();

      ConnectionManager loggingConnection = p.Connections.Add("FILE");
      loggingConnection.ConnectionString = @"C:\SSISPackageLog.txt";

      LogProvider provider = p.LogProviders.Add("DTS.LogProviderTextFile.2");
      provider.ConfigString = loggingConnection.Name;
      p.LoggingOptions.SelectedLogProviders.Add(provider);
      p.LoggingOptions.EventFilterKind = DTSEventFilterKind.Inclusion;
      p.LoggingOptions.EventFilter = new String[] { "OnPreExecute", 
         "OnPostExecute", "OnError", "OnWarning", "OnInformation" };
      p.LoggingMode = DTSLoggingMode.Enabled;

      // Add tasks and other objects to the package.

    }
  }
}

Imports Microsoft.SqlServer.Dts.Runtime

Module Module1

  Sub Main()

    Dim p As Package = New Package()

    Dim loggingConnection As ConnectionManager = p.Connections.Add("FILE")
    loggingConnection.ConnectionString = "C:\SSISPackageLog.txt"

    Dim provider As LogProvider = p.LogProviders.Add("DTS.LogProviderTextFile.2")
    provider.ConfigString = loggingConnection.Name
    p.LoggingOptions.SelectedLogProviders.Add(provider)
    p.LoggingOptions.EventFilterKind = DTSEventFilterKind.Inclusion
    p.LoggingOptions.EventFilter = New String() {"OnPreExecute", _
       "OnPostExecute", "OnError", "OnWarning", "OnInformation"}
    p.LoggingMode = DTSLoggingMode.Enabled

    ' Add tasks and other objects to the package.

  End Sub

End Module

Konfiguracja w aktualizacji z usług integracja Services pobytu Najnowsze pliki do pobrania, artykuły, próbki, i pliki wideo firmy Microsoft, jak również wybranego rozwiązania od Wspólnoty, odwiedź witrynę Integration Services strona w witrynie MSDN lub TechNet: Odwiedź strona usług integracja Services w witrynie MSDN Odwiedź strona usług integracja Services w witrynie TechNet Automatycznego powiadomienie tych aktualizacji należy subskrybować źródła danych RSS, które jest dostępne strona.

See Also

Other Resources

Integracja usług dziennika dostawcy

Wykonania rejestrowania w pakietach