Создание пользовательского диспетчера соединений

Мақала
07/04/2024

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Действия, которые необходимо выполнить для создания пользовательского диспетчера соединений, аналогичны действиям по созданию любого другого пользовательского объекта для служб Integration Services:

Создайте новый класс, наследующий базовый класс. Для диспетчера соединений базовым классом является ConnectionManagerBase.
Примените к классу атрибут, определяющий тип объекта. Для диспетчера соединений используется атрибут DtsConnectionAttribute.
Переопределите реализацию методов и свойств базового класса. Для диспетчера соединений это свойство ConnectionString, методы AcquireConnection и ReleaseConnection.
При необходимости разработайте настраиваемый пользовательский интерфейс. В случае с диспетчером соединений для этого необходимо использовать класс, реализующий интерфейс IDtsConnectionManagerUI.

Примечание.

Большинство задач, источников и назначений, встроенных в службы Integration Services, работают только с определенными типами встроенных диспетчеров соединений. Поэтому данные образцы нельзя протестировать с помощью встроенных задач и компонентов.

Приступая к работе над пользовательским диспетчером соединений

Создание проектов и классов

Так как все управляемые диспетчеры соединений являются производными от базового класса ConnectionManagerBase, на первом шаге создания пользовательского диспетчера соединений необходимо создать проект библиотеки классов на предпочитаемом языке программирования управляемого кода, а затем создать класс, наследующий от базового класса. В этом производном классе будут переопределены методы и свойства базового класса, чтобы реализовать пользовательские функциональные возможности.

Создайте в том же решении второй проект библиотеки классов для собственного пользовательского интерфейса. Для пользовательского интерфейса рекомендуется использовать отдельную сборку, что позволяет обновлять и заново развертывать диспетчер соединений или его пользовательский интерфейс независимо друг от друга.

Настройте в обоих проектах подписывание сборок, которые будут создаваться во время построения, с помощью файла ключа для строгого имени.

Применение атрибута DtsConnection

Примените к созданному классу атрибут DtsConnectionAttribute, чтобы определить его в качестве диспетчера соединений. Этот атрибут содержит сведения для времени разработки, например, имя, описание и тип соединения диспетчера соединений. Свойства ConnectionType и описания соответствуют столбцам типа и описания, отображаемым в диалоговом окне "Добавление служб SSIS диспетчер подключений", которое отображается при настройке подключений для пакета в SQL Server Data Tools (SSDT).

Используйте свойство UITypeName, чтобы связать диспетчер соединений с его пользовательским интерфейсом. Чтобы получить токен открытого ключа, необходимый для этого свойства, можно использовать команду sn.exe -t, отображающую токен открытого ключа из SNK-файла пары ключей, который предназначен для подписывания сборки пользовательского интерфейса.

<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  
{  
  . . .  
}

Построение, развертывание и отладка пользовательского диспетчера соединений

Действия по созданию, развертыванию и отладке пользовательского диспетчера соединений в службах Integration Services аналогичны шагам для других типов пользовательских объектов. Дополнительные сведения см. в разделе Сборка, развертывание и отладка пользовательских объектов.

См. также

Написание кода пользовательского диспетчера соединений
Разработка пользовательского интерфейса для пользовательского диспетчера соединений

Бөлісу құралы: