Udostępnij za pośrednictwem

  • Artykuł

Budowanie, wdrażanie i debugowanie obiekty niestandardowe

Po zostały zapisane do obiektów niestandardowych dla kodu Integration Services, należy utworzyć wirtualny plik dziennika, wdrożyć, zintegrować go do SSIS Projektanta, aby był dostępny do użytku w pakietach oraz testowania i debugowania go.

Kroki Building, wdrażanie i debugowanie obiektów niestandardowych dla usług integracja Services

Niestandardowe funkcje zostały już zapisane dla obiektu.Teraz należy go przetestować i udostępnić go użytkownikom.Kroki są bardzo podobne do wszystkich typów obiektów niestandardowych, które można tworzyć dla Integration Services.

Poniżej przedstawiono czynności, które można wykonać, budowania, wdrażania i debugowanie go:

  1. Znak wirtualny plik dziennika został wygenerowany przy użyciu silnej nazwy.

  2. Kompilacja wirtualny plik dziennika.

  3. wdrożyć wirtualny plik dziennika przez przeniesienie lub skopiowanie go do odpowiedniej Integration Services folder.

  4. Instalowanie wirtualny plik dziennika w Global wirtualny plik dziennika Cache (GAC).

  5. Dodawanie obiektu do przybornika, gdy obiekt jest zadaniem lub składnik przepływu danych.

  6. Rozwiązywanie problemów rozmieszczania, jeśli to konieczne.

  7. Test i debugowania kodu.

Podpisanie wirtualny plik dziennika

wirtualny plik dziennika jest przeznaczony do udostępnienia, musi być zainstalowany w Global wirtualny plik dziennika Cache.Po dodaniu Global wirtualny plik dziennika Cache wirtualny plik dziennika wirtualny plik dziennika mogą być używane przez aplikacje takie jak Business Intelligence Development Studio. Wymóg Global wirtualny plik dziennika Cache jest, że wirtualny plik dziennika musi być podpisany przy silnej nazwy, która gwarantuje, że zespół jest globalnie unikatowa.wirtualny plik dziennika o silnej nazwie ma pełną nazwę, która zawiera nazwę kultury, klucz publiczny i numer wersja wirtualny plik dziennika.W czasie wykonywania informacje są używane do lokalizowania wirtualny plik dziennika i odróżnia go od innych zespołów o takiej samej nazwie.

Aby zapisać wirtualny plik dziennika o silnej nazwy, należy najpierw mają lub utworzyć publicznego i prywatnego klucz pary.To publiczne i prywatne kryptograficznych pary kluczy jest wykorzystywana w kompilacji czas utworzyć wirtualny plik dziennika o silnej nazwie.

Aby uzyskać więcej informacji o silnych nazwach i czynności należy do tego znaku followto wirtualny plik dziennika, zobacz następujące tematy w .NET Framework Dokumentację wirtualny plik dziennika SDK:

  • Zestawy nazwane silne

  • Tworzenie parę kluczy

  • Podpisywanie wirtualny plik dziennika o silnej nazwy

Twoje wirtualny plik dziennika o silnej nazwy w prosty sposób można zarejestrować Visual Studio w kompilacji czas. W Właściwości projektu okno dialogowe wybierzPodpisywanie tab.Wybierz opcję, aby Podpisanie wirtualny plik dziennika a następnie podaj ścieżka do pliku klucz (.snk).

Tworzenie wirtualny plik dziennika

Po podpisaniu projektu, należy utworzyć lub ponownie skompilować projekt lub rozwiązanie za pomocą poleceń dostępnych w Kompilacja menu of BI Development Studio. Rozwiązania problemu może zawierać oddzielne projektu dla interfejs użytkownika niestandardowego, które również musi być podpisany przy użyciu silnej nazwy i mogą być wbudowane w tym samym czasie.

Następne dwa kroki wykonywane jest najbardziej wygodną metodą — wirtualny plik dziennika wdrażania i instalowania go w Global wirtualny plik dziennika Cache — jest skryptu następujące kroki jako post-build zdarzenie w Visual Studio. Zdarzenia kompilacji są dostępne z Kompilacji strona z właściwości projektuVisual Basic Projekt i z Tworzenie zdarzenia strona w projekcie języka C#.Pełna ścieżka jest wymagane dla narzędzia wiersz polecenia, takie jak Gacutil.exe.Wymagane wokół ścieżki zawierające spacje i wokół makra takich jak $(TargetPath) rozwinąć ścieżki zawierające spacje są znaki cudzysłowu.

