De eigenschappen van een gegevensstroomonderdeel instellen

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

Om de eigenschappen van datastroomcomponenten in te stellen, waaronder bronnen, bestemmingen en transformaties, gebruik je een van de volgende functies:

  • De componenteditors die Integration Services biedt. Deze editors bevatten alleen de aangepaste eigenschappen van elk datastroomcomponent.

  • Het Eigenschappen-venster geeft de componentniveau aangepaste eigenschappen van elk element weer weer, evenals de eigenschappen die gemeenschappelijk zijn voor alle dataflow-elementen.

  • Het Advanced Editor-dialoogvenster biedt toegang tot aangepaste eigenschappen voor elk component. Het Advanced Editor-dialoogvenster biedt ook toegang tot de eigenschappen die gemeenschappelijk zijn voor alle datastroomcomponenten: de eigenschappen van invoer, uitvoer, foutuitvoer, kolommen en externe kolommen.

Stel de eigenschappen van een datastroomcomponent in met een componenteditor

  1. Open in SQL Server Data Tools (SSDT) het Integration Services-project dat het gewenste pakket bevat.

  2. Dubbelklik in Solution Explorer op het pakket om het te openen.

  3. Klik op het tabblad Control Flow en dubbelklik vervolgens op de Gegevensstroom-taak die de data flow bevat met de component waarvan je de eigenschappen wilt bekijken en wijzigen.

  4. Dubbelklik op het gegevensstroomonderdeel.

  5. Bekijk of pas in de componenteneditor de eigenschappenwaarden aan en sluit vervolgens de editor.

  6. Als u het bijgewerkte pakket wilt opslaan, klikt u in het menu Bestand op Geselecteerde items opslaan.

Stel de eigenschappen van een datastroomcomponent in in het venster Eigenschappen

  1. Open in SQL Server Data Tools (SSDT) het Integration Services-project dat het gewenste pakket bevat.

  2. Dubbelklik in Solution Explorer op het pakket om het te openen.

  3. Klik op het tabblad Control Flow en dubbelklik vervolgens op de Gegevensstroom-taak die de component bevat waarvan je de eigenschappen wilt bekijken en wijzigen.

  4. Klik met de rechtermuisknop op het dataflow-component en klik vervolgens op Eigenschappen.

  5. Bekijk of wijzig de eigenschappenwaarden, en sluit dan het Eigenschappen-venster .

    Note

    Veel eigenschappen zijn alleen-leesbaar en kunnen niet worden gewijzigd.

  6. Als u het bijgewerkte pakket wilt opslaan, klikt u in het menu Bestand op Geselecteerde items opslaan.

Stel de eigenschappen van een datastroomcomponent in met de Geavanceerde editor

  1. Open in SQL Server Data Tools (SSDT) het Integration Services-project dat het gewenste pakket bevat.

  2. Dubbelklik in Solution Explorer op het pakket om het te openen.

  3. Klik op het tabblad Control Flow en dubbelklik vervolgens op de Gegevensstroom-taak die de component bevat die je wilt bekijken of wijzigen.

  4. Klik in de dataflow-ontwerper met de rechtermuisknop op de dataflowcomponent en klik vervolgens op Show Geavanceerde editor.

    Note

    In SQL Server kunnen datastroomcomponenten die meerdere invoer ondersteunen de Geavanceerde editor niet gebruiken.

  5. In het dialoogvenster Geavanceerde editor voert u een van de volgende stappen uit:

    • Om de verbinding die de component gebruikt te bekijken en te specificeren, klik je op het tabblad Connection Managers .

      Note

      Het tabblad Connection Managers is alleen beschikbaar voor datastroomcomponenten die verbindingsbeheerders gebruiken om verbinding te maken met databronnen zoals bestanden en databases

    • Om componentenniveau-eigenschappen te bekijken en aan te passen, klik op het tabblad Componenteigenschappen .

    • Om toewijzingen tussen externe kolommen en de beschikbare uitvoer te bekijken en te wijzigen, klik je op het tabblad Kolomtoewijzingen.

      Note

      Het tabblad Kolomafbeeldingen is alleen beschikbaar bij het bekijken of bewerken van bronnen of bestemmingen.

    • Om een lijst van de beschikbare invoerkolommen te bekijken en de namen van uitvoerkolommen bij te werken, klik je op het tabblad Invoerkolommen .

      Note

      Het tabblad Invoerkolommen is alleen beschikbaar bij het werken met transformaties of bestemmingen. Zie Integration Services-transformaties voor meer informatie.

    • Om de eigenschappen van invoer, uitvoer en foutuitvoer, en de eigenschappen van de kolommen die ze bevatten te bekijken en aan te passen, klik je op het tabblad Invoer- en Uitvoereigenschappen .

      Note

      Bronnen hebben geen input. Bestemmingen hebben geen output, behalve een optionele foutoutput.

  6. Bekijk of pas de vastgoedwaarden aan.

  7. Klik op OK.

  8. Als u het bijgewerkte pakket wilt opslaan, klikt u in het menu Bestand op Geselecteerde items opslaan.

