Scriptonderdeel

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

Het scriptonderdeel host script en stelt een pakket in staat om aangepaste scriptcode op te nemen en uit te voeren. U kunt het scriptonderdeel in pakketten gebruiken voor de volgende doeleinden:

• Meerdere transformaties toepassen op gegevens in plaats van meerdere transformaties in de gegevensstroom te gebruiken. Een script kan bijvoorbeeld de waarden in twee kolommen toevoegen en vervolgens het gemiddelde van de som berekenen.

• Toegang tot bedrijfsregels in een bestaande .NET-assembly. Een script kan bijvoorbeeld een bedrijfsregel toepassen waarmee het bereik van waarden wordt opgegeven dat geldig is in een kolom Inkomen .

• Gebruik aangepaste formules en functies naast de functies en operators die de grammatica van de Integration Services-expressie biedt. Valideer bijvoorbeeld creditcardnummers die gebruikmaken van de LUHN-formule.

• Valideer kolomgegevens en sla records over die ongeldige gegevens bevatten. Een script kan bijvoorbeeld de redelijkheid van een verzendkosten beoordelen en records met extreem hoge of lage bedragen overslaan.

Het scriptonderdeel biedt een eenvoudige en snelle manier om aangepaste functies in een gegevensstroom op te nemen. Als u echter van plan bent om de scriptcode in meerdere pakketten opnieuw te gebruiken, moet u overwegen om een aangepast onderdeel te programmeren in plaats van het scriptonderdeel te gebruiken. Zie Een aangepast gegevensstroomonderdeel ontwikkelen voor meer informatie.

Het scriptonderdeel kan worden gebruikt als een bron, een transformatie of een bestemming. Dit onderdeel ondersteunt één invoer en meerdere uitvoer. Afhankelijk van hoe het onderdeel wordt gebruikt, ondersteunt het een invoer of uitvoer of beide. Het script wordt aangeroepen door elke rij in de invoer of uitvoer.

• Als het scriptonderdeel wordt gebruikt als bron, ondersteunt het onderdeel Script meerdere uitvoer.

• Als dit wordt gebruikt als transformatie, ondersteunt het scriptonderdeel één invoer en meerdere uitvoer.

• Als dit wordt gebruikt als bestemming, ondersteunt het scriptonderdeel één invoer.

Het scriptonderdeel biedt geen ondersteuning voor foutuitvoer.

Nadat u hebt besloten dat het scriptonderdeel de juiste keuze is voor uw pakket, moet u de invoer en uitvoer configureren, het script ontwikkelen dat het onderdeel gebruikt en het onderdeel zelf configureren.

Informatie over de modi voor scriptonderdelen

In de SSIS Designer heeft het scriptonderdeel twee modi: de modus metagegevensontwerp en de codeontwerpmodus. In de modus metagegevensontwerp kunt u de invoer en uitvoer van het scriptonderdeel toevoegen en wijzigen, maar u kunt geen code schrijven. Nadat alle invoer en uitvoer zijn geconfigureerd, schakelt u over naar de codeontwerpmodus om het script te schrijven. Het scriptonderdeel genereert automatisch basiscode op basis van de metagegevens van de invoer en uitvoer. Als u de metagegevens wijzigt nadat het scriptonderdeel de basiscode heeft gegenereerd, wordt de code mogelijk niet meer gecompileerd omdat de bijgewerkte basiscode mogelijk niet compatibel is met uw code.

Het script schrijven dat door het onderdeel wordt gebruikt

Het scriptonderdeel maakt gebruik van Microsoft Visual Studio Tools for Applications (VSTA) als de omgeving waarin u de scripts schrijft. U opent VSTA vanuit de Script Transformation Editor.

Het scriptonderdeel biedt een VSTA-project met een automatisch gegenereerde klasse met de naam ScriptMain, die de metagegevens van het onderdeel vertegenwoordigt. Als het scriptonderdeel bijvoorbeeld wordt gebruikt als een transformatie met drie uitvoerwaarden, bevat ScriptMain een methode voor elke uitvoer. ScriptMain is het toegangspunt voor het script.

