Udostępnij za pośrednictwem

  • Artykuł

Implementowanie rejestrowania w opakowaniach

Integration Services zawiera funkcje rejestrowania tworzyć wpisy w dzienniku uruchomienia-czas zdarzenia występują i można również zapisać niestandardowe komunikaty.

Integration Services obsługuje zestaw włączeni i daje możliwość tworzenia niestandardowych włączeni. Integration Services Dostawców dzienników można napisać wpisów dziennika do plików tekstowych, SQL Server Profiler, SQL Server, dziennik zdarzeń systemu Windows lub XML pliki.

Dzienniki są skojarzone z pakietami i są konfigurowane poziom pakiet.Każdego zadania lub kontener w pakiecie może rejestrować informacje dziennika każdy pakiet.Zadania i pojemniki w pakiecie można włączyć rejestrowania, nawet jeśli nie jest sam pakiet.Na przykład można włączyć rejestrowanie dla zadania wykonanie instrukcji SQL bez włączania rejestrowania pakiet nadrzędnej.Pakiet, kontener, lub zadania można zapisać wiele dzienników.Można włączyć rejestrowanie na tylko pakiet lub możesz włączyć rejestrowanie dla poszczególnych zadań ani kontener, który zawiera pakiet.

Aby dostosować rejestrowanie zdarzenie lub niestandardowy komunikat Integration Services zawiera schemat powszechnie zarejestrowane informacje mają zostać uwzględnione w pozycji dziennika. Integration Services Dziennika schemat definiuje informacje można możnaMożna wybrać elementy ze schematu dziennika dla każdego wpisu do dziennika.

Pakiet i jego konteners i zadania nie trzeba rejestrować takie same informacje i zadań w tym samym opakowaniu lub kontener może rejestrować różne informacje.Na przykład pakiet może rejestrować informacje operator podczas uruchamiania pakietu, jednego zadania można rejestrować źródło błędu zadania i innego zadania może rejestrować informacje, jeśli wystąpią błędy.Pakiet i jego kontenerów i zadania korzystania z wielu dzienników, te same informacje są zapisywane wszystkie dzienniki.

Można wybrać poziom rejestrowania, który odpowiada potrzebom określając zdarzenie do dziennika i informacje dziennika dla każdego zdarzenie.Może się okazać, że niektóre zdarzenia zapewniają bardziej przydatnych informacji niż inne.Na przykład, można rejestrować tylko nazwy komputera i operator dla PreExecute zdarzenie , ale wszelkie dostępne informacje dotyczące o zdarzenie.

Aby uniemożliwić korzystanie z dużej ilości miejsca na dysku przez pliki dziennika lub w celu uniknięcia nadmiernego rejestrowania, które mogłyby obniżyć wydajność, można ograniczyć rejestrowania, wybierając określone zdarzenia i elementy informacji logowania.Na przykład można skonfigurować dziennika do przechwytywania tylko data i nazwę komputera dla każdego błędu.

W SSIS Designer, można zdefiniować opcje rejestrowania przy użyciu Konfigurowanie dzienników SSIS okno dialogowe.

Schemat dziennika

W poniższej tabela opisano elementy w schemacie dziennika.

Element

Opis

Komputer

Nazwa komputera, na którym wystąpiło zdarzenie dziennika.

Operator

Tożsamość użytkownika, który uruchomił pakiet.

NazwaObiektu

Nazwa kontener lub zadanie, w którym wystąpiło zdarzenie dziennika.

Element SourceID

Identyfikator unikatowy pakiet; Dla pętli, pętla Foreach lub sekwencji kontener; lub zadanie, w którym wystąpiło zdarzenie dziennika.

ExecutionID

Identyfikator GUID wystąpienie wykonanie pakiet.

UwagaUwaga:
Uruchomiony jeden pakiet może tworzyć wpisy dziennika z różnymi wartościami dla elementu ExecutionID.Na przykład po uruchomieniu pakiet BI Development Studio, fazy sprawdzania poprawności może tworzyć wpisy dziennika z elementu ExecutionID, który odpowiada BI Development Studio.Faza wykonania może jednak tworzyć wpisy dziennika z elementu ExecutionID, który odpowiada dtshost.exe.Inny przykład uruchom pakiet, który zawiera pakiet wykonywanie zadań każdego z tych zadań uruchamia pakiet podrzędność.Te pakiety podrzędność może utworzyć wpisów dziennika, które mają inny element ExecutionID niż wpisy dziennika, które tworzy pakiet nadrzędny.