Veelvoorkomende eigenschappen van datastroomcomponenten

De gegevensstroomobjecten in het objectmodel van Microsoft SQL Server Integration Services hebben gemeenschappelijke eigenschappen en aangepaste eigenschappen op componentniveau, op invoer- en uitvoerniveau en op invoerkolom- en uitvoerkolomniveau. Veel eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Dit onderwerp geeft een lijst van en beschrijft de gemeenschappelijke eigenschappen van dataflow-objecten.

Componenteigenschappen

In het Integration Services-objectmodel implementeert een component in de datastroom de IDTSComponentMetaData100 interface.

De volgende tabel beschrijft de eigenschappen van de componenten in een dataflow. Sommige eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Property Gegevenssoort Beschrijving
ComponentClassID Snaar / Touwtje De CLSID van de component.
ContactInfo Snaar / Touwtje Contactgegevens van de ontwikkelaar van een component.
Beschrijving Snaar / Touwtje De beschrijving van de datastroomcomponent. De standaardwaarde van deze eigenschap is de naam van de datastroomcomponent.
ID-kaart Integer Een waarde die deze instantie van de component uniek identificeert.
IdentificationString Snaar / Touwtje Identificeert het component.
IsDefaultLocale Boolean Geeft aan of de component de locatie van de Gegevensstroom-taak gebruikt waartoe het behoort.
LocaleID Integer De locatie die de datastroomcomponent gebruikt wanneer het pakket draait. Alle Windows-locaties zijn beschikbaar voor gebruik in dataflowcomponenten.
Name Snaar / Touwtje De naam van de datastroomcomponent.
PipelineVersion Integer De versie van de dataflow-taak waarin een component is ontworpen om te worden uitgevoerd.
Toepassingen en indelingen Boolean Geeft aan of een component een foutoutput heeft.
ValidateExternalMetadata Boolean Geeft aan of de metadata van externe kolommen gevalideerd is. De standaardwaarde van deze eigenschap is True.
Versie Integer De versie van een component.

Invoereigenschappen

In het Integratieservices-objectmodel hebben transformaties en bestemmingen invoer. Een invoer van een component in de datastroom implementeert de IDTSInput100 interface.

De volgende tabel beschrijft de eigenschappen van de invoer van componenten in een datastroom. Sommige eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Property Gegevenssoort Beschrijving
Beschrijving Snaar / Touwtje De beschrijving van de input.
ErrorOrTruncationOperation Snaar / Touwtje Een optionele string die specificeert welke soorten fouten of afkapjes kunnen optreden bij het verwerken van een rij.
ErrorRowDisposition DTSRowDisposition Een waarde die de afhandeling van fouten specificeert. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden.
HeeftBijwerkingen Boolean Geeft aan of een component uit het uitvoeringsplan van de gegevensstroom kan worden verwijderd wanneer deze niet is gekoppeld aan een volgende component en wanneer RunInOptimizedMode is true.
ID-kaart Integer Een waarde die de invoer uniek identificeert.
IdentificationString Snaar / Touwtje Een string die de invoer identificeert.
IsSorted Boolean Geeft aan of de data in de invoer gesorteerd is.
Name Snaar / Touwtje De naam van de invoer.
Bronlandinstelling Integer De locale ID (LCID) van de invoergegevens.
TruncationRowDisposition DTSRowDisposition Een waarde die bepaalt hoe de component omgaat met afkapingen die optreden bij het verwerken van rijen. . De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden.