VSTA bevat alle standaardfuncties van de Visual Studio-omgeving, zoals de in kleur gecodeerde Visual Studio-editor, IntelliSense en ObjectBrowser. Het script dat door het scriptonderdeel wordt gebruikt, wordt opgeslagen in de pakketdefinitie. Wanneer u het pakket ontwerpt, wordt de scriptcode tijdelijk naar een projectbestand geschreven.

VSTA ondersteunt de programmeertalen Microsoft Visual C# en Microsoft Visual Basic.

Zie De gegevensstroom uitbreiden met het scriptonderdeel voor informatie over het programmeren van het scriptonderdeel. Zie Specifieke typen scriptonderdelen ontwikkelen voor meer specifieke informatie over het configureren van het scriptonderdeel als bron, transformatie of bestemming. Zie Aanvullende voorbeelden van scriptonderdelen voor aanvullende voorbeelden, zoals een ODBC-bestemming die het gebruik van het scriptonderdeel demonstreren.

Het scriptonderdeel configureren

U kunt het scriptonderdeel op de volgende manieren configureren:

• Selecteer de invoerkolommen waarnaar u wilt verwijzen.

  Opmerking

  U kunt slechts één invoer configureren wanneer u SSIS Designer gebruikt.

• Geef het script op dat door het onderdeel wordt uitgevoerd.

• Geef de scripttaal op.

• Geef door komma's gescheiden lijsten met alleen-lezen en lezen/schrijven-variabelen op.

• Voeg meer uitvoer toe en voeg uitvoerkolommen toe waaraan het script waarden toewijst.

U kunt eigenschappen instellen via SSIS Designer of programmatisch.

Het scriptonderdeel configureren in de ontwerpfunctie

Klik op het volgende onderwerp voor meer informatie over het instellen van deze eigenschappen in SSIS Designer:

• de eigenschappen van een gegevensstroomonderdeel instellen

Het scriptonderdeel programmatisch configureren

Klik op een van de volgende onderwerpen voor meer informatie over de eigenschappen die u kunt instellen in het venster Eigenschappen of programmatisch:

• algemene eigenschappen

• Aangepaste eigenschappen transformeren

Klik op een van de volgende onderwerpen voor meer informatie over het instellen van eigenschappen:

• de eigenschappen van een gegevensstroomonderdeel instellen

Type van scriptonderdeel selecteren

Gebruik het dialoogvenster Type scriptonderdeel selecteren om op te geven of u een scripttransformatie wilt maken die vooraf is geconfigureerd voor gebruik als bron, transformatie of bestemming.

Zie Het scriptonderdeel configureren in de scriptonderdeeleditor voor meer informatie over het scriptonderdeel. Zie De gegevensstroom uitbreiden met het scriptonderdeel voor meer informatie over het programmeren van het scriptonderdeel.

Opties

Uw selectie van bron, doel of transformatie is van invloed op de configuratie van de scripttransformatie en de pagina's van de Script Transformation Editor.

Script Transformatie-editor (Pagina Verbindingsmanagers)

Gebruik de pagina Verbindingsbeheer van de scripttransformatie-editor om verbindingen op te geven die door het script worden gebruikt.

Zie Het scriptonderdeel configureren in de scriptonderdeeleditor voor meer informatie over het scriptonderdeel. Zie De gegevensstroom uitbreiden met het scriptonderdeel voor meer informatie over het programmeren van het scriptonderdeel.

Opties

Verbindingsbeheerders
Bekijk de lijst met verbindingen die beschikbaar zijn voor gebruik door het script.

Naam
Typ een unieke en beschrijvende naam voor de verbinding.

Verbindingsbeheer
Selecteer in de lijst met beschikbare verbindingsmanagers of selecteer <Nieuwe verbinding> om het dialoogvenster SSIS-verbindingsbeheer toevoegen te openen.

