Udostępnij za pośrednictwem

  • Artykuł

Tworzenie niestandardowego dostawca dziennika

The Integration Services run-czas environment has extensive logging capabilities. A log lets you capture events that occur during package execution.Integration Services includes a variety of log providers that enable logs to be created and stored in multiple formats, such as XML, text, database, or in the Windows event log.Jeśli jeden z tych dostawców lub formatów wyjściowych nie mieści się potrzeb, można utworzyć dostawca dziennika niestandardowego.

Etapy tworzenia dostawca dziennika niestandardowe są podobne do czynności tworzenia innych obiektów niestandardowych dla Integration Services:

  • Utwórz nową klasę, która dziedziczy z klasy podstawowej.W przypadku dostawca dziennika jest klasa podstawowa LogProviderBase.

  • Zastosuj atrybut określający typ obiektu do klasy.Aby dostawca dziennika, atrybut jest DtsLogProviderAttribute.

  • Zastąpić stosowania właściwości i metod klasy podstawowej.dostawca dzienników, należą do nich ConfigString() Właściwość oraz OpenLog(), Log(String, String, String, String, String, String, String, DateTime, DateTime, Int32, array<Byte[]), a CloseLog() metody.

  • Custom user interfaces for custom log providers are not implemented in SQL Server Integration Services.

Aby próbek pracy włączeni niestandardowych zobacz HtmlLogProvider Sample i EmailLogProvider Sample.

Wprowadzenie do korzystania z dostawca dziennika niestandardowego

Tworzenie projektów i klasy

Ponieważ wszystkie zarządzane włączeni dziedziczyć LogProviderBase Klasa podstawowa, pierwszym krokiem przy tworzeniu dostawca dziennika niestandardowego jest tworzenie projektu biblioteki klas w sieci preferowanych zarządzana w języku programowania, a następnie Utwórz klasę, która dziedziczy po klasie podstawowej. W tej klasie pochodnej zastąpią metodami i właściwościami klasy podstawowej do zaimplementowania sieci niestandardowe funkcje.

Konfigurowanie projektu do podpisywania wirtualny plik dziennika, który zostanie wygenerowany w pliku klucz silnej nazwy.

Uwaga

Wiele Integration Services włączeni mieć implementujące interfejs użytkownika niestandardowego IDtsLogProviderUI i zastępuje Konfiguracja pola tekstowegoKonfigurowanie dzienników SSIS okno dialogowe z listy filtrowanej listy rozwijanej menedżerów dostępnego połączenia.Jednak interfejsów użytkownika niestandardowego dla dostawców dzienników niestandardowe nie zostały zaimplementowane w Integration Services.

Stosowanie atrybut DtsLogProvider

Zastosowanie DtsLogProviderAttribute atrybut do klasy, utworzony w celu identyfikacji jako dostawca dziennika. Ten atrybut zawiera informacje czas projektowania, takie jak nazwa i opis dostawca dziennika.The DisplayName and Description properties of the atrybut correspond to the Name and Description columns displayed in the Configure SSIS Logs editor, which is displayed when configuring logging for a pakiet in Business Intelligence Development Studio.

Important noteImportant Note:

The LogProviderType() właściwość of the atrybut is not used. Jednak należy wprowadzić wartość dla niego lub dostawca dziennika niestandardowego nie pojawi się na liście dostępnych włączeni.

Uwaga

Ponieważ interfejsy użytkownika niestandardowego dla dostawców dzienników niestandardowe nie zostały zaimplementowane w Integration Services, podanie wartości UITypeName() Właściwość DtsLogProviderAttribute nie ma znaczenia.

<DtsLogProvider(DisplayName:="MyLogProvider", Description:="A simple log provider.", LogProviderType:="Custom")> _
Public Class MyLogProvider
     Inherits LogProviderBase
    ' TODO: Override the base class methods.
End Class

[DtsLogProvider(DisplayName="MyLogProvider", Description="A simple log provider.", LogProviderType="Custom")]
public class MyLogProvider : LogProviderBase
{
    // TODO: Override the base class methods.
}

Budowanie, wdrażanie i debugowanie dostawca dziennika niestandardowego

Kroki prowadzące do budowania, wdrażania i debugowanie dostawca dziennika niestandardowego w Integration Services są bardzo podobne do czynności wymagane w przypadku innych typów obiektów niestandardowych. Aby uzyskać więcej informacji zobaczBudowanie, wdrażanie i debugowanie obiekty niestandardowe.

Integration Services icon (small) 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:

Automatycznego powiadomienie tych aktualizacji należy subskrybować źródła danych RSS, które jest dostępne strona.