Bestemmingen en sommige transformaties ondersteunen geen foutuitvoer, en de eigenschappen ErrorRowDisposition en TruncationRowDisposition van deze componenten zijn alleen-lezen.

Eigenschappen van de invoerkolom

In het Integration Services-objectmodel bevat een invoer een verzameling invoerkolommen. Een invoerkolom van een component in de datastroom implementeert de IDTSInputColumn100 interface.

De volgende tabel beschrijft de eigenschappen van de invoerkolommen van componenten in een datastroom. Sommige eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Property Gegevenssoort Beschrijving
ComparisonFlags Integer Een set vlaggen die de vergelijking specificeren van kolommen met een karakterdatatype. Zie Tekenreeksgegevens vergelijken voor meer informatie.
Beschrijving Snaar / Touwtje Beschrijft de invoerkolom.
ErrorOrTruncationOperation Snaar / Touwtje Een optionele string die specificeert welke soorten fouten of afkapjes kunnen optreden bij het verwerken van een rij.
ErrorRowDisposition DTSRowDisposition Een waarde die de afhandeling van fouten specificeert. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden.
ExternalMetadataColumnID IDTSExternalMetadataColumn100 De ID van de kolom externe metadata die aan een invoerkolom is toegewezen.
ID-kaart Integer Een waarde die de invoerkolom uniek identificeert.
IdentificationString Snaar / Touwtje Een string die de invoerkolom identificeert.
LineageID Integer De ID van de kolom stroomopwaarts.
LineageIdentificationString Snaar / Touwtje De identificatiestring die de naam van de bovenliggende kolom bevat.
Name Snaar / Touwtje De naam van de invoerkolom.
SortKeyPosition Integer Een waarde die aangeeft of een kolom gesorteerd is, de sorteervolgorde ervan en de volgorde waarin meerdere kolommen gesorteerd zijn. De waarde 0 geeft aan dat de kolom niet gesorteerd is. Zie Gegevens sorteren voor de samenvoegings- en samenvoegingstransformatiesvoor meer informatie.
TruncationRowDisposition DTSRowDisposition Een waarde die bepaalt hoe de component omgaat met afkapingen die optreden bij het verwerken van rijen. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden.
UpstreamComponentName Snaar / Touwtje De naam van het upstream-component.
Gebruikstype DTSUsageType Een waarde die bepaalt hoe een invoerkolom door de component wordt gebruikt.

Invoerkolommen bevatten ook de gegevenstype-eigenschappen die worden beschreven onder "Data Type Properties."

Uitvoereigenschappen

In het Integration Services-objectmodel hebben bronnen en transformaties output. Een output van een component in de dataflow implementeert de IDTSOutput100 interface.

De volgende tabel beschrijft de eigenschappen van de uitvoer van componenten in een datastroom. Sommige eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Property Gegevenssoort Beschrijving
DeleteOutputOnPathDetached Boolean Een waarde die bepaalt of de dataflow-engine de output verwijdert wanneer deze van een pad wordt losgekoppeld.
Beschrijving Snaar / Touwtje Beschrijft de output.
ErrorOrTruncationOperation Snaar / Touwtje Een optionele string die specificeert welke soorten fouten of afkapjes kunnen optreden bij het verwerken van een rij.
ErrorRowDisposition DTSRowDisposition Een waarde die de afhandeling van fouten specificeert. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden.
Uitsluitingsgroep Integer Een waarde die een groep wederzijds exclusieve uitgangen identificeert.
HeeftBijwerkingen Boolean Een waarde die aangeeft of een component uit het uitvoeringsplan van de gegevensstroom kan worden verwijderd wanneer deze niet aan een bovenliggende component is gekoppeld en wanneer RunInOptimizedModetrue is.
ID-kaart Integer Een waarde die de output uniek identificeert.
IdentificationString Snaar / Touwtje Een string die de output identificeert.
IsErrorOut Boolean Geeft aan of de output een foutuitvoer is.
IsSorted Boolean Geeft aan of de output gesorteerd is. De standaardwaarde is False.

