Criando uma tarefa personalizada

Aplica-se a:SQL Server SSIS Integration Runtime em Azure Data Factory

As etapas envolvidas na criação de uma tarefa personalizada são semelhantes às etapas para criar qualquer outro objeto personalizado para o Integration Services:

• Crie uma nova classe que herda da classe base. Para uma tarefa, a classe base é Microsoft.SqlServer.Dts.Runtime.Task.

• Aplique o atributo que identifica o tipo de objeto à classe. Para uma tarefa, o atributo é DtsTaskAttribute.

• Substitua a implementação dos métodos e propriedades da classe base. Para uma tarefa, estes incluem os Validate métodos e Execute .

• Opcionalmente, desenvolva uma interface de usuário personalizada. Para uma tarefa, isso requer uma classe que implementa a IDtsTaskUI interface.

Introdução a uma tarefa personalizada

Criação de Projetos e Classes

Como todas as tarefas gerenciadas derivam da classe base Microsoft.SqlServer.Dts.Runtime.Task , a primeira etapa quando você cria uma tarefa personalizada é criar um projeto de biblioteca de classes em sua linguagem de programação gerenciada preferida e criar uma classe que herda da classe base. Nessa classe derivada, você substituirá os métodos e as propriedades da classe base para implementar sua funcionalidade personalizada.

Na mesma solução, crie um projeto de biblioteca de segunda classe para a interface do usuário personalizada. Um assembly separado para a interface do usuário é recomendado para facilitar a implantação, pois permite que você atualize e reimplante o gerenciador de conexões ou sua interface do usuário de forma independente.

Configure ambos os projetos para assinar os assemblies que serão gerados em tempo de compilação usando um arquivo de chave de nome forte.

Aplicando o atributo DtsTask

Aplique o DtsTaskAttribute atributo à classe que você criou para identificá-lo como uma tarefa. Este atributo fornece informações em tempo de design, como o nome, a descrição e o tipo de tarefa da tarefa.

Use a UITypeName propriedade para vincular a tarefa à sua interface de usuário personalizada. Para obter o token de chave pública necessário para essa propriedade, use sn.exe -t para exibir o token de chave pública do arquivo de par de chaves (.snk) que pretende usar para assinar o assembly da interface do usuário.

using System;  
using Microsoft.SqlServer.Dts.Runtime;  
namespace Microsoft.SSIS.Samples  
{  
  [DtsTask  
  (  
   DisplayName = "MyTask",  
   IconResource = "MyTask.MyTaskIcon.ico",  
   UITypeName = "My Custom Task," +  
   "Version=1.0.0.0," +  
   "Culture = Neutral," +  
   "PublicKeyToken = 12345abc6789de01",  
   TaskType = "PackageMaintenance",  
   TaskContact = "MyTask; company name; any other information",  
   RequiredProductLevel = DTSProductLevel.None  
   )]  
  public class MyTask : Task  
  {  
    // Your code here.  
  }  
}  

Imports System  
Imports Microsoft.SqlServer.Dts.Runtime  
  
<DtsTask(DisplayName:="MyTask", _  
 IconResource:="MyTask.MyTaskIcon.ico", _  
 UITypeName:="My Custom Task," & _  
 "Version=1.0.0.0,Culture=Neutral," & _  
 "PublicKeyToken=12345abc6789de01", _  
 TaskType:="PackageMaintenance", _  
 TaskContact:="MyTask; company name; any other information", _  
 RequiredProductLevel:=DTSProductLevel.None)> _  
Public Class MyTask  
  Inherits Task  
  
  ' Your code here.  
  
End Class 'MyTask  

Criando, implantando e depurando uma tarefa personalizada

As etapas para criar, implantar e depurar uma tarefa personalizada no Integration Services são semelhantes às etapas necessárias para outros tipos de objetos personalizados. Para obter mais informações, consulte Criando, implantando e depurando objetos personalizados.

Ver também

Criando uma tarefa personalizada
Codificando uma tarefa personalizada
Desenvolvendo uma interface de usuário para uma tarefa personalizada