Ange egenskaper för en dataflödeskomponent

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

För att ange egenskaperna hos dataflödeskomponenter, som inkluderar källor, destinationer och transformationer, använd en av följande funktioner:

  • De komponentredigerare som Integration Services tillhandahåller. Dessa redigerare inkluderar endast de anpassade egenskaperna för varje dataflödeskomponent.

  • Fönstret Egenskaper listar de anpassade komponentnivå-egenskaperna för varje element, samt de egenskaper som är gemensamma för alla dataflödeselement.

  • Advanced Editor-dialogrutan ger tillgång till anpassade egenskaper för varje komponent. Advanced Editor-dialogrutan ger också tillgång till de egenskaper som är gemensamma för alla dataflödeskomponenter – egenskaper för indata, utdata, felutdata, kolumner och externa kolumner.

Sätt egenskaperna för en dataflödeskomponent med en komponentredigerare

  1. I SQL Server Data Tools (SSDT) öppnar du projektet Integration Services som innehåller det paket du vill ha.

  2. Dubbelklicka på paketet i Prieskumník riešení för att öppna det.

  3. Klicka på fliken Control Flow och dubbelklicka sedan på Data Flow-uppgiften som innehåller data flow med den komponent vars egenskaper du vill visa och ändra.

  4. Dubbelklicka på dataflödeskomponenten.

  5. I komponentredigeraren, visa eller ändra egenskapsvärdena och stäng sedan redigeraren.

  6. Spara det uppdaterade paketet genom att klicka på Spara markerade objekt på Arkiv-menyn.

Sätt egenskaperna för en dataflödeskomponent i Properties window

  1. I SQL Server Data Tools (SSDT) öppnar du projektet Integration Services som innehåller det paket du vill ha.

  2. Dubbelklicka på paketet i Prieskumník riešení för att öppna det.

  3. Klicka på fliken Control Flow och dubbelklicka sedan på Data Flow-uppgiften som innehåller den komponent vars egenskaper du vill visa och ändra.

  4. Högerklicka på dataflödeskomponenten och sedan på Egenskaper.

  5. Visa eller ändra egenskapsvärdena, och stäng sedan Egenskapsfönstret .

    Note

    Många egenskaper är skrivskyddade och kan inte ändras.

  6. Spara det uppdaterade paketet genom att klicka på Spara markerade objekt på Arkiv-menyn.

Sätt egenskaperna för en dataflödeskomponent med Rozšírený editor

  1. I SQL Server Data Tools (SSDT) öppnar du projektet Integration Services som innehåller det paket du vill ha.

  2. Dubbelklicka på paketet i Prieskumník riešení för att öppna det.

  3. Klicka på fliken Control Flow och dubbelklicka sedan på Data Flow-uppgiften som innehåller komponenten du vill visa eller ändra.

  4. I dataflödesdesignern, högerklicka på dataflödeskomponenten och klicka sedan på Show Rozšírený editor.

    Note

    I SQL Server kan dataflödeskomponenter som stödjer flera indata inte använda Rozšírený editor.

  5. I dialogrutan Rozšírený editor, gör något av följande steg:

    • För att se och specificera anslutningen som komponenten använder, klicka på fliken Anslutningshanterare .

      Note

      Fliken Connection Managers är endast tillgänglig för dataflödeskomponenter som använder anslutningshanterare för att ansluta till datakällor såsom filer och databaser

    • För att se och ändra komponentnivåegenskaper, klicka på fliken Komponentegenskaper .

    • För att se och ändra mappningar mellan externa kolumner och tillgänglig utdata, klicka på fliken Kolumnmappningar .

      Note

      Fliken Kolumnmappningar är endast tillgänglig när man ser eller redigerar källor eller destinationer.

    • För att se en lista över tillgängliga indatakolumner och uppdatera namnen på utdatakolumner, klicka på fliken Inmatningskolumner .

      Note

      Fliken Input Columns är endast tillgänglig när man arbetar med transformationer eller destinationer. Mer information finns i Omvandlingar av Integration Services.

    • För att se och ändra egenskaperna hos indata, utdata och felutdata samt egenskaperna hos kolumnerna de innehåller, klicka på fliken In- och utdataegenskaper .

      Note

      Källorna har inga indata. Destinationer har inga utgångar, förutom ett valfritt felutdata.

  6. Se eller ändra fastighetsvärdena.

  7. Klicka på OK.

  8. Spara det uppdaterade paketet genom att klicka på Spara markerade objekt på Arkiv-menyn.