Beschrijving
Typ een beschrijving voor de verbinding.

Toevoegen
Voeg nog een verbinding toe aan de lijst verbindingsbeheerders .

verwijderen
Verwijder de geselecteerde verbinding uit de lijst verbindingsbeheerders .

Scripttransformatie-editor (Invoerkolommenpagina)

Gebruik de pagina Invoerkolommen van het dialoogvenster Scripttransformatieeditor om eigenschappen in te stellen voor invoerkolommen.

Zie Het scriptonderdeel configureren in de scriptonderdeeleditor voor meer informatie over het scriptonderdeel. Zie De gegevensstroom uitbreiden met het scriptonderdeel voor meer informatie over het programmeren van het scriptonderdeel.

Opties

Invoernaam
Selecteer een optie in de lijst met beschikbare invoer.

Beschikbare invoerkolommen
Geef met behulp van de selectievakjes de kolommen op die door de scripttransformatie worden gebruikt.

Invoerkolom
Selecteer in de lijst met beschikbare invoerkolommen voor elke rij. Uw selecties worden weergegeven in de selectievakjes in de tabel Beschikbare invoerkolommen .

Uitvoeralias
Typ een alias voor elke uitvoerkolom. De standaardwaarde is de naam van de invoerkolom; U kunt echter elke unieke, beschrijvende naam kiezen.

Gebruikstype
Geef op of de scripttransformatie elke kolom als ReadOnly of ReadWrite behandelt.

ScriptTransformatie-editor (pagina Invoer en Uitvoer)

Gebruik de pagina Invoer en uitvoer van het dialoogvenster Scripttransformatieeditor om invoer en uitvoer toe te voegen, te verwijderen en te configureren voor de scripttransformatie.

Zie Het scriptonderdeel configureren in de scriptonderdeeleditor voor meer informatie over het scriptonderdeel. Zie De gegevensstroom uitbreiden met het scriptonderdeel voor meer informatie over het programmeren van het scriptonderdeel.

Opties

Invoer en uitvoer
Selecteer een invoer of uitvoer aan de linkerkant om de eigenschappen ervan weer te geven in de tabel aan de rechterkant. De beschikbare eigenschappen voor bewerken variëren afhankelijk van de selectie. Veel van de weergegeven eigenschappen zijn alleen voor lezen. Zie de volgende onderwerpen voor meer informatie over de afzonderlijke eigenschappen.

algemene eigenschappen

Aangepaste eigenschappen transformeren

Uitvoer toevoegen
Voeg een extra uitvoer toe aan de lijst.

Kolom toevoegen
Selecteer een map waarin u de nieuwe uitvoerkolom wilt plaatsen en voeg vervolgens de kolom toe door op Kolom toevoegen te klikken.

Uitvoer verwijderen
Selecteer een uitvoer en verwijder deze door op Uitvoer verwijderen te klikken.

Kolom verwijderen
Selecteer een kolom en verwijder deze vervolgens door op Kolom verwijderen te klikken.

Scripttransformatie Editor (Scriptpagina)

Gebruik het tabblad Script van het dialoogvenster Scripttransformatieeditor om een script en gerelateerde eigenschappen op te geven.

Zie Het scriptonderdeel configureren in de scriptonderdeeleditor voor meer informatie over het scriptonderdeel. Zie De gegevensstroom uitbreiden met het scriptonderdeel voor meer informatie over het programmeren van het scriptonderdeel.

Opties

Eigenschappen
De eigenschappen van de scripttransformatie weergeven en wijzigen. Veel van de weergegeven eigenschappen zijn alleen voor lezen. U kunt de volgende eigenschappen wijzigen:

Script bewerken
Gebruik Microsoft Visual Studio Tools for Applications (VSTA) om een script te maken of te wijzigen.

Verwante inhoud

Integration Services-transformaties

De gegevensstroom uitbreiden met het scriptonderdeel