** Belangrijk ** Het instellen van de waarde van de IsSorted-eigenschap op True sorteert de data niet. Deze eigenschap geeft slechts een hint aan downstream componenten dat de data eerder is gesorteerd. Zie Gegevens sorteren voor de samenvoegings- en samenvoegingstransformatiesvoor meer informatie.
Name Snaar / Touwtje De naam van het resultaat.
SynchronousInputID Integer De ID van een ingang die synchroon is aan de uitgang.
TruncationRowDisposition DTSRowDisposition Een waarde die bepaalt hoe de component omgaat met afkapingen die optreden bij het verwerken van rijen. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden.

Eigenschappen van de uitvoerkolom

In het Integration Services-objectmodel bevat een uitvoer een verzameling uitvoerkolommen. Een uitvoerkolom van een component in de dataflow implementeert de IDTSOutputColumn100 interface.

De volgende tabel beschrijft de eigenschappen van de uitvoerkolommen van componenten in een datastroom. Sommige eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Property Gegevenssoort Beschrijving
ComparisonFlags Integer Een set vlaggen die de vergelijking specificeren van kolommen met een karakterdatatype. Zie Tekenreeksgegevens vergelijken voor meer informatie.
Beschrijving Snaar / Touwtje Beschrijft de uitvoerkolom.
ErrorOrTruncationOperation Snaar / Touwtje Een optionele string die specificeert welke soorten fouten of afkapjes kunnen optreden bij het verwerken van een rij.
ErrorRowDisposition DTSRowDisposition Een waarde die de afhandeling van fouten specificeert. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden. De standaardwaarde is Fail-component.
ExternalMetadataColumnID Integer De ID van de kolom externe metadata die aan een invoerkolom is toegewezen.
ID-kaart Integer Een waarde die de uitvoerkolom uniek identificeert.
IdentificationString Snaar / Touwtje Een string die de uitvoerkolom identificeert.
LineageID Integer De ID van de uitvoerkolom. Downstream-componenten verwijzen naar de kolom door deze waarde te gebruiken.
LineageIdentificationString Snaar / Touwtje De identificatiestring die de naam van de kolom bevat.
Name Snaar / Touwtje De naam van de uitvoerkolom.
SortKeyPosition Integer Een waarde die aangeeft of een kolom gesorteerd is, de sorteervolgorde ervan en de volgorde waarin meerdere kolommen gesorteerd zijn. De waarde 0 geeft aan dat de kolom niet gesorteerd is. Zie Gegevens sorteren voor de samenvoegings- en samenvoegingstransformatiesvoor meer informatie.
SpecialFlags Integer Een waarde die de speciale vlaggen van de uitvoerkolom bevat.
TruncationRowDisposition DTSRowDisposition Een waarde die bepaalt hoe de component omgaat met afkapingen die optreden bij het verwerken van rijen. De waarden zijn Onderdeel laten mislukken, Fout negeren en Rij omleiden. De standaardwaarde is Fail-component.

Outputkolommen bevatten ook een set datatype-eigenschappen.

Kolomeigenschappen van externe metadata

In het Integration Services-objectmodel kunnen invoer en uitvoer een verzameling externe metadatakolommen bevatten. Een externe metadatakolom van een component in de dataflow implementeert de IDTSExternalMetadataColumn100 interface.

De volgende tabel beschrijft de eigenschappen van de externe metadatakolommen van componenten in een dataflow. Sommige eigenschappen hebben alleen-lezenwaarden die tijdens de uitvoering door de dataflow-engine worden toegewezen.

