Mengaktifkan Pengelogan Secara Terprogram

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

Mesin run-time menyediakan kumpulan LogProvider objek yang memungkinkan informasi khusus peristiwa diambil selama validasi dan eksekusi paket. LogProviderobjek tersedia untuk DtsContainer objek, termasuk TaskHostobjek , , PackageForLoop, dan ForEachLoop . Pengelogan diaktifkan pada kontainer individual, atau pada seluruh paket.

Ada beberapa jenis penyedia log yang tersedia untuk digunakan oleh kontainer. Ini memberikan fleksibilitas untuk membuat dan menyimpan informasi log dalam banyak format. Mendaftarkan objek kontainer dalam pengelogan adalah proses dua langkah: pengelogan pertama diaktifkan, lalu penyedia log dipilih. Properti LoggingOptions dan LoggingMode kontainer digunakan untuk menentukan peristiwa yang dicatat dan untuk memilih penyedia log.

Mengaktifkan Pengelogan

Properti LoggingMode , yang ditemukan di setiap kontainer yang dapat melakukan pengelogan, menentukan apakah informasi peristiwa kontainer direkam ke log peristiwa. Properti ini diberi nilai dari DTSLoggingMode struktur, dan diwarisi dari induk kontainer secara default. Jika kontainer adalah paket, dan karena itu tidak memiliki induk, properti menggunakan UseParentSetting, yang default ke Dinonaktifkan.

Memilih Penyedia Log

LoggingMode Setelah properti diatur ke Diaktifkan, penyedia log ditambahkan ke SelectedLogProviders kumpulan kontainer untuk menyelesaikan proses. Koleksi SelectedLogProviders tersedia pada LoggingOptions objek, dan berisi penyedia log yang dipilih untuk kontainer. Metode Add ini dipanggil untuk membuat penyedia dan menambahkannya ke koleksi. Metode kemudian mengembalikan penyedia log yang ditambahkan ke koleksi. Setiap penyedia memiliki pengaturan konfigurasi yang unik untuk penyedia tersebut ConfigString , dan properti ini diatur menggunakan properti .

Tabel berikut mencantumkan penyedia log yang tersedia, deskripsinya, dan informasinya ConfigString .

Peristiwa disertakan atau dikecualikan dari log peristiwa dengan mengatur properti EventFilterKind dan EventFilter kontainer. Struktur EventFilterKind berisi dua nilai, ExclusionFilter dan InclusionFilter, yang menunjukkan apakah peristiwa yang ditambahkan ke EventFilter disertakan dalam log peristiwa. Properti EventFilter kemudian diberi array string yang berisi nama peristiwa yang merupakan subjek pemfilteran.

Kode berikut memungkinkan pengelogan pada paket, menambahkan penyedia log untuk file Teks ke SelectedLogProviders koleksi, dan menentukan daftar peristiwa untuk disertakan dalam output pengelogan.

Sampel

using System;  
using Microsoft.SqlServer.Dts.Runtime;  
  
namespace Microsoft.SqlServer.Dts.Samples  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
      Package p = new Package();  
  
      ConnectionManager loggingConnection = p.Connections.Add("FILE");  
      loggingConnection.ConnectionString = @"C:\SSISPackageLog.txt";  
  
      LogProvider provider = p.LogProviders.Add("DTS.LogProviderTextFile.2");  
      provider.ConfigString = loggingConnection.Name;  
      p.LoggingOptions.SelectedLogProviders.Add(provider);  
      p.LoggingOptions.EventFilterKind = DTSEventFilterKind.Inclusion;  
      p.LoggingOptions.EventFilter = new String[] { "OnPreExecute",   
         "OnPostExecute", "OnError", "OnWarning", "OnInformation" };  
      p.LoggingMode = DTSLoggingMode.Enabled;  
  
      // Add tasks and other objects to the package.  
  
    }  
  }  
}  

Imports Microsoft.SqlServer.Dts.Runtime  
  
Module Module1  
  
  Sub Main()  
  
    Dim p As Package = New Package()  
  
    Dim loggingConnection As ConnectionManager = p.Connections.Add("FILE")  
    loggingConnection.ConnectionString = "C:\SSISPackageLog.txt"  
  
    Dim provider As LogProvider = p.LogProviders.Add("DTS.LogProviderTextFile.2")  
    provider.ConfigString = loggingConnection.Name  
    p.LoggingOptions.SelectedLogProviders.Add(provider)  
    p.LoggingOptions.EventFilterKind = DTSEventFilterKind.Inclusion  
    p.LoggingOptions.EventFilter = New String() {"OnPreExecute", _  
       "OnPostExecute", "OnError", "OnWarning", "OnInformation"}  
    p.LoggingMode = DTSLoggingMode.Enabled  
  
    ' Add tasks and other objects to the package.  
  
  End Sub  
  
End Module  

Lihat Juga

Pengelogan Integration Services (SSIS)