Taal

Een aangepaste logboekprovider maken

Van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De runtime-omgeving van de Integration Services beschikt over uitgebreide logmogelijkheden. Een log laat je gebeurtenissen vastleggen die plaatsvinden tijdens de uitvoering van pakketten. Integration Services omvat diverse logproviders die het mogelijk maken logs aan te maken en op te slaan in meerdere formaten, zoals XML, tekst, database of in het Windows-gebeurtenislogboek. Als een van deze providers of uitvoerformaten niet aan je behoeften voldoet, kun je een aangepaste logprovider aanmaken.

De stappen die nodig zijn bij het aanmaken van een custom log provider lijken op die voor het aanmaken van elk ander aangepast object voor Integration Services:

  • Maak een nieuwe klasse aan die erft van de basisklasse. Voor een logprovider is LogProviderBasede basisklasse .

  • Pas het attribuut toe dat het type object identificeert op de klasse. Voor een logprovider is DtsLogProviderAttributehet attribuut .

  • Overschrijf de implementatie van de methoden en eigenschappen van de basisklasse. Voor een logleverancier omvatten deze de ConfigString eigenschap en de OpenLog, Log, en CloseLog methoden.

  • Aangepaste gebruikersinterfaces voor custom logproviders zijn niet geïmplementeerd in SQL Server Integration Services.

Op de slag met een aangepaste logprovider

Projecten en Cursussen Creëren

Omdat alle beheerde logproviders van de LogProviderBase basisklasse afkomstig zijn, is de eerste stap bij het maken van een aangepaste logprovider het aanmaken van een class library-project in je favoriete beheerde programmeertaal, en vervolgens een klasse die erft van de basisklasse. In deze afgeleide klasse overschrijf je de methoden en eigenschappen van de basisklasse om je aangepaste functionaliteit te implementeren.

Configureer het project om de assembly te ondertekenen die gegenereerd zal worden met een bestand met een sterke naamsleutel.

Note

Veel log providers van Integration Services hebben een aangepaste gebruikersinterface die het tekstvak Configuratie in het venster 'SSIS logs configureren' implementeert IDtsLogProviderUI en vervangt door een gefilterde dropdownlijst met beschikbare verbindingsbeheerders. Aangepaste gebruikersinterfaces voor custom logproviders zijn echter niet geïmplementeerd in Integration Services.

Het toepassen van het attribuut DtsLogProvider

Pas het DtsLogProviderAttribute attribuut toe op de klasse die je hebt aangemaakt om deze als logprovider te identificeren. Dit attribuut levert ontwerptijd-informatie zoals de naam en beschrijving van de logprovider. De eigenschappen DisplayName en Description van het attribuut komen overeen met de kolommen Name en Description die worden weergegeven in de Configure SSIS Logs-editor, die wordt weergegeven bij het configureren van logging voor een pakket in SQL Server Data Tools (SSDT).

Important

De LogProviderType eigenschap van het attribuut wordt niet gebruikt. Je moet er echter een waarde voor invoeren, anders verschijnt de aangepaste logprovider niet in de lijst van beschikbare logproviders.

Note

Aangezien aangepaste gebruikersinterfaces voor custom logproviders niet zijn geïmplementeerd in Integration Services, heeft het specificeren van een waarde voor de UITypeName eigenschap van de DtsLogProviderAttribute geen effect.

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

Het bouwen, uitrollen en debuggen van een aangepaste logprovider

De stappen voor het bouwen, uitrollen en debuggen van een custom log provider in Integration Services lijken sterk op de stappen die nodig zijn voor andere soorten custom objects. Voor meer informatie, zie Bouwen, Uitrollen en Debuggen van Aangepaste Objecten.

Verwante onderwerpen

  • Last updated on