MessageText

Wiadomości związane z wpisu dziennika.

DataBytes

Tablica bajtów określonego wpisu dziennika.Znaczenie tego pole zależy od wpisu dziennika.

W poniższej tabela opisano trzy dodatkowe elementami w schemacie dziennika, które nie są dostępne na Szczegóły karcie Konfigurowanie dzienników SSIS okno dialogowe.

Element

Opis

Godzina rozpoczęcia

Czas, w którym kontener lub zadania uruchamiania.

GodzinaZakończenia

Czas, w którym kontener lub zadanie przestanie działać.

DataCode

Opcjonalne całkowitą, który zwykle zawiera wartość z DTSExecResult Wyliczenie wskazujący wynik pracy kontener lub zadania:

  • 0 - Sukces

  • 1 - Niepowodzenie.

  • 2 - Zakończone

  • 3 - Anulowane

Wpisy dziennika

Integration Servicesobsługuje wpisy dziennika zdarzeń wstępnie zdefiniowanych i zawiera wiele wpisów dziennika niestandardowego Integration Services obiektów.Konfigurowanie dzienników SSIS okno dialogowe w SSIS Projektant wyświetla listę tych zdarzeń i wpisy dziennika niestandardowego.

W poniższej tabela opisano wstępnie zdefiniowanych zdarzeń, które mogą być włączone do zapisu podczas uruchamiania wpisy dziennika-czas zdarzenia.Zastosowanie tych wpisów dziennika do plików wykonywalnych, pakiet, zadań i pojemniki, które zawiera pakiet.Nazwa wpisu dziennika jest taka sama, jak nazwa run -czas zdarzenie wywoływane i spowodował wpis dziennika są zapisywane.

Zdarzenia

Opis

OnError

Zapisuje wpis dziennika, gdy wystąpi błąd.

OnExecStatusChanged

Zapisuje wpis dziennika, gdy stan wykonania zmian pliku wykonywalnego.

OnInformation

Zapisuje informacje o raporcie wpis dziennika podczas sprawdzania poprawności i wykonanie pliku wykonywalnego.

OnPostExecute

Zapisuje wpis dziennika, natychmiast po zakończeniu pliku wykonywalnego.

OnPostValidate

Zapisuje wpis dziennika, po zakończeniu sprawdzania poprawności pliku wykonywalnego.

OnPreExecute

Zapisuje wpis dziennika bezpośrednio przed uruchomienia pliku wykonywalnego.

OnPreValidate

Zapisuje wpis dziennika, podczas uruchamiania sprawdzania poprawności pliku wykonywalnego.

OnProgress

Zapisuje wpis dziennika wymierny postęp przez plik wykonywalny.

OnQueryCancel

Zapisuje wpis dziennika na wszelkich powstających podczas przetwarzania zadania, gdzie jest to wykonalne, aby anulować wykonanie.

OnTaskFailed

Zapisuje wpis dziennika, jeśli zadanie nie powiedzie się.

OnVariableValueChanged

Zapisuje wpis dziennika, gdy wartość zmiennej.

OnWarning

Zapisuje ostrzeżenia występuje wpis dziennika.

PipelineComponentTime

Dla każdego składnik przepływ danych, zapisuje wpis dziennika dla każdej fazy sprawdzania poprawności i wykonanie.Wpis dziennika określa czas przetwarzania dla każdej fazy.

Diagnostyka

Zapisuje wpis dziennika, zawierający informacje diagnostyczne.

Na przykład można rejestrować wiadomości przed i po każdym wywołaniu z dostawca danych zewnętrznych.Aby uzyskać więcej informacji, zobacz Wykonanie pakietów rozwiązywania problemów.