Vanliga egenskaper hos dataflödeskomponenter

Dataflödesobjekten i Microsoft služba SSIS-objektmodellen har gemensamma egenskaper och anpassade egenskaper på komponent-, in- och utdata-kolumnnivå, samt indatakolumn och utdatakolumn. Många egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Detta ämne listar och beskriver de vanliga egenskaperna hos dataflödesobjekt.

Komponentegenskaper

I Integration Services-objektmodellen implementerar en komponent i dataflödet gränssnittet IDTSComponentMetaData100 .

Följande tabell beskriver egenskaperna hos komponenterna i ett dataflöde. Vissa egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Property Datatyp Beskrivning
ComponentClassID String CLSID för komponenten.
ContactInfo String Kontaktuppgifter till utvecklaren av en komponent.
Beskrivning String Beskrivningen av dataflödeskomponenten. Standardvärdet för denna egenskap är namnet på dataflödeskomponenten.
ID-nummer Heltal Ett värde som entydigt identifierar denna instans av komponenten.
Identifieringssträng String Identifierar komponenten.
IsDefaultLocale Boolean Anger om komponenten använder platsen för Data Flow-uppgiften som den tillhör.
Locale-ID Heltal Platsen som dataströmskomponenten använder när paketet körs. Alla Windows-lokaler finns tillgängliga för användning i dataflödeskomponenter.
Name String Namnet på dataflödeskomponenten.
PipelineVersion Heltal Den version av dataflödesuppgiften inom vilken en komponent är designad för att köras.
Användningsdispositioner Boolean Indikerar om en komponent har en felutgång.
ValidateExternalMetadata Boolean Indikerar om metadata för externa kolumner är validerad. Standardvärdet för den här egenskapen är True.
Version Heltal Versionen av en komponent.

Indataegenskaper

I Integration Services-objektmodellen har transformationer och destinationer indata. En indata från en komponent i dataflödet implementerar gränssnittet IDTSInput100 .

Följande tabell beskriver egenskaperna hos komponenters indata i ett dataflöde. Vissa egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Property Datatyp Beskrivning
Beskrivning String Beskrivning av indata.
ErrorOrTruncationOperation String En valfri sträng som specificerar vilka typer av fel eller trunkeringar som kan uppstå vid bearbetning av en rad.
ErrorRowDisposition DTSRowDisposition Ett värde som specificerar hanteringen av fel. Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad.
HarBiverkningar Boolean Anger om en komponent kan tas bort från exekveringsplanen för dataflödet när den inte är kopplad till en nedströmskomponent och när RunInOptimizedMode är sann.
ID-nummer Heltal Ett värde som unikt identifierar indata.
Identifieringssträng String En sträng som identifierar indata.
IsSorted Boolean Indikerar om datan i inmatningen är sorterad.
Name String Namnet på inmatningen.
KällaPlats Heltal Språkvariant-ID:t (LCID) för indata.
TruncationRowDisposition DTSRowDisposition Ett värde som avgör hur komponenten hanterar trunkeringar som uppstår vid bearbetning av rader. . Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad.

Destinationer och vissa transformationer stöder inte felutdata, och egenskaperna ErrorRowDisposition och TruncationRowDisposition för dessa komponenter är skrivskyddade.

Egenskaper för indatakolumnen

I Integration Services-objektmodellen innehåller en indata en samling indatakolumner. En indatakolumn för en komponent i dataflödet implementerar gränssnittet IDTSInputColumn100 .

