Integratiedienstencontainers
van toepassing op:SQL Server
SSIS Integration Runtime in Azure Data Factory
Containers zijn objecten in SQL Server Integration Services die structuur bieden aan pakketten en services voor taken. Ze ondersteunen herhalende controlestromen in pakketten en groeperen taken en containers in zinvolle werkeenheden. Containers kunnen naast taken ook andere containers bevatten.
Pakketten gebruiken containers voor de volgende doeleinden:
Herhaal taken voor elk element in een verzameling, zoals bestanden in een map, schema's of SMO-objecten (SQL Server Management Objects). Een pakket kan bijvoorbeeld Transact-SQL instructies uitvoeren die zich in meerdere bestanden bevinden.
Herhaal taken totdat een opgegeven voorwaarde resulteert in onwaar. Een pakket kan bijvoorbeeld zeven keer een ander e-mailbericht verzenden, één keer voor elke dag van de week.
Groepeer taken en containers die moeten slagen of mislukken als een eenheid. Een pakket kan bijvoorbeeld taken groeperen die rijen in een databasetabel verwijderen en toevoegen, en vervolgens alle taken doorvoeren of terugdraaien wanneer één mislukt.
Containertypen
Integration Services biedt vier typen containers voor het bouwen van pakketten. De volgende tabel bevat de containertypen.
Opslagbak | Beschrijving |
---|---|
Foreach Loop Container | Voert herhaaldelijk een controlestroom uit met behulp van een enumerator. |
For Loop Container | Voert een controlestroom herhaaldelijk uit door een voorwaarde te testen. |
Sequence Container | Groepeert taken en containers in besturingsstromen die subsets van de pakketbeheerstroom zijn. |
taakhostcontainer | Biedt services voor één taak. |
Pakketten en gebeurtenis-handlers zijn ook typen containers. Zie SSIS-pakketten (Integration Services) en SSIS-gebeurtenis-handlers (Integration Services)voor meer informatie.
Samenvatting van containereigenschappen
Alle containertypen hebben een set eigenschappen die gemeenschappelijk zijn. Als u pakketten maakt met behulp van de grafische hulpprogramma's die Integration Services biedt, worden in het venster Eigenschappen de volgende eigenschappen weergegeven voor de Foreach-lus, For Loop en Sequence-containers. De containereigenschappen van de taakhost worden geconfigureerd als onderdeel van het configureren van de taak die door de taakhost wordt ingekapseld. U stelt de eigenschappen van de taakhost in wanneer u de taak configureert.
Eigenschap | Beschrijving |
---|---|
DelayValidation- | Een Booleaanse waarde die aangeeft of de validatie van de container wordt vertraagd tot de uitvoeringstijd. De standaardwaarde voor deze eigenschap is False. Zie DelayValidationvoor meer informatie. |
Beschrijving | De containerbeschrijving. De eigenschap bevat een string, maar kan leeg zijn. Zie Descriptionvoor meer informatie. |
Schakel uit | Een Booleaanse waarde die aangeeft of de container draait. De standaardwaarde voor deze eigenschap is False. Zie Disablevoor meer informatie. |
DisableEventHandlers | Een Booleaanse waarde die aangeeft of de aan de container gekoppelde evenementhandlers worden uitgevoerd. De standaardwaarde voor deze eigenschap is False. |
FailPackageOnFailure- | Een Booleaanse waarde die aangeeft of het pakket mislukt als er een fout optreedt in de container. De standaardwaarde voor deze eigenschap is False. Zie FailPackageOnFailurevoor meer informatie. |
FailParentOnFailure- | Een Booleaanse waarde die aangeeft of de bovenliggende container mislukt als er een fout optreedt in de container. De standaardwaarde voor deze eigenschap is False. Zie FailParentOnFailurevoor meer informatie. |
ForcedExecutionValue | Als ForceExecutionValue is ingesteld op True, betreft dit het object dat de optionele uitvoeringswaarde voor de container bevat. De standaardwaarde van deze eigenschap is 0. Zie ForcedExecutionValuevoor meer informatie. |
ForcedExecutionValueType | Het gegevenstype van ForcedExecutionValue. De standaardwaarde van deze eigenschap is Int32. |
ForceExecutionResult- | Een waarde die het geforceerde resultaat aangeeft van het uitvoeren van het pakket of de container. De waarden zijn Geen, Succes, Mislukkingen Voltooiing. De standaardwaarde voor deze eigenschap is Geen. Zie ForceExecutionResultvoor meer informatie. |
ForceExecutionValue | Een Booleaanse waarde die aangeeft of de optionele uitvoeringswaarde van de container een bepaalde waarde moet bevatten. De standaardwaarde van deze eigenschap is False. Zie ForceExecutionValuevoor meer informatie. |
ID | De container-GUID, die wordt toegewezen wanneer het pakket wordt gemaakt. Deze eigenschap is alleen-lezen. ID. |
IsolationLevel | Het isolatieniveau van de containertransactie. De waarden zijn Niet-opgegeven, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializableen Snapshot. De standaardwaarde van deze eigenschap is serialiseerbare. Zie IsolationLevelvoor meer informatie. |
LocaleID | Een Microsoft Win32-landinstelling. De standaardwaarde van deze eigenschap is de landinstelling van het besturingssysteem op de lokale computer. Zie LocaleIDvoor meer informatie. |
LoggingMode | Een waarde die het logboekgedrag van de container aangeeft. De waarden zijn Uitgeschakeld, Ingeschakelden OuderInstellingGebruiken. De standaardwaarde van deze eigenschap is UseParentSetting. Zie DTSLoggingModevoor meer informatie. |
MaximumErrorCount | Het maximum aantal fouten dat kan optreden voordat een container stopt met draaien. De standaardwaarde van deze eigenschap is 1. Zie MaximumErrorCountvoor meer informatie. |
naam | De naam van de container. Zie Namevoor meer informatie. |
TransactionOption | De transactionele deelname van de container. De waarden zijn Niet ondersteund, Ondersteund, Vereist. De standaardwaarde van deze eigenschap is Ondersteund. Zie DTSTransactionOptionvoor meer informatie. |
Zie de volgende onderwerpen over de Integration Services-API voor meer informatie over alle eigenschappen die beschikbaar zijn voor Foreach-lus,For Loop-, Sequence- en Task Host-containers wanneer u deze programmatisch configureert:
T:Microsoft.SqlServer.Dts.Runtime.ForEachLoop
T:Microsoft.SqlServer.Dts.Runtime.ForLoop
T:Microsoft.SqlServer.Dts.Runtime.Sequence
T:Microsoft.SqlServer.Dts.Runtime.TaskHost
Objecten die containerfunctionaliteit uitbreiden
Containers bevatten besturingsstromen die bestaan uit uitvoerbare bestanden en prioriteitsbeperkingen, en kunnen gebeurtenis-handlers en variabelen gebruiken. De hostcontainer van de taak is een uitzondering: omdat de taakhostcontainer één taak inkapselt, wordt geen prioriteitsbeperkingen gebruikt.
Uitvoerbare bestanden
Uitvoerbare elementen verwijzen naar de taken op containerniveau en eventuele containers binnen de container. Een uitvoerbaar bestand kan een van de taken en containers zijn die Integration Services biedt of een aangepaste taak. Zie Integration Services Tasksvoor meer informatie.
Prioriteitsbeperkingen
Prioriteitsbeperkingen koppelen containers en taken binnen dezelfde bovenliggende container aan een geordende controlestroom. Zie prioriteitsbeperkingenvoor meer informatie.
Gebeurtenishandlers
Gebeurtenis-handlers op containerniveau reageren op gebeurtenissen die zijn gegenereerd door de container of de objecten die erin zijn opgenomen. Voor meer informatie, zie Integration Services (SSIS) gebeurtenishandlers.
Variabelen
Variabelen die in containers worden gebruikt, omvatten de systeemvariabelen op containerniveau die Integration Services biedt en de door de gebruiker gedefinieerde variabelen die door de container worden gebruikt. Zie SSIS-variabelen (Integration Services)voor meer informatie.
Onderbrekingspunten
Wanneer u een onderbrekingspunt instelt voor een container en de onderbrekingsvoorwaarde wordt Break wanneer de container de gebeurtenis OnVariableValueChanged ontvangt, definieert u de variabele in het containerbereik.