Pakiet i wiele zadań mają wpisy dziennika niestandardowe, które mogą być włączone do rejestrowania.Na przykład zadanie Wyślij pocztę dostarcza SendMailTaskBegin wpis dziennika niestandardowy, który rejestruje informacje w momencie uruchamiania zadań wysyłanie poczty, ale zanim zadanie wysyła wiadomość e-mail.Aby uzyskać więcej informacji, zobacz Niestandardowe komunikaty do rejestrowania.

Rozróżnianie kopie pakietu

Dane dziennika zawiera nazwę i identyfikator GUID pakiet, do której należą wpisów dziennika.Jeśli tworzysz nowy pakiet, kopiując istniejący pakiet, nazwę i identyfikator GUID istniejący pakiet są również kopiowane.W rezultacie może być dwóch pakietów, które mają ten sam identyfikator GUID i nazwy, utrudniając rozróżniania pakiety danych dziennika.

Aby wyeliminować ten niejednoznaczności, należy zaktualizować nazwy i identyfikatora GUID nowych pakietów.W Business Intelligence Development Studio, można wygenerować identyfikatora GUID w ID Właściwości i zaktualizować wartość Name właściwość w oknie właściwości.Można również zmienić identyfikator GUID i nazwy programowo lub przy użyciu dtutil wiersz polecenia.Aby uzyskać więcej informacji, zobacz Ustawienie właściwości pakietu i dtutil narzędzia (narzędzie SSIS).

Opcje rejestracji nadrzędnej

Często, opcje rejestrowania zadań i pojemniki dla pętli, Foreach pętli i sekwencji zgadzać się z pakiet lub kontener nadrzędnego.W takim przypadek można skonfigurować je dziedziczyć ich opcje rejestrowania ich kontener nadrzędnego.Na przykład kontener dla pętli, zawierający zadanie wykonanie instrukcji SQL, zadanie wykonanie instrukcji SQL można użyć opcji rejestrowania, które są zestaw na pojemniku dla pętli.Użycie opcji rejestrowania nadrzędnej można zestaw LoggingMode właściwość kontener do UseParentzestawting.Właociwooć tę zestaw właściwość okna Business Intelligence Development Studio lub za pomocą Konfigurowanie dzienników SSIS okno dialogowe w SSIS projektanta.

Szablony rejestrowania

W Konfigurowanie dzienników SSIS okno dialogowe można także tworzyć i zapisywać często używane jako szablony rejestrowania konfiguracji, a następnie użyć szablonów w wielu pakietów.Ułatwia zastosowanie strategii spójnego rejestrowania w wielu pakietach i zmodyfikować ustawienia dziennika na pakiety aktualizacji, a następnie stosując szablony.Szablony są przechowywane w plikach XML.

Aby skonfigurować rejestrowanie przy użyciu okna dialogowego Konfigurowanie dzienników SSIS

  1. Włącz pakiet i jego zadań dla rejestrowania.Rejestrowanie może występować pakiet, kontener, jak i poziom zadań.Można określić różne dzienniki opakowań, kontenerów i zadania.

  2. Wybierz dostawca dziennika i dodać dziennika dla pakiet.Dzienniki można tworzyć tylko poziom pakiet i zadania lub kontener musi być jeden dzienniki utworzone dla pakiet.Każdy dziennik jest skojarzony z jednym z następujących dostawców dziennika: Plik tekstowy, SQL Server Profiler, SQL Server, dziennik zdarzeń systemu Windows, lub plik XML.Aby uzyskać więcej informacji, zobacz Jak Włącz rejestrowanie w pakiecie.

  3. Wybierz zdarzenie i informacje schematu dziennika o każdym zdarzeniu mają być przechwytywane w dzienniku.Aby uzyskać więcej informacji, zobacz Jak Skonfigurować rejestrowanie przy użyciu zapisanego pliku konfiguracji.

Aby wyświetlić wpisy dziennika podczas rozwoju pakiet

Ikona usług Integration Services (mała)Bieżąco z usług integracji

Najnowsze pliki do pobrania, artykuły, próbki i wideo firmy Microsoft, jak również wybranych rozwiązań ze Wspólnoty, odwiedź witrynę Integration Services strona na MSDN i TechNet:

Aby otrzymywać automatyczne powiadomienia dotyczące tych aktualizacji, zasubskrybuj źródła danych RSS dostępne na tej stronie.