Följande tabell beskriver egenskaperna hos indatakolumnerna för komponenter i ett dataflöde. Vissa egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Property Datatyp Beskrivning
ComparisonFlags Heltal En uppsättning flaggor som specificerar jämförelsen av kolumner som har en teckendatatyp. Mer information finns i Jämföra strängdata.
Beskrivning String Beskriver inmatningskolumnen.
ErrorOrTruncationOperation String En valfri sträng som specificerar vilka typer av fel eller trunkeringar som kan uppstå vid bearbetning av en rad.
ErrorRowDisposition DTSRowDisposition Ett värde som specificerar hanteringen av fel. Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad.
ExternalMetadataColumnID IDTSExternalMetadataColumn100 ID för den externa metadatakolumn som har tilldelats en indatakolumn.
ID-nummer Heltal Ett värde som unikt identifierar indatakolumnen.
Identifieringssträng String En sträng som identifierar indatakolumnen.
LineageID Heltal ID:n för den uppströms kolumnen.
LineageIdentifierificationString String Identifieringssträngen som inkluderar namnet på kolumnen uppströms.
Name String Namnet på indatakolumnen.
Sorteringsnyckelposition Heltal Ett värde som anger om en kolumn är sorterad, dess sorteringsordning och i vilken ordning flera kolumner sorteras. Värdet 0 indikerar att kolumnen inte är sorterad. Mer information finns i Sortera data för sammanslagnings- och sammanslagningstransformeringar.
TruncationRowDisposition DTSRowDisposition Ett värde som avgör hur komponenten hanterar trunkeringar som uppstår vid bearbetning av rader. Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad.
UpstreamComponentName String Namnet på den uppströms komponenten.
Användningstyp DTSUsageType Ett värde som avgör hur en indatakolumn används av komponenten.

Indatakolumner har också de datatypsegenskaper som beskrivs under "Data Type Properties."

Utdataegenskaper

I Integration Services-objektmodellen har källor och transformationer utdata. Ett utdataobjekt från en komponent i dataflödet implementerar gränssnittet IDTSOutput100.

Följande tabell beskriver egenskaperna hos komponenters utdata i ett dataflöde. Vissa egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Property Datatyp Beskrivning
Ta bort utdata när sökvägen kopplas från Boolean Ett värde som avgör om dataflödesmotorn tar bort utdata när den kopplas bort från en sökväg.
Beskrivning String Beskriver resultatet.
ErrorOrTruncationOperation String En valfri sträng som specificerar vilka typer av fel eller trunkeringar som kan uppstå vid bearbetning av en rad.
ErrorRowDisposition DTSRowDisposition Ett värde som specificerar hanteringen av fel. Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad.
Uteslutningsgrupp Heltal Ett värde som identifierar en grupp av ömsesidigt uteslutande utdata.
HarBiverkningar Boolean Ett värde som anger om en komponent kan tas bort från exekveringsplanen för dataflödet när den inte är kopplad till en uppströmskomponent och när RunInOptimizedMode är sant.
ID-nummer Heltal Ett värde som unikt identifierar utdatan.
Identifieringssträng String En sträng som identifierar utgången.
IsErrorOut Boolean Indikerar om utdata är ett felutdata.
IsSorted Boolean Indikerar om utdata är sorterad. Standardvärdet är False.

** Viktigt ** Att sätta värdet på egenskapen IsSorted till True sorterar inte datan. Denna egenskap ger endast en ledtråd till nedströmskomponenter om att datan tidigare har sorterats. Mer information finns i Sortera data för sammanslagnings- och sammanslagningstransformeringar.
Name String Namnet på utdata.
SynchronousInputID Heltal ID:t för en ingång som är synkron med utgången.
TruncationRowDisposition DTSRowDisposition Ett värde som avgör hur komponenten hanterar trunkeringar som uppstår vid bearbetning av rader. Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad.

Egenskaper för utdatakolumnen

I Integration Services-objektmodellen innehåller en utdata en samling utdatakolumner. En utdatakolumn för en komponent i dataflödet implementerar gränssnittet IDTSOutputColumn100 .

Följande tabell beskriver egenskaperna hos utdatakolumnerna för komponenter i ett dataflöde. Vissa egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Property Datatyp Beskrivning
ComparisonFlags Heltal En uppsättning flaggor som specificerar jämförelsen av kolumner som har en teckendatatyp. Mer information finns i Jämföra strängdata.
Beskrivning String Beskriver utdatakolumnen.
ErrorOrTruncationOperation String En valfri sträng som specificerar vilka typer av fel eller trunkeringar som kan uppstå vid bearbetning av en rad.
ErrorRowDisposition DTSRowDisposition Ett värde som specificerar hanteringen av fel. Värdena är Underkänn komponent, Ignorera fel och Omdirigera rad. Standardvärdet är Fail-komponent.
ExternalMetadataColumnID Heltal ID för den externa metadatakolumn som har tilldelats en indatakolumn.
ID-nummer Heltal Ett värde som unikt identifierar utdatakolumnen.
Identifieringssträng String En sträng som identifierar utdatakolumnen.
LineageID Heltal ID:t för utdatakolumnen. Nedströmskomponenter refererar till kolumnen med detta värde.
LineageIdentifierificationString String Identifieringssträngen som innehåller namnet på kolumnen.
Name String Namnet på utdatakolumnen.
Sorteringsnyckelposition Heltal Ett värde som anger om en kolumn är sorterad, dess sorteringsordning och i vilken ordning flera kolumner sorteras. Värdet 0 indikerar att kolumnen inte är sorterad. Mer information finns i Sortera data för sammanslagnings- och sammanslagningstransformeringar.
SpecialFlags Heltal Ett värde som innehåller specialflaggorna i utdatakolumnen.
TruncationRowDisposition DTSRowDisposition Ett värde som avgör hur komponenten hanterar trunkeringar som uppstår vid bearbetning av rader. Värdena är Komponenten misslyckas, Ignorera fel och Omdirigera rad. Standardvärdet är Fail-komponent.