Property Gegevenssoort Beschrijving
Beschrijving Snaar / Touwtje Beschrijft de externe kolom.
ID-kaart Integer Een waarde die de kolom uniek identificeert.
IdentificationString Snaar / Touwtje Een tekenreeks die de kolom identificeert.
Name Snaar / Touwtje De naam van de buitenste zuil.

Externe metadatakolommen bevatten ook een set datatype-eigenschappen.

Eigenschappen van het datatype

Outputkolommen en externe metadatakolommen bevatten een set datatype-eigenschappen. Afhankelijk van het datatype van de kolom kunnen eigenschappen lezen/schrijven of alleen-lezen zijn.

De volgende tabel beschrijft de eigenschappen van het datatype van uitvoerkolommen en externe metadatakolommen.

Property Gegevenssoort Beschrijving
CodePage Integer Specificeert de codepagina voor stringgegevens die geen Unicode zijn.
Gegevenstype Integer (enumeratie) Het Integration Services-gegevenstype van de kolom. Zie Integration Services-gegevenstypen voor meer informatie.
Lengte Integer De lengte, gemeten in tekens, van een kolom.
Precision Integer De precisie van een numerieke kolom.
Schaal wijzigen Integer De schaal van een numerieke kolom.

Aangepaste eigenschappen van datastroomcomponenten

Voor informatie over aangepaste eigenschappen, zie de volgende onderwerpen

Gebruik een expressie in een dataflowcomponent.

Deze procedure beschrijft hoe een expressie kan worden toegevoegd aan de Conditional Split-transformatie of aan de Derived Column-transformatie. De Conditional Split-transformatie gebruikt expressies om de voorwaarden te definiëren die data-rijen naar een transformatie-output leiden, en de Derived Column-transformatie gebruikt expressies om waarden te definiëren die aan kolommen zijn toegewezen.

Om een expressie in een transformatie te implementeren, moet het pakket al minstens één Gegevensstroom-taak en een bron bevatten.

  1. Open in SQL Server Data Tools (SSDT) het Integration Services-project dat het gewenste pakket bevat.

  2. Dubbelklik in Solution Explorer op het pakket om het te openen.

  3. Klik in SSIS Designer op het tabblad Control Flow en vervolgens op de Gegevensstroom-taak die de data flow bevat waarin je een expressie wilt implementeren.

  4. Klik op het tabblad Gegevensstroom en sleep een transformatie van Conditional Split of Derived Column van de Toolbox naar het ontwerpoppervlak.

  5. Sleep de groene connector van de bron of een transformatie naar de Conditional Split- of de Derived Column-transformatie.

  6. Dubbelklik op de transformatie om het dialoogvenster te openen.

  7. Vouw in het linkerpaneel Variabelen uit om systeem- en door de gebruiker gedefinieerde variabelen weer te geven, en Kolommen om de transformatie-invoerkolommen weer te geven.

  8. Vouw in het rechterpaneel Wiskundige functies, stringfuncties, datum/tijdfuncties, NULL-functies, Type Casts en Operators uit om toegang te krijgen tot de functies, de casts en operatoren die de expressiegrammatica biedt.

  9. Afhankelijk van de transformatie kun je een van de volgende uitvoeren om een expressie te maken:

    • In het dialoogvenster Conditional Split Transformation Editor sleept u variabelen, kolommen, functies, operatoren en casts naar de kolom Conditie . Je kunt ook direct een expressie typen in de kolom Condition .

    • In het dialoogvak Derived Column Transformation Editor sleept u variabelen, kolommen, functies, operatoren en casts naar de kolom Expressie . Je kunt ook een expressie direct in de kolom Expressie typen.

      Note

      Wanneer je de focus uit de kolom Voorwaarde of de kolom Expressie verwijdert, kan de expressietekst worden gemarkeerd om aan te geven dat de expressiesyntaxis onjuist is.

  10. Klik op OK om het dialoogvenster te verlaten.

    Note

    Als de expressie niet geldig is, verschijnt er een waarschuwing die de syntaxisfouten in de expressie beschrijft.

Datastroomeigenschappen die je kunt instellen met een expressie

