Språk

Skapa en anpassad loggleverantör

Gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

Integration Services körtidsmiljö har omfattande loggningsmöjligheter. En logg låter dig fånga händelser som inträffar under paketexekveringen. Integration Services inkluderar en mängd loggleverantörer som möjliggör att loggar kan skapas och lagras i flera format, såsom XML, text, databas eller i Windows händelselogg. Om någon av dessa leverantörer eller utdataformat inte passar dina behov kan du skapa en anpassad loggleverantör.

Stegen som ingår i att skapa en anpassad loggleverantör liknar stegen för att skapa vilket annat specialanpassat objekt som helst för Integration Services:

  • Skapa en ny klass som ärver från basklassen. För en loggleverantör är LogProviderBasebasklassen .

  • Applicera attributet som identifierar objekttypen på klassen. För en loggleverantör är DtsLogProviderAttributeattributet .

  • Överstyr implementeringen av basklassens metoder och egenskaper. För en timmerleverantör inkluderar dessa egenskapen ConfigString och OpenLog, Log, och CloseLog metoderna.

  • Anpassade användargränssnitt för anpassade loggleverantörer är inte implementerade i služba SSIS.

Kom igång med en anpassad loggleverantör

Skapa projekt och klasser

Eftersom alla hanterade loggleverantörer härstammar LogProviderBase från basklassen är det första steget när du skapar en anpassad loggleverantör att skapa ett klassbiblioteksprojekt i ditt föredragna hanterade programmeringsspråk och sedan skapa en klass som ärver från basklassen. I denna härledda klass kommer du att åsidosätta metoderna och egenskaperna hos basklassen för att implementera din anpassade funktionalitet.

Konfigurera projektet att signera assembleringen som ska genereras med en stark namnnyckelfil.

Note

Många loggleverantörer för Integration Services har ett anpassat användargränssnitt som implementerar IDtsLogProviderUI och ersätter textrutan Konfiguration i dialogrutan Konfigurera SSIS-loggar med en filtrerad rullgardinslista över tillgängliga anslutningshanterare. Dock är anpassade användargränssnitt för anpassade loggleverantörer inte implementerade i Integration Services.

Tillämpning av attributet DtsLogProvider

Använd attributet DtsLogProviderAttribute på den klass du har skapat för att identifiera den som en loggleverantör. Denna attribut tillhandahåller designtidsinformation såsom namn och beskrivning av loggleverantören. Attributets egenskaper DisplayName och Description motsvarar Namn- och Beskrivningskolumnerna som visas i Configure SSIS Logs-editorn, vilket visas vid konfiguration av loggning för ett paket i SQL Server Data Tools (SSDT).

Important

Egenskapen LogProviderType attributet används inte. Du måste dock ange ett värde för den, annars kommer den anpassade loggleverantören inte att visas i listan över tillgängliga loggleverantörer.

Note

Eftersom anpassade användargränssnitt för anpassade loggleverantörer inte implementeras i Integration Services, har det ingen effekt att specificera ett värde för UITypeName egenskapen för egenskapen DtsLogProviderAttribute .

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

Bygga, distribuera och felsöka en anpassad loggleverantör

Stegen för att bygga, distribuera och felsöka en anpassad loggleverantör i Integration Services är mycket lika de steg som krävs för andra typer av anpassade objekt. För mer information, se Bygga, distribuera och felsöka anpassade objekt.

Relaterat innehåll

  • Uppdaterades senast