Utdatakolumner innehåller också en uppsättning egenskaper för datatyper.

Egenskaper för externa metadatakolumner

I Integration Services-objektmodellen kan indata och utdata innehålla en samling externa metadatakolumner. En extern metadatakolumn för en komponent i dataflödet implementerar gränssnittet IDTSExternalMetadataColumn100 .

Följande tabell beskriver egenskaperna hos de externa metadatakolumnerna för komponenter i ett dataflöde. Vissa egenskaper har skrivskyddade värden som tilldelas vid körning av dataflödesmotorn.

Property Datatyp Beskrivning
Beskrivning String Beskriver den yttre kolumnen.
ID-nummer Heltal Ett värde som entydigt identifierar kolumnen.
Identifieringssträng String En sträng som identifierar kolumnen.
Name String Namnet på den yttre kolonnen.

Externa metadatakolumner inkluderar också en uppsättning datatypsegenskaper.

Datatypsegenskaper

Utdatakolumner och externa metadatakolumner inkluderar en uppsättning datatypsegenskaper. Beroende på kolumnens datatyp kan egenskaper vara läs- och skrivbara eller skrivskyddade.

Följande tabell beskriver datatypsegenskaperna för utdatakolumner och externa metadatakolumner.

Property Datatyp Beskrivning
CodePage Heltal Specificerar kodsidan för strängdata som inte är Unicode.
Datatyp Heltal (uppräkning) Kolumnens datatyp för Integration Services. Mer information finns i Datatyper för Integration Services.
Length Heltal Längden, mätt i tecken, av en kolumn.
Noggrannhet Heltal Precisionen för en numerisk kolumn.
Skala Heltal Skalan för en numerisk kolumn.

Anpassade egenskaper hos dataflödeskomponenter

För information om anpassade egenskaper, se följande ämnen

Använd ett uttryck i en dataflödeskomponent

Denna procedur beskriver hur man lägger till ett uttryck i Conditional Split-transformationen eller i Derived Column-transformationen. Conditional Split-transformationen använder uttryck för att definiera villkoren som styr datarader till en transformationsutdata, och Derived Column-transformationen använder uttryck för att definiera värden som tilldelas kolumner.

För att implementera ett uttryck i en transformation måste paketet redan innehålla minst en Data Flow-uppgift och en källa.

  1. I SQL Server Data Tools (SSDT) öppnar du projektet Integration Services som innehåller det paket du vill ha.

  2. Dubbelklicka på paketet i Prieskumník riešení för att öppna det.

  3. I SSIS Designer, klicka på fliken Control Flow och sedan på Data Flow-uppgiften som innehåller det data flow där du vill implementera ett uttryck.

  4. Klicka på fliken Data Flow och dra antingen en Conditional Split- eller Derived Column-transformation från Toolbox till designytan.

  5. Dra den gröna kontakten från källan eller en transformation till Conditional Split eller Derived Column-transformationen.

  6. Dubbelklicka på transformationen för att öppna dess dialogruta.

  7. I vänstra panelen, expandera Variables för att visa system- och användardefinierade variabler, och expandera Columns för att visa transformationsindatakolumnerna.

  8. I högra panelen, expandera Matematiska funktioner, strängfunktioner, datum-/tidsfunktioner, NULL-funktioner, typcasts och operatorer för att komma åt funktionerna, casten och operatorerna som uttrycksgrammatiken tillhandahåller.

  9. Beroende på transformationen, gör en av följande för att bygga ett uttryck:

    • I dialogrutan Conditional Split Transformation Editor drar du variabler, kolumner, funktioner, operatorer och typomvandlingar till kolumnen Villkor. Alternativt kan du skriva ett uttryck direkt i kolumnen Villkor .

    • I dialogrutan Derived Column Transformation Editor drar du variabler, kolumner, funktioner, operatorer och typomvandlingar till kolumnen Expression. Alternativt kan du skriva ett uttryck direkt i kolumnen Uttryck .

      Note

      När du tar bort fokus från Villkorskolumnen eller Uttryckskolumnen kan uttryckstexten markeras för att indikera att uttryckssyntaxen är felaktig.

  10. Klicka på OK för att avsluta dialogrutan.

    Note

    Om uttrycket inte är giltigt visas en varning som beskriver syntaxfelen i uttrycket.