Oto przykładowy wiersz polecenia post-build zdarzenie dla dostawca dziennika niestandardowego:

"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 wirtualny plik dziennika

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.Jeśli wartość domyślna SQL Server ustawienia instalacji są używane, to zbiór folderów znajduje się w folderze C:\Program Files\Microsoft SQL Server\100\DTS.Jednak jeśli program instalacyjny został utworzony dla niestandardowego obiektu, należy sprawdzić wartość HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath klucz rejestru, aby sprawdzić, lokalizacja tego folderu.

wirtualny plik dziennika można umieścić w folderze na dwa sposoby:

  • Przenoszenie lub kopiowanie skompilowanym zestawie do odpowiedniego folderu po jej utworzeniu.(Dla wygody można umieścić polecenie copy w Post-build zdarzenie.)

  • Tworzenie wirtualny plik dziennika bezpośrednio we właściwym 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ływ danych

PipelineComponents

Uwaga

Zespoły są kopiowane do tych folderów do obsługi wyliczanie dostępnych zadań, 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 wirtualny plik dziennika w pamięci podręcznej zestawów globalnych

Aby zainstalować wirtualny plik dziennika zadań w Global wirtualny plik dziennika Cache (GAC), należy użyć narzędzie wiersza polecenia Gacutil.exe, albo przeciągnij zestawów %system%\assembly katalog. Dla wygody można również dołączyć wywołanie Gacutil.exe Post-build zdarzeń.

Następujące polecenie instaluje składnik o nazwie MyTask.dll w pamięci podręcznej GAC przy użyciu Gacutil.exe.

gacutil /iF MyTask.dll

Musisz zamknąć i ponownie otworzyć SSIS Projektant po zainstalowaniu nowej wersja obiektu niestandardowego. Global wirtualny plik dziennika Cache zainstalowano wcześniejszych wersja obiektu niestandardowego, należy je usunąć przed zainstalowaniem nowej wersja.Aby odinstalować wirtualny plik dziennika, uruchamianie Gacutil.exe i określ nazwę wirtualny plik dziennika z /u Opcja.

Aby uzyskać więcej informacji na temat Global wirtualny plik dziennika Cache Zobacz narzędzie pamięci podręcznej zestawów globalnych (Gactutil.exe) w .NET Framework Narzędzia.

Dodawanie zadania lub składnik przepływ 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 muszą zostać dodane do Przybornik jawnie.

Aby dodać niestandardowy składnik do przybornika

  1. Kliknij prawym przyciskiem myszy przybornika, a następnie kliknij przycisk Wybierz elementy.

  2. W Wybierz elementy do przybornika okno dialogowe kliknijElementy przepływu sterowania SSIS Karta zadania lub SSIS elementy przepływ danych karta składnik przepływ danych.

  3. Kliknij pole wyboru obok składnika, a następnie kliknij przycisk OK.

Uwaga

Jeśli składnik nie jest wyświetlany na liście, możesz kliknąć przycisk Przeglądanie zlokalizować składnika.Jednak w takim przypadek go może nie być poprawnie zainstalowany.

Rozwiązywanie problemów dotyczących wdrożenia

Jeśli twój niestandardowy obiekt znajduje się w Przybornik lub listę dostępnych obiektów, ale nie będą mogli dodać go do pakiet, spróbuj wykonać następujące czynności:

  1. Znajdź Global wirtualny plik dziennika Cache dla wielu wersji składnika.Jeśli istnieje wiele wersji składnika w Global wirtualny plik dziennika Cache, projektant nie można załadować składnika.Usuń wszystkie wystąpienia danego wirtualny plik dziennika z Global wirtualny plik dziennika Cache i ponownie dodać do wirtualny plik dziennika.

  2. Upewnij się, że istnieje tylko jedno wystąpienie tego wirtualny plik dziennika, w folderze wdrażania.

  3. Zresetuj przybornika.

  4. Dołącz Visual Studio Aby devenv.exe i zestaw punkt przerwania na przechodzenie przez kod inicjowania upewnij się, że występują żadnych wyjątków.

