Membuat Tugas Kustom

Artikel
05/23/2023

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Langkah-langkah yang terlibat dalam membuat tugas kustom mirip dengan langkah-langkah untuk membuat objek kustom lainnya untuk Layanan Integrasi:

Buat kelas baru yang mewarisi dari kelas dasar. Untuk tugas, kelas dasarnya adalah Microsoft.SqlServer.Dts.Runtime.Task.
Terapkan atribut yang mengidentifikasi jenis objek ke kelas . Untuk tugas, atributnya adalah DtsTaskAttribute.
Mengambil alih implementasi metode dan properti kelas dasar. Untuk tugas, ini termasuk Validate metode dan Execute .
Secara opsional, kembangkan antarmuka pengguna kustom. Untuk tugas, ini memerlukan kelas yang mengimplementasikan IDtsTaskUI antarmuka.

Memulai Tugas Kustom

Membuat Proyek dan Kelas

Karena semua tugas terkelola berasal dari kelas dasar Microsoft.SqlServer.Dts.Runtime.Task , langkah pertama saat Anda membuat tugas kustom adalah membuat proyek pustaka kelas dalam bahasa pemrograman terkelola pilihan Anda dan membuat kelas yang mewarisi dari kelas dasar. Di kelas turunan ini Anda akan mengambil alih metode dan properti kelas dasar untuk mengimplementasikan fungsionalitas kustom Anda.

Dalam solusi yang sama, buat proyek pustaka kelas kedua untuk antarmuka pengguna kustom. Rakitan terpisah untuk antarmuka pengguna disarankan untuk kemudahan penyebaran karena memungkinkan Anda memperbarui dan menyebarkan ulang manajer koneksi atau antarmuka penggunanya secara independen.

Konfigurasikan kedua proyek untuk menandatangani rakitan yang akan dihasilkan pada waktu build dengan menggunakan file kunci nama yang kuat.

Menerapkan Atribut DtsTask

Terapkan DtsTaskAttribute atribut ke kelas yang telah Anda buat untuk mengidentifikasinya sebagai tugas. Atribut ini menyediakan informasi waktu desain seperti nama, deskripsi, dan jenis tugas tugas.

UITypeName Gunakan properti untuk menautkan tugas ke antarmuka pengguna kustomnya. Untuk mendapatkan token kunci publik yang diperlukan untuk properti ini, Anda menggunakan sn.exe -t untuk menampilkan token kunci publik dari file pasangan kunci (.snk) yang ingin Anda gunakan untuk menandatangani rakitan antarmuka pengguna.

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

Membangun, Menyebarkan, dan Men-debug Tugas Kustom

Langkah-langkah untuk membangun, menyebarkan, dan men-debug tugas kustom di Integration Services mirip dengan langkah-langkah yang diperlukan untuk jenis objek kustom lainnya. Untuk informasi selengkapnya, lihat Membangun, Menyebarkan, dan Men-debug Objek Kustom.

Lihat juga

Membuat Tugas Kustom
Mengodekan Tugas Kustom
Mengembangkan Antarmuka Pengguna untuk Tugas Kustom

Bagikan melalui