Wykonania rejestrowania w pakietach
Integration Services zawiera funkcje rejestrowania tworzyć wpisy w dzienniku zdarzeń czas wykonywania wystąpić i mogą również zapisywać komunikaty niestandardowe.
Integration Services obsługuje zbiór różnych dostawców dzienników i daje możliwość tworzenia niestandardowych włączeni.The Integration Services log providers can write log entries to text files, SQL Server Profiler, SQL Server, Windows zdarzenie Log, or XML files.
Dzienniki są skojarzone z pakietami i są konfigurowane poziom pakiet.Każdego zadania lub kontener w pakiecie może rejestrować informacje o dzienniku każdy pakiet.Zadania i pojemniki w pakiecie mogą być włączone do rejestrowania nawet wtedy, gdy nie jest sam pakiet.Na przykład można włączyć rejestrowanie dla zadania wykonać instrukcji SQL bez włączania rejestrowania na opakowaniu nadrzędnej.Pakiet, kontener, lub zadania może zapisywać wiele dzienników.Można włączyć logowanie wyłącznie pakiet, lub można wybrać włączyć rejestrowanie dla wszelkich indywidualnych zadań lub 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. The Integration Services log schema defines the information that you can log.Można wybrać elementy ze schematu dziennika dla każdego wpisu do dziennika.
Pakiet i jego kontenerów i zadania nie trzeba rejestrować informacje o tym samym i zadań w obrębie tego samego pakietu lub kontener może rejestrować różne informacje.Na przykład pakiet może rejestrować informacje o operator, podczas uruchamiania pakietu, jedno zadanie może rejestrować urządzenie źródłowe błędu zadania i inne zadanie może rejestrować informacje o wystąpieniu błędów.Pakiet kontenerów i zadań korzystania z wielu dzienników, te same informacje są zapisywane w dziennikach.
Można wybrać poziom rejestrowania, który odpowiada potrzebom, określając zdarzenie do dziennika i informacji, które mają być rejestrowane dla każdego zdarzenie.Może się okazać, że niektóre zdarzenia zawierają informacje bardziej użyteczna niż inne.Na przykład, można rejestrować tylko nazwy komputera i operator dla PreExecute ale wszystkie dostępne informacje o zdarzeńBłąd zdarzenie.
Aby uniemożliwić korzystanie z dużej ilości miejsca na dysku przez pliki dziennika, lub aby uniknąć nadmiernego dziennik, który może obniżyć wydajność, można ograniczyć rejestrowanie przez wybranie określonych zdarzeń i elementy informacji logowania.Na przykład można skonfigurować dziennika przechwytywanie tylko data oraz nazwę komputera dla każdego błędu.
W SSIS Projektanta, można definiować opcje rejestrowania przy użyciu Konfigurowanie dzienników SSIS -okno dialogowe.
Schemat dziennika
W poniższej tabela opisano elementy znajdujące się w schemacie dziennika.
Element |
Description |
|---|---|
Komputer |
Nazwa komputera, na którym wystąpiło zdarzenie dziennika. |
Operator |
Tożsamość użytkownika, który uruchomił pakiet. |
NazwaObiektu |
Nazwa kontener lub zadania, w którym wystąpiło zdarzenie dziennika. |
SourceID |
Identyfikator unikatowy pakiet, kontener For Loop, Foreach Loop lub sekwencji lub zadania, w którym wystąpiło zdarzenie dziennika. |
ExecutionID |
Identyfikator GUID wystąpienie wykonywania pakiet. .gif "Note") Note:
Uruchomione jeden pakiet może tworzyć wpisy dziennika z różnymi wartościami dla elementu ExecutionID.Na przykład podczas uruchamiania pakiet BI Development Studio, w fazie sprawdzania poprawności może tworzyć wpisy dziennika z elementem ExecutionID odpowiadający BI Development Studio. Jednak w fazie wykonanie może tworzyć wpisy dziennika z elementem ExecutionID odpowiadający dtshost.exe.Na przykład inny pakiet, który zawiera pakiet wykonać zadań, każdy z tych zadań uruchamia pakiet podrzędność.Te pakiety podrzędność może tworzyć wpisy w dzienniku mają inny element ExecutionID niż wpisy dziennika które tworzy pakiet nadrzędny.
|
MessageText |
Wiadomość powiązane z danym zapisem dziennika. |
DataBytes |
Tablica bajtów specyficzne dla wpisu dziennika.Znaczenie to pole może być różna w zależności od wpisu dziennika. |
W poniższej tabela opisano trzy dodatkowe elementy w schemacie dziennika nie są dostępne na Szczegóły Karta Konfigurowanie dzienników SSIS -okno dialogowe.
Element |
Description |
|---|---|
Godzina rozpoczęcia |
Przy uruchamianiu jaką kontener lub zadanie do uruchomienia. |
EndTime |
Czas, w którym pojemniku lub zadanie przestanie działać. |
DataCode |
Wartość całkowitą opcjonalna, która zazwyczaj znajduje się wartość z DTSExecResult Wyliczanie wskazujący wynik pracy kontener lub zadania:
|
Wpisy dziennika
Integration Services obsługuje wpisy dziennika zdarzeń wstępnie zdefiniowanych i zawiera wiele wpisów dziennika niestandardowego Integration Services obiekty. The Configure SSIS Logs dialog box in SSIS Designer lists these events and custom log entries.
W poniższej tabela opisano wstępnie zdefiniowanych zdarzeń, które mogą być włączone do tworzyć wpisy w dzienniku po wystąpieniu zdarzenia czas wykonywania.Zastosowanie tych wpisów dziennika do plików wykonywalnych, pakiet, zadania i kontenerów, który zawiera pakiet.Nazwa wpisu dziennika jest taka sama jak nazwa zdarzenie czas wykonywania, który następnie został podniesiony spowodował wpisu dziennika do zapisania.
Zdarzenia |
Description |
|---|---|
OnError |
Zapisuje wpis dziennika, gdy wystąpi błąd. |
OnExecStatusChanged |
Zapisuje wpis dziennika, gdy stan wykonania zmian w pliku wykonywalnego. |
OnInformation |
Zapisuje informacje o raporcie wpisu dziennika podczas sprawdzania poprawności i wykonywanie pliku wykonywalnego. |
OnPostExecute |
Zapisuje wpis dziennika, natychmiast po zakończeniu pliku wykonywalnego. |
OnPostValidate |
Zapisuje wpisu dziennika po zakończeniu sprawdzania poprawności pliku wykonywalnego. |
OnPreExecute |
Zapisuje wpis w dzienniku bezpośrednio przed uruchomienie pliku wykonywalnego. |
OnPreValidate |
Zapisuje wpis dziennika, podczas uruchamiania sprawdzania poprawności pliku wykonywalnego. |
OnProgress |
Zapisuje wpisu dziennika po wymiernych postęp przez plik wykonywalny. |
OnQueryCancel |
Zapisuje wpisu dziennika na każdy kiedy podczas przetwarzania zadania, gdzie jest to możliwe, aby anulować wykonanie. |
OnTaskFailed |
Zapisuje wpis dziennika, gdy zadanie zakończy się niepowodzeniem. |
OnVariableValueChanged |
Zapisuje wpis dziennika, gdy zmienia się wartość zmiennej. |
OnWarning |
Zapisuje wpis dziennika, gdy pojawia się komunikat ostrzegawczy. |
PipelineComponentTime |
Dla każdego przepływ danych składnika, zapisuje wpisu dziennika dla każdej fazy sprawdzania poprawności i wykonywanie.Wpis dziennika określa czas przetwarzania dla każdej fazy. |
Diagnostyczne |
Zapisuje wpis dziennika, zawierający informacje diagnostyczne. Na przykład można rejestrować komunikat przed i po każdym wywołaniu z dostawca danych zewnętrznych.Aby uzyskać więcej informacji zobaczTroubleshooting Package Execution. |
Pakiet i wiele zadań ma wpisy dziennika niestandardowe, które mogą być włączone do logowania się.Na przykład, dostarcza zadanie Wyślij pocztę SendMailTaskBegin Wpis dziennika niestandardowego, który rejestruje informacje w momencie uruchamiania zadania Wyślij pocztę, ale zanim zadanie wysyła wiadomość e-mail. Aby uzyskać więcej informacji zobaczNiestandardowe komunikaty o rejestrowania.
Rozróżnianie kopie pakiet
Dane dziennika zawiera nazwy i identyfikatora GUID pakiet, do których należą wpisów dziennika.Jeśli tworzysz nowy pakiet, kopiując istniejący pakiet, nazwy i identyfikatora GUID z istniejącym pakiecie są również kopiowane.W rezultacie może być dwóch pakietów, które mają ten sam identyfikator GUID i nazwy, dzięki czemu jest trudny do rozróżniania pakiety danych dziennika.
Aby wyeliminować ten niejednoznaczności, należy zaktualizować nazwy i identyfikatora GUID z nowych pakietów.W Business Intelligence Development Studio, można wygenerować identyfikatora GUID w ID Właściwość i zaktualizować wartości Name Właściwość w oknie dialogowym właściwości. Można również zmienić identyfikatora GUID a nazwą programowo lub przy użyciu dtutil wiersz polecenia. Aby uzyskać więcej informacji zobacz Ustawianie właściwości pakietu i Narzędzie dtutil.
Opcje rejestrowania nadrzędny
Często opcji rejestrowania zadań i pojemników do pętli, pętla Foreach i sekwencji zgadzać się z pakiet lub kontener nadrzędnego.W takim przypadek można skonfigurować je dziedziczyć ich opcji rejestrowania ich kontener nadrzędnego.Na przykład w kontenerze pętli for zawierający zadania programu wykonać instrukcji SQL, zadanie wykonać instrukcji SQL można użyć opcji rejestrowania, które są zestaw w kontenerze pętli for.Aby korzystać z opcji rejestracji nadrzędnej, ustaw LoggingMode Właściwość kontener UseParentSetting.Tę właściwość zestaw w Właściwości oknaBusiness Intelligence Development Studio lub za pomocą Konfigurowanie dzienników SSIS pole dialogowe SSIS Projektant.
Szablony rejestrowania
W Konfigurowanie dzienników SSIS -okno dialogowe, można również utworzyć i zapisać często używane konfiguracje rejestrowania jako szablony, a następnie za pomocą szablonów w wielu pakietów.Ułatwia to łatwe zastosowanie strategii spójne rejestrowania w wielu pakietów i zmodyfikować ustawienia dziennika na pakiety aktualizacji, a następnie wprowadzając szablonów.Szablony są przechowywane w plikach XML.
Aby skonfigurować rejestrowanie przy użyciu okna dialogowego Konfigurowanie dzienników SSIS
Włącz pakiet i jego zadania dla rejestracji.Rejestrowanie może pojawić się wtedy pakiet, kontener i poziom zadań.Można określić różnych dzienników dla pakietów, kontenery i zadania.
Wybierz dostawca dziennika i dodać dziennika dla tego pakiet.Dzienniki mogą być tworzone tylko poziom pakiet, a zadanie lub kontener muszą używać jednego z dzienników utworzone dla tego pakiet.Każdy dziennik jest skojarzony z jedną z następujących dostawców dzienników: Plik tekstowy, SQL Server Profiler, SQL ServerDziennik zdarzeń systemu Windows lub pliku XML. Aby uzyskać więcej informacji zobaczHow to: Enable Logging in a Package.
Wybierz zdarzenie i informacji schematu dziennika o każdym zdarzeniu mają być przechwytywane w dzienniku.Aby uzyskać więcej informacji zobaczHow to: Configure Logging by Using a Saved Configuration File.
Aby wyświetlić pozycje dziennika czasie projektowania pakiet
Zasoby zewnętrzne
- Projekt CodePlex Narzędzie DTLoggedExec pełny i rejestrowanie szczegółowych, na www.codeplex.com
|
.gif "Integration Services icon (small)")
Konfiguracja w aktualizacji z usług integracja Services pobytu