Tworzenie niestandardowego menedżera połączeń

Dotyczy:SQL Server Środowisko SSIS Integration Runtime w usłudze Azure Data Factory

Kroki, które musisz wykonać, aby stworzyć niestandardowego menedżera połączeń, są podobne do tych przy tworzeniu dowolnego innego niestandardowego obiektu dla Integration Services:

  • Stwórz nową klasę, która dziedziczy po klasie bazowej. Dla menedżera połączeń klasa bazowa to ConnectionManagerBase.

  • Przypisz atrybut identyfikujący typ obiektu do klasy. Dla menedżera połączeń atrybut to DtsConnectionAttribute.

  • Nadpisz implementację metod i właściwości klasy bazowej. Dla menedżera łącza to obejmuje ConnectionString własność oraz metody AcquireConnectionReleaseConnection .

  • Opcjonalnie warto opracować niestandardowy interfejs użytkownika. Dla menedżera połączeń wymaga to klasy implementującej IDtsConnectionManagerUI interfejs.

Note

Większość zadań, źródeł i miejsc docelowych wbudowanych w usługi integracyjne działa wyłącznie z konkretnymi typami wbudowanych menedżerów połączeń. Dlatego tych próbek nie można testować z wbudowanymi zadaniami i komponentami.

Zaczynam z niestandardowym Menedżer połączeń

Tworzenie projektów i zajęć

Ponieważ wszystkie zarządzane menedżery połączeń wywodzą się z ConnectionManagerBase klasy bazowej, pierwszym krokiem przy tworzeniu niestandardowego menedżera połączeń jest stworzenie projektu biblioteki klas w preferowanym języku zarządzanego programowania i stworzenie klasy dziedziczącej z klasy bazowej. W tej wyprowadzonej klasie nadpisujesz metody i właściwości klasy bazowej, aby zaimplementować własną funkcjonalność.

W tym samym rozwiązaniu stwórz projekt biblioteki drugiej klasy dla niestandardowego interfejsu użytkownika. Zaleca się osobny asembler dla interfejsu użytkownika dla ułatwienia wdrożenia, ponieważ pozwala on niezależnie aktualizować i ponownie wdrażać menedżera połączeń lub jego interfejs.

Konfiguruj oba projekty tak, aby podpisywały asemble, które będą generowane podczas budowania, używając pliku klucza o silnej nazwie.

Zastosowanie atrybutu DtsConnection

Zastosuj DtsConnectionAttribute atrybut do klasy, którą stworzyłeś, aby zidentyfikować ją jako menedżera połączeń. Ten atrybut dostarcza informacji w czasie projektowania, takich jak nazwa, opis i typ połączenia menedżera połączeń. Właściwości ConnectionTypei Description odpowiadają kolumnom Type i Description wyświetlanym w oknie dialogowym Add SSIS Menedżer połączeń, które wyświetlane są podczas konfiguracji połączeń dla pakietu w SQL Server Data Tools (SSDT).

Użyj tej UITypeName właściwości, aby połączyć menedżera połączeń z jego niestandardowym interfejsem użytkownika. Aby uzyskać token klucza publicznego wymagany dla tej właściwości, możesz użyć sn.exe -t , aby wyświetlić token klucza publicznego z pliku key pair (.snk), którego zamierzasz użyć do podpisania zespołu interfejsu użytkownika.

<DtsConnection(ConnectionType:="SQLVB", _  
  DisplayName:="SqlConnectionManager (VB)", _  
  Description:="Connection manager for Sql Server", _  
  UITypeName:="SqlConnMgrUIVB.SqlConnMgrUIVB,SqlConnMgrUIVB,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")> _  
Public Class SqlConnMgrVB  
  Inherits ConnectionManagerBase  
  . . .  
End Class  
[DtsConnection(ConnectionType = "SQLCS",  
  DisplayName = "SqlConnectionManager (CS)",  
  Description = "Connection manager for Sql Server",  
  UITypeName = "SqlConnMgrUICS.SqlConnMgrUICS,SqlConnMgrUICS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")]  
public class SqlConnMgrCS :  
ConnectionManagerBase  
{  
  . . .  
}  

Budowanie, wdrażanie i debugowanie niestandardowego Menedżer połączeń

Kroki budowania, wdrażania i debugowania niestandardowego menedżera połączeń w Integration Services są podobne do kroków dla innych typów obiektów niestandardowych. Więcej informacji można znaleźć w sekcji Budowanie, wdrażanie i debugowanie niestandardowych obiektów.