Testowanie i debugowanie kodu użytkownika

Najprostsze podejście do debugowania wykonywania-czas metod obiektów niestandardowych jest rozpoczęcie dtexec.exe from Visual Studio Po tworzenia niestandardowego obiektu i uruchomić pakiet, który używa składnika.

Jeśli chcesz debugować składnika czas projektowania metod, takich jak Validate Metoda, otwórz pakiet, który wykorzystuje składnik w drugiej instancji Visual Studioi dołączyć do jego devenv.exe proces.

Jeśli chcesz także debugowania składnika czas wykonywania metod, gdy pakiet jest otwarty i uruchomiony w SSIS projektanta, należy wymusić przerwy w wykonywaniu tego pakietu, dzięki czemu można również dołączyć do DtsDebugHost.exe proces.

W celu debugowania wykonywania obiektu-czas metod, dołączając do dtexec.exe

  1. Podpisywania i budowanie projektu w konfiguracja programu Debug, wdrożyć i zainstalowania go w Global wirtualny plik dziennika Cache zgodnie z opisem w tym temacie.

  2. Na Program Debug tab of Właściwości projektu, select Uruchom program zewnętrzny as the Uruchamianie akcjai zlokalizuj dtexec.exe, która jest instalowana domyślnie w folderze C:\Program Files\Microsoft SQL Server\100\DTS\Binn.

  3. W Opcje wiersza polecenia pole tekstowe, w obszarze Opcje uruchamiania, należy podawać argumenty wiersza polecenia wymagane do uruchomienia pakiet, który używa składnika.Często przełącznik /F [ILE], a po nim ścieżka i nazwę pliku .dtsx będą obejmować argumentu wiersza polecenia.Aby uzyskać więcej informacji zobaczNarzędzie dtexec.

  4. Ustawić punkty przerwania w kodzie źródłowym, jeśli w procesie-czas metody składnika.

  5. Uruchom projekt.

Aby debugować obiektów niestandardowych metod czas projektowania przez dołączenie do Business Intelligence Development Studio

  1. Podpisywania i budowanie projektu w konfiguracja programu Debug, wdrożyć i zainstalowania go w Global wirtualny plik dziennika Cache zgodnie z opisem w tym temacie.

  2. Ustawianie punktów przerwania w urządzenie źródłowe kodem odpowiednim w metodach czas projektowania do obiektu niestandardowego.

  3. Otwórz drugie wystąpienie Visual Studio i załadować Integration Services Projekt, który zawiera pakiet, która używa niestandardowych obiektów.

  4. Z pierwszego wystąpienia Visual Studio, dołączyć do drugiego wystąpienia devenv.exe w którym pakiet jest ładowany przez wybranie Dołączanie do procesów from the Program Debug menu pierwsze wystąpienie.

  5. Należy uruchomić pakiet drugiego wystąpienie Visual Studio.

Aby debugować obiektów niestandardowych metod wykonywania przez dołączenie do Business Intelligence Development Studio

  1. Po wykonaniu kroków opisanych w poprzedniej procedurze, wymusić przerwy w wykonywaniu pakiet, aby dołączyć do DtsDebugHost.exe.Można wymusić tej przerwy, dodając punkt przerwania na OnPreExecute zdarzenie, lub dodaniem zadania skryptu do projektu i wprowadzając skrypt, który zostanie wyświetlone okno komunikatu modalne.

  2. Należy uruchomić pakiet.W przypadku wystąpienie wstrzymanie przełączyć się do wystąpienie Visual Studio w którym projektu kod jest otwarty, a następnie wybierz pozycję Dołączanie do procesów from the Program Debug menu.Upewnij się dołączyć do wystąpienie DtsDebugHost.exe na liścieZarządzane, x 86 in the Typ kolumnie nie do wystąpienie jako dla komputerów z procesorami x 86 tylko.

  3. Powrót do wstrzymania pakiet i kontynuować poza punkt przerwania lub kliknij przycisk OK , aby zamknąć okno komunikatu, uruchamiany przez zadanie skryptu, a następnie kontynuować wykonywanie pakiet i debugowania.

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.