Budowanie, wdrażanie i debugowania obiektów niestandardowych
Po zostały zapisane kodu niestandardowego obiektu dla Integration Services, należy utworzyć wirtualny plik dziennika, wdrożyć, zintegrować go do SSIS projektanta stał się dostępny do użytku w opakowaniach i testować i debugować typie.
Kroki tworzenia, wdrażania i debugowanie obiektów niestandardowych usług integracji
Niestandardowe funkcje zostały już zapisane dla obiektu.Teraz należy przetestować i udostępnić go użytkownikom.Kroki są bardzo podobne dla wszystkich typów obiektów niestandardowych, które można utworzyć dla Integration Services.
Poniżej przedstawiono kroki, które należy wykonać w budowania, wdrażania i debugowania:
Znak wirtualny plik dziennika został wygenerowany przy użyciu silnej nazwy.
Tworzenie wirtualny plik dziennika.
Wdrażanie wirtualny plik dziennika przez przeniesienie lub skopiowanie go do odpowiednich Integration Services folder.
Zainstaluj wirtualny plik dziennika w Global Assembly Cache (GAC).
Dodaj obiektu do przybornika, gdy obiekt jest zadanie lub składnik przepływu danych.
Rozwiązywanie problemów z wdrażania, w razie potrzeby.
Test i debugowania kodu.
Podpisywanie zestawu
Gdy wirtualny plik dziennika jest przeznaczony do udostępnienia, muszą być zainstalowane w Global Assembly Cache.Po dodaniu do wirtualny plik dziennika Global Assembly Cache, Zgromadzenie może być używane przez aplikacje takie jak Business Intelligence Development Studio.Wymóg Global Assembly Cache jest, że zgromadzenie musi być podpisany przy użyciu silnej nazwy, która gwarantuje, że zespół jest globalnie unikatowa.wirtualny plik dziennika o silnej nazwie ma w pełni kwalifikowaną nazwę, która zawiera nazwę kultury, klucz publiczny i numer wersja wirtualny plik dziennika.Środowisko wykonawcze używa tych informacji do lokalizowania wirtualny plik dziennika i odróżnia je od innych zespołów o tej samej nazwie.
Aby podpisać wirtualny plik dziennika o silnej nazwy, należy najpierw mają lub utworzyć publicznego i prywatnego klucz para.To publicznego i prywatnego klucz kryptograficznego używany w kompilacji czas utworzyć wirtualny plik dziennika o silnej nazwie.
Aby uzyskać więcej informacji o silnych nazwach oraz kroki musi followto znak wirtualny plik dziennika, zobacz następujące tematy w .NET Framework dokumentacji wirtualny plik dziennika SDK:
Zespoły o nazwie silne
Tworzenie para kluczy
Podpisywanie zestaw o silnej nazwy
Można łatwo zarejestrować swój wirtualny plik dziennika o silnej nazwy w Visual Studio na kompilacji czas.W Właściwości projektu okno dialogowe Wybierz podpisywania kartę.Wybierz opcję, aby podpisuje wirtualny plik dziennika z , a następnie wprowadź ścieżka pliku klucz (.snk).
Tworzenie zestawu
Po podpisaniu projektu, należy zbudować lub odbudować projektu lub roztwór za pomocą poleceń dostępnych w Tworzenie menu BI Development Studio.Rozwiązanie może zawierać oddzielne projektu dla niestandardowego interfejs użytkownika, który również musi być podpisany przy użyciu silnej nazwy i mogą być wbudowane w tym samym czas.
Najbardziej wygodną metoda do wykonywania następnych dwóch krokach — wdrażanie wirtualny plik dziennika i instalowania go w globalna pamięć podręczna zestawów — jest skrypt kroki jako zdarzenie typu post-build w Visual Studio.Zdarzenia kompilacji są dostępne z skompilować strona właściwości projektu dla Visual Basic projektu i z Tworzenie zdarzenia strona projektu C#.Pełna ścieżka jest wymagane dla narzędzia wiersz polecenia, takie jak gacutil.exe.Cudzysłowy są wymagane zarówno wokół ścieżki zawierające spacje i wokół makra takich jak $(TargetPath), które rozwinąć ścieżki zawierające spacje.
Oto przykładowy wiersz polecenia post-build zdarzenie dla niestandardowego dostawca dziennika:
"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -u $(TargetName)
"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -i $(TargetFileName)
copy $(TargetFileName) "C:\Program Files\Microsoft SQL Server\100\DTS\LogProviders "
Wdrażanie zestawu
The SSIS Designer locates the custom objects available for use in packages by enumerating the files found in a series of folders that are created when SQL Server Integration Services is installed.Gdy domyślny SQL Server instalacji zestawtings są używane, to zestaw folderów znajduje się w C:\Program files\microsoft sql server\100\dts. Jednakże jeżeli utworzysz zestawgórę program dla niestandardowego obiektu, należy sprawdzić wartość HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\zestawup\DtsPath klucz rejestru, aby zweryfikować lokalizacja tego folderu.
wirtualny plik dziennika można umieścić w folderze na dwa sposoby:
Przenoszenie lub kopiowanie skompilowany wirtualny plik dziennika do odpowiedniego folderu po jego utworzeniu.(Dla wygody można dołączyć polecenie Kopiuj w przypadku Post-build.)
Tworzenie wirtualny plik dziennika bezpośrednio w odpowiednim folderze.
Następujące foldery wdrażania C:\Program files\microsoft sql server\100\dts są używane dla różnych typów obiektów niestandardowych:
Obiekt niestandardowy |
Folder wdrażania |
|---|---|
Zadanie |
Zadania |
Menedżer połączeń |
Połączenia |
Dostawca dziennika |
LogProviders |
Składnik przepływu danych |
PipelineComponents |
Ostrzeżenie
Zespoły są kopiowane do tych folderów do obsługi wyliczanie dostępne zadania, menedżerowie połączenia i tak dalej.Dlatego nie trzeba wdrożyć zestawy, które zawierają tylko interfejs użytkownika niestandardowego niestandardowych obiektów do tych folderów.
Instalowanie zestawu w pamięci podręcznej zestawów globalnych
Zainstalować wirtualny plik dziennikau zadań w Global Assembly Cache (GAC), użyj narzędzie wiersza polecenia gacutil.exe, lub przeciągnij zespołów do %system%\assembly katalogu.Dla wygody można także dodać wywołanie gacutil.exe w przypadku Post-build.
Następujące polecenie instaluje składnik o nazwie MyTask.dll w pamięci podręcznej GAC za pomocą gacutil.exe.
gacutil /iF MyTask.dll
Należy zamknąć i ponownie otworzyć SSIS Projektant po zainstalowaniu nowej wersja obiektu niestandardowego.Jeśli zainstalowano wcześniejszych wersja obiektu niestandardowego w Global Assembly Cache, należy je usunąć przed zainstalowaniem nowej wersja.Aby odinstalować wirtualny plik dziennika, uruchom gacutil.exe i określ nazwę wirtualny plik dziennika z /u opcji.
Więcej informacji o Global Assembly Cache, zobacz Global Assembly Cache narzędzia (Gactutil.exe) w .NET Framework Narzędzia.
Dodawanie zadania lub części przepływu danych do przybornika
After you have deployed the custom object and installed it in the global assembly cache, it can be used in Business Intelligence Development Studio like any object that is included with SQL Server Integration Services.Jednakże musi zostać dodany do Przybornik jawnie.
Aby dodać niestandardowy składnik do przybornika
Kliknij prawym przyciskiem myszy w przyborniku, a następnie kliknij przycisk Wybierz elementy.
W Choose Toolbox Items okno dialogowe, kliknij SSIS sterowania przepływem towarów kartę zadania lub Elementy przepływ danych SSIS karta dla składnik przepływ danych.
Kliknij pole wyboru obok składnika, a następnie kliknij OK.
Ostrzeżenie
Jeśli składnik nie jest wyświetlany na liście, można kliknąć Przeglądaj zlokalizować składnika.Ale w takim przypadek może nie być zainstalowane poprawnie.
Rozwiązywanie problemów dotyczących wdrażania
Jeśli niestandardowy obiekt znajduje się w Przybornik lub listę dostępnych obiektów, ale nie będą mogli go dodać do pakiet, wypróbuj następujące metody:
Szukaj w Global Assembly Cache dla wielu wersji składnika.Jeśli istnieje wiele wersji składnika w Global Assembly Cache, projektant nie można załadować składnika.Usuń wszystkie wystąpienia wirtualny plik dziennika z Global Assembly Cache, i ponownie dodać do wirtualny plik dziennika.
Upewnij się, że tylko jedno wystąpienie wirtualny plik dziennika istnieje w folderze wdrażania.
Resetuj przybornika.
Dołącz Visual Studio do devenv.exe i zestaw przerwania do krokowego kodu inicjowania do zapewnienia, że wystąpić żadne wyjątki.
Testowanie i debugowanie kodu
Najprostsze podejście do debugowania wykonywania -czas metod obiektów niestandardowych jest rozpoczęcie dtexec.exe z Visual Studio po budynku niestandardowych obiektów i uruchom pakiet, który używa składnika.
Jeśli chcesz debugować projektowania składnika -czas metod, takich jak Validate metoda Otwórz pakiet, który używa składnika w drugiej instancji Visual Studioi dołączyć do jego devenv.exe procesu.
Jeśli chcesz także debugowanie składnika Uruchom -czas metod, gdy pakiet jest otwarty i uruchomiony w SSIS projektanta, należy wymusić Wstrzymaj wykonanie pakiet, dzięki czemu można również dołączyć do DtsDebugHost.exe procesu.
Debugowania wykonywania obiektu -czas metod, dołączając do dtexec.exe
Podpisać i budowania projektu w konfiguracja debugowania, wdrożyć i zainstalować go w Global Assembly Cache opisane w tym temacie.
Na debugowania karcie Właściwości projektu, zaznacz Start zewnętrzny program jako Uruchomienia akcjii zlokalizuj dtexec.exe, który jest instalowany domyślnie w folderze C:\Program Files\Microsoft SQL Server\100\DTS\Binn.
W Opcje wiersza polecenia pole tekstowe, w Opcje Start, wprowadź wymagane do uruchomienia pakiet, który używa składnika argumenty wiersza polecenia.Argument wiersza polecenia będą często składają się z przełącznikiem /F [plik] ścieżka i nazwę pliku .dtsx.Aby uzyskać więcej informacji, zobacz dtexec narzędzia (narzędzie SSIS).
Ustawianie punktów przerwania w kodzie źródłowym miarę Uruchom -czas metody składnika.
Uruchom projekt.
Debugowanie projektowania niestandardowych obiektów -czas metod, dołączając do Business Intelligence Development Studio
Podpisać i budowania projektu w konfiguracja debugowania, wdrożyć i zainstalować go w Global Assembly Cache opisane w tym temacie.
Punkty przerwania ustawiono w kodzie źródłowym, gdzie stosowne, w projekt -czas metod niestandardowych obiektów.
Otwórz drugie wystąpienie Visual Studio i załadować Integration Services projektu, który zawiera pakiet, która używa niestandardowych obiektów.
Z pierwszego wystąpienie Visual Studio, dołączyć do drugiego wystąpienie devenv.exe , w której pakiet jest ładowany przez wybranie Dołącz do procesu z debugowania menu pierwszej instancji.
Należy uruchomić pakiet drugiego wystąpienie Visual Studio.
Debugowania wykonywania obiektów niestandardowych -czas metod, dołączając do Business Intelligence Development Studio
Po wykonaniu kroków opisanych w poprzedniej procedurze wymusić Wstrzymaj wykonanie pakiet, dzięki czemu można dołączyć do DtsDebugHost.exe.Można wymusić tej przerwy, dodając punkt przerwania do OnPreExecute zdarzenie lub Dodawanie zadania skryptu do projektu i wprowadzając skrypt, który wyświetla pole komunikatów modalnych.
Uruchom pakiet.Gdy wstrzymanie występuje, przełącz się do wystąpienie Visual Studio w projekcie kodu jest otwarty, a następnie wybierz pozycję Dołącz do procesu z debugowania menu.Upewnij się dołączyć do wystąpienie DtsDebugHost.exe jako zarządzane x 86 w typu kolumna nie do wystąpienie jako x 86 tylko.
Wróć do wstrzymania pakiet i kontynuowane poza punkt przerwania lub kliknij przycisk OK zamknąć okno komunikatu, uruchamiany przez zadanie skryptu i kontynuować wykonywanie pakiet i debugowania.
|
.gif "Ikona usług Integration Services (mała)")
Bieżąco z usług integracji