Dataflödesegenskaper som du kan sätta med ett uttryck

Värdena för vissa egenskaper hos data flow-objekt kan specificeras genom att använda egenskapsuttryck som finns tillgängliga i Data Flow-taskcontainern.

För information om användning av egenskapsuttryck, se Använd egenskapsuttryck i paket.

Du kan använda egenskapsuttryck för att anpassa konfigurationer för varje distribuerad instans av ett paket. Du kan också använda egenskapsuttryck för att specificera körtidsbegränsningar för ett paket genom att använda /set-alternativet i dtexec :s kommandopromptverktyg. Till exempel kan du begränsa MaximumThreads som används av Sort-transformationen, eller MaxMemoryUsage av Fuzzy Grouping- och Fuzzy Lookup-transformationerna. Om dessa transformationer är obegränsade kan de cachelagra stora mängder data i minnet.

För att specificera ett egenskapsuttryck för någon av egenskaperna hos data flow-objekten som listas i detta ämne, visa Properties-fönstret för Data Flow-uppgiften genom att välja Data Flow-uppgiften på Control Flow-ytan i designern, eller genom att välja designerns Data Flow-flik utan att välja någon enskild komponent eller väg. Välj egenskapen Expressions och klicka på ellipsen (...) för att visa dialogrutan Property Expressions Editor . Välj en egenskap från rullgardinsmenyn Egenskap , skriv sedan ett uttryck i textrutan Uttryck , eller klicka på ellipsen (...) för att visa dialogrutan Uttrycksbyggaren .

Egenskapslistan visar tillgängliga egenskaper för endast de data flow-objekt som du redan har placerat på designerns Data Flow-yta. Därför kan du inte använda Property-listan för att visa alla möjliga egenskaper hos dataflödesobjekt som stödjer egenskapsuttryck. Till exempel, om du har placerat en ADO NET-källa på designerytan, innehåller Property-listan en post för [ADO NET Source].[ SqlCommand]- egendom. Listan visar också många egenskaper hos själva Data Flow-uppgiften.

Värdena för egenskaperna i följande lista kan specificeras genom att använda egenskapsuttryck.

Dataflödeskällor

Data Flow-objekt Property
ADO NET-källa TableOrViewName-egenskapen

SqlCommand-egenskapen
XML-källa XMLData-egenskapen

XMLSchemaDefinition-egenskapen

Dataflödesomvandlingar

För mer information om dessa anpassade egenskaper, se Transformation Anpassade egenskaper.

Data Flow-objekt Property
Villkorsstyrd uppdelningstransformation FriendlyExpression-egenskapen
Härledd kolumntransformation FriendlyExpression-egenskapen
transformation för oskarp gruppering MaxMemoryUsage-egenskapen
Fuzzy Lookup-transformation MaxMemoryUsage-egenskapen
Sökningstransformation SqlCommand-egenskapen

Egenskapen SqlCommandParam
OLE DB-kommandotransformeringen SqlCommand-egenskapen
Transformation för procentbaserad sampling SamplingValue-egenskapen
Pivottransformation Egenskap PivotKeyValue
Transformation för urval av rader SamplingValue-egenskapen
Sorteringstransformation MaximumThreads-egenskapen
Unpivot-transformation egenskapen PivotKeyValue

Dataflödesdestinationer

Data Flow-objekt Property
ADO NET-mål TableOrViewName-egenskapen

BatchSize-egenskapen

CommandTimeout-egenskapen
Destination för platt fil Sidhuvudsegenskap
SQL Server Compact-destination TableName-egenskapen
SQL Server-destination Egenskapen BulkInsertTableName

Egenskapen BulkInsertFirstRow

BulkInsertLastRow-egenskapen

BulkInsertOrder-egenskapen

egenskapen Timeout