De waarden van bepaalde eigenschappen van data flow-objecten kunnen worden gespecificeerd door gebruik te maken van eigenschapsexpressies die beschikbaar zijn in de Gegevensstroom-taakcontainer.

Voor informatie over het gebruik van eigenschapsexpressies, zie Gebruik Eigenschapsexpressies in Pakketten.

Je kunt property-expressies gebruiken om configuraties aan te passen voor elke gedeployeerde instantie van een pakket. Je kunt ook property-expressies gebruiken om run-time constraints voor een pakket te specificeren door de /set-optie te gebruiken met de dtexec-opdrachtprompthulp . Je kunt bijvoorbeeld de MaximumThreads beperken die door de Sort-transformatie worden gebruikt, of de MaxMemoryUsage van de Fuzzy Grouping- en Fuzzy Lookup-transformaties. Als deze transformaties niet beperkt zijn, kunnen ze grote hoeveelheden data in het geheugen cachen.

Om een eigenschapsuitdrukking te specificeren voor een van de eigenschappen van data flow-objecten die in dit onderwerp worden vermeld, toont u het Properties-venster voor de Gegevensstroom-taak door de Gegevensstroom-taak te selecteren op het Control Flow-oppervlak van de designer, of door het tabblad Gegevensstroom van de designer te selecteren zonder een individuele component of pad te selecteren. Selecteer de eigenschap Expressions en klik op de ellips (...) om het dialoogvenster Property Expressions Editor te tonen. Selecteer een eigenschap uit de Property-dropdownlijst, typ vervolgens een expressie in het tekstvak Expressie, of klik op de ellips (...) om het Expression Builder-dialoogvenster te tonen.

De Property-lijst toont beschikbare eigenschappen alleen voor die data flow-objecten die je al op het Gegevensstroom-oppervlak van de designer hebt geplaatst. Daarom kun je de Property-lijst niet gebruiken om alle mogelijke eigenschappen van dataflow-objecten die property-expressies ondersteunen te bekijken. Als je bijvoorbeeld een ADO NET-bron op het ontwerperoppervlak hebt geplaatst, bevat de Property-lijst een vermelding voor de [ADO NET Source].[ SqlCommand] eigendom. De lijst toont ook veel eigenschappen van de Gegevensstroom-taak zelf.

De waarden van de eigenschappen in de volgende lijst kunnen worden gespecificeerd door gebruik te maken van eigenschapsexpressies.

Gegevensstroombronnen

Dataflow-object Property
ADO.NET-bron TableOrViewName-eigenschap

SqlCommand-eigenschap
XML-bron XMLData-eigenschap

XMLSchemaDefinition-eigenschap

Gegevensstroomtransformaties

Voor meer informatie over deze aangepaste eigenschappen, zie Transformatie Aangepaste Eigenschappen.

Dataflow-object Property
Voorwaardelijke splitstransformatie FriendlyExpression-eigenschap
Transformatie van afgeleide kolom FriendlyExpression-eigenschap
Fuzzy Grouping-transformatie MaxMemoryUsage-eigenschap
Fuzzy Lookup-transformatie MaxMemoryUsage-eigenschap
Lookup-transformatie SqlCommand-eigenschap

SqlCommandParam-eigenschap
OLE DB-opdrachttransformatie SqlCommand-eigenschap
Percentage steekproeftransformatie Eigenschap van de steekproefwaarde
Pivottransformatie Eigenschap PivotKeyValue
Row Sampling-transformatie SamplingValue-eigenschap
Sorteertransformatie MaximumThreads-eigenschap
Unpivot-transformatie PivotKeyValue-eigenschap

Datastroombestemmingen

Dataflow-object Property
ADO.NET-bestemming TableOrViewName-eigenschap

BatchSize-eigenschap

CommandTimeout-eigenschap
Bestemming voor plat bestand Header-eigenschap
SQL Server Compact bestemming TableName-eigenschap
SQL Server-bestemming eigenschap BulkInsertTableName

BulkInsertFirstRow eigenschap

BulkInsertLastRow-eigenschap

BulkInsertOrder-eigenschap

eigenschap Time-out