Membuat Penyedia Log Kustom

  • Artikel

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

Lingkungan run-time Integration Services memiliki kemampuan pengelogan yang luas. Log memungkinkan Anda menangkap peristiwa yang terjadi selama eksekusi paket. Layanan Integrasi mencakup berbagai penyedia log yang memungkinkan log dibuat dan disimpan dalam beberapa format, seperti XML, teks, database, atau di log peristiwa Windows. Jika salah satu penyedia atau format output ini tidak sesuai dengan kebutuhan Anda, Anda dapat membuat penyedia log kustom.

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

  • Buat kelas baru yang mewarisi dari kelas dasar. Untuk penyedia log, kelas dasarnya adalah LogProviderBase.

  • Terapkan atribut yang mengidentifikasi jenis objek ke kelas . Untuk penyedia log, atributnya adalah DtsLogProviderAttribute.

  • Mengambil alih implementasi metode dan properti kelas dasar. Untuk penyedia log, ini termasuk ConfigString properti dan OpenLogmetode , Log, dan CloseLog .

  • Antarmuka pengguna kustom untuk penyedia log kustom tidak diterapkan di SQL Server Integration Services.

Memulai Penyedia Log Kustom

Membuat Proyek dan Kelas

Karena semua penyedia log terkelola berasal dari LogProviderBase kelas dasar, langkah pertama saat Anda membuat penyedia log kustom adalah membuat proyek pustaka kelas dalam bahasa pemrograman terkelola pilihan Anda, lalu 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.

Konfigurasikan proyek untuk menandatangani rakitan yang akan dihasilkan dengan file kunci nama yang kuat.

Catatan

Banyak penyedia log Layanan Integrasi memiliki antarmuka pengguna kustom yang mengimplementasikan IDtsLogProviderUI dan mengganti kotak teks Konfigurasi dalam kotak dialog Konfigurasi Log SSIS dengan daftar dropdown yang difilter dari manajer koneksi yang tersedia. Namun antarmuka pengguna kustom untuk penyedia log kustom tidak diimplementasikan di Integration Services.

Menerapkan Atribut DtsLogProvider

Terapkan DtsLogProviderAttribute atribut ke kelas yang telah Anda buat untuk mengidentifikasinya sebagai penyedia log. Atribut ini menyediakan informasi waktu desain seperti nama dan deskripsi penyedia log. Properti DisplayName dan Description atribut sesuai dengan kolom Nama dan Deskripsi yang ditampilkan di editor Konfigurasi Log SSIS, yang ditampilkan saat mengonfigurasi pengelogan untuk paket di SQL Server Data Tools (SSDT).

Penting

Properti LogProviderType atribut tidak digunakan. Namun, Anda harus memasukkan nilai untuk itu, atau penyedia log kustom tidak akan muncul dalam daftar penyedia log yang tersedia.

Catatan

Karena antarmuka pengguna kustom untuk penyedia log kustom tidak diimplementasikan di Layanan Integrasi, menentukan nilai untuk UITypeName properti tidak DtsLogProviderAttribute berpengaruh.

<DtsLogProvider(DisplayName:="MyLogProvider", Description:="A simple log provider.", LogProviderType:="Custom")> _  
Public Class MyLogProvider  
     Inherits LogProviderBase  
    ' TODO: Override the base class methods.  
End Class  

[DtsLogProvider(DisplayName="MyLogProvider", Description="A simple log provider.", LogProviderType="Custom")]  
public class MyLogProvider : LogProviderBase  
{  
    // TODO: Override the base class methods.  
}

Membangun, Menyebarkan, dan Men-debug Penyedia Log Kustom

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

Lihat juga

Mengodekan Penyedia Log Kustom
Mengembangkan Antarmuka Pengguna untuk Penyedia Log Kustom