Plat bestandsverbindingsbeheer

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

Met een verbindingsbeheer voor plat bestand kan een pakket toegang krijgen tot gegevens in een plat bestand. De Flat File-bron en bestemming kunnen bijvoorbeeld Flat File-verbindingsbeheerders gebruiken om gegevens te extraheren en te laden.

Het verbindingsbeheer voor plat bestand heeft slechts toegang tot één bestand. Als u naar meerdere bestanden wilt verwijzen, gebruikt u een verbindingsbeheer voor meerdere platte bestanden in plaats van een verbindingsbeheer voor plat bestand. Zie Multiple Flat Files Connection Managervoor meer informatie.

Kolomlengte

Standaard stelt verbindingsbeheer voor plat bestand de lengte van tekenreekskolommen in op 50 tekens. In het dialoogvenster Editor voor platte bestandsverbindingsbeheer kunt u voorbeeldgegevens evalueren en de grootte van deze kolommen automatisch wijzigen om afkapping van gegevens of overtollige kolombreedte te voorkomen. Tenzij u vervolgens de grootte van de kolomlengte in een platte bestandsbron of transformatie wijzigt, blijft de kolomlengte van de tekenreekskolom hetzelfde gedurende de gegevensstroom. Als deze tekenreekskolommen aan doelkolommen worden toegewezen die smaller zijn, verschijnen er waarschuwingen in de gebruikersinterface. Bovendien kunnen er tijdens runtime fouten optreden als gevolg van afkapping van gegevens. Als u fouten of afkapping wilt voorkomen, kunt u de grootte van de kolommen aanpassen zodat deze compatibel zijn met de bestemmingskolommen in het verbindingsbeheer voor platte bestanden, de Flat File-bron of een transformatie. Als u de lengte van de uitvoerkolommen wilt wijzigen, stelt u de eigenschap Lengte van de uitvoerkolom in op het tabblad Invoer- en uitvoereigenschappen in het dialoogvenster Geavanceerde editor .

Als u kolomlengten bijwerkt in het verbindingsbeheer voor platte bestanden nadat u de bron Plat bestand hebt toegevoegd en geconfigureerd die gebruikmaakt van verbindingsbeheer, hoeft u het formaat van de uitvoerkolommen in de bron Plat bestand niet handmatig te wijzigen. Wanneer u het dialoogvenster Platte bestandsbron opent, biedt de bron Plat bestand een optie om de metagegevens van de kolom te synchroniseren.

Configuratie van de Flat File Connection Manager

Wanneer u een plat bestandsverbindingsbeheer toevoegt aan een pakket, maakt SQL Server Integration Services een verbindingsbeheer dat tijdens runtime wordt omgezet in een flat file-verbinding, stelt u de eigenschappen van de flat file-verbinding in en voegt u het verbindingsbeheer voor plat bestand toe aan de verzameling Verbindingen van het pakket.

De eigenschap ConnectionManagerType van de verbindingsbeheerder is ingesteld op FLATFILE.

Standaard controleert het verbindingsbeheer voor plat bestand altijd op een rijscheidingsteken in niet-aanhalingstekens en wordt er een nieuwe rij gestart wanneer er een rijscheidingsteken wordt gevonden. Hierdoor kan verbindingsbeheer bestanden correct parseren met rijen die kolomvelden missen.

In sommige gevallen kan het uitschakelen van deze functie de pakketprestaties verbeteren. U kunt deze functie uitschakelen door de eigenschap Flat File Connection Manager, AlwaysCheckForRowDelimiters, in te stellen op False.

U kunt het verbindingsbeheer voor plat bestand op de volgende manieren configureren:

• Geef de te gebruiken bestands-, landinstellingen- en codepagina op. De landinstelling wordt gebruikt om landinstellingengevoelige gegevens, zoals datums, te interpreteren en de codepagina wordt gebruikt om tekenreeksgegevens te converteren naar Unicode.

• Geef de bestandsindeling op. U kunt een indeling met scheidingstekens, vaste breedte of onregelmatige rechteropmaak gebruiken.

• Geef een koprij, gegevensrij en kolomscheidingen op. Kolomscheidingstekens kunnen worden ingesteld op bestandsniveau en worden overschreven op kolomniveau.

• Geef aan of de eerste rij in het bestand kolomnamen bevat.

• Geef een tekstscheidingsteken op. Elke kolom kan worden geconfigureerd om een tekstscheidingsteken te herkennen.

  Het gebruik van een kwalificatieteken voor het insluiten van een kwalificatieteken in een gekwalificeerde tekenreeks wordt ondersteund door flat file connection Manager. Het dubbele exemplaar van een tekstscheidingsteken wordt geïnterpreteerd als een letterlijke, enkele instantie van die tekenreeks. Als de tekstscheidingsteken bijvoorbeeld één aanhalingsteken is en de invoergegevens 'abc', 'def', 'g'hi' zijn, zijn de uitvoergegevens abc, def, g'hi. Een instantie van een kwalificatie die is ingesloten in een gekwalificeerde tekenreeks zorgt er echter voor dat de platte bestandsbron mislukt met de fout DTS_E_PRIMEOUTPUTFAILED.

• Stel eigenschappen in, zoals de naam, het gegevenstype en de maximale breedte voor afzonderlijke kolommen.

U kunt de eigenschap ConnectionString voor het verbindingsbeheer voor plat bestand instellen door een expressie op te geven in het venster Eigenschappen van SQL Server Data Tools (SSDT). Ga als volgt te werk om een validatiefout te voorkomen.

• Wanneer u een expressie gebruikt om het bestand op te geven, voegt u een bestandspad toe in het vak Bestandsnaam in de Editor voor Verbindingsbeheer voor platte bestanden.

• Stel de eigenschap DelayValidation in op Flat File Connection Manager op True.

U kunt een expressie gebruiken om tijdens runtime een bestandsnaam te maken met behulp van het verbindingsbeheer voor plat bestand met de bestemming Plat bestand.

U kunt eigenschappen instellen via SSIS Designer of programmatisch.

Voor informatie over het programmatisch configureren van een verbindingsbeheer, raadpleegt u ConnectionManager en Verbindingen Programmeren Toevoegen.

Platte editor voor bestandsverbindingsbeheer (algemene pagina)

Gebruik de pagina Algemeen van het dialoogvenster Editor voor platte bestandsverbindingsbeheer om een bestand en gegevensindeling te selecteren. Met een platte bestandsverbinding kan een pakket verbinding maken met een tekstbestand.

Zie Flat File Connection Manager voor meer informatie over het verbindingsbeheer voor platte bestanden.

Opties

Verbindingsbeheernaam
Geef een unieke naam op voor de platte bestandsverbinding in de werkstroom. De opgegeven naam wordt weergegeven in SSIS Designer.

Beschrijving
Beschrijf de verbinding. Beschrijf als best practice de verbinding in termen van het doel ervan, om pakketten zelfdocumenterend te maken en gemakkelijker te onderhouden.

bestandsnaam
Typ het pad en de bestandsnaam die u wilt gebruiken in de platte bestandsverbinding.

navigeren
Zoek de bestandsnaam die u wilt gebruiken in de platte bestandsverbinding.

Lokale instellingen
Geef de landinstelling op om taalspecifieke informatie op te geven voor het bestellen en voor datum- en tijdnotaties.

Unicode-
Geef aan of Unicode moet worden gebruikt. Als u Unicode gebruikt, kunt u geen codepagina opgeven.

codepagina
Geef de codepagina op voor niet-Unicode-tekst.

Formatteren
Geef aan of het bestand een door scheidingstekens gescheiden, vaste breedte of niet-uitgelijnde rechteropmaak gebruikt.

Waarde	Beschrijving
Afgebakend	Kolommen worden gescheiden door scheidingstekens, die zijn opgegeven op de pagina Kolommen .
Vaste breedte	Kolommen hebben een vaste breedte.
Onregelmatig rechts	Bestanden met onregelmatige rechterkant zijn bestanden waarin elke kolom een vaste breedte heeft, met uitzondering van de laatste kolom. Het wordt gescheiden door het scheidingsteken voor rijen.

Tekstscheidingsteken
Geef de te gebruiken tekstkwalificatie op. U kunt bijvoorbeeld opgeven dat tekstvelden tussen aanhalingstekens staan.

Opmerking

Nadat u een tekstscheidingsteken hebt geselecteerd, kunt u de optie Geen niet opnieuw selecteren. Typ Geen om de tekstscheidingsteken te deselecteren.

Koptekstscheidingsteken
Kies uit de lijst met scheidingstekens voor koprijen of voer de tekst van het scheidingsteken in.

Waarde	Beschrijving
{CR}{LF}	De koprij wordt gescheiden door een combinatie van een regelterugloop en een regeleinde.
{CR}	De kopregel wordt gescheiden door een return.
{LF}	De veldnamenrij wordt gescheiden door een regelfeed.
Puntkomma {;}	De veldnamenrij wordt gescheiden door een puntkomma.
Dubbele punt {:}	De koptekstrij wordt gescheiden door een dubbele punt.
Komma {,}	De koprij wordt gescheiden door een komma.
Tab {t}	De veldnamenrij wordt gescheiden door een tabblad.
Verticale balk {|}	De koprij wordt gescheiden door een verticale streep.

Veldnamenrijen om over te slaan
Geef het aantal veldnamenrijen of de eerste gegevensrijen op die moeten worden overgeslagen, indien van toepassing.

Kolomnamen in de eerste gegevensrij
Geef aan of u kolomnamen in de eerste gegevensrij wilt verwachten of opgeven.

Editor voor verbindingenmanager voor platte bestanden (Kolommenpagina)

Gebruik de pagina Kolommen van het dialoogvenster Editor voor platte bestandsverbindingsbeheer om de rij- en kolomgegevens op te geven en een voorbeeld van het bestand te bekijken.

Zie Flat File Connection Manager voor meer informatie over het verbindingsbeheer voor platte bestanden.

Statische opties

Verbindingsbeheernaam
Geef een unieke naam op voor de Flat File-verbinding in het werkproces. De opgegeven naam wordt weergegeven in SSIS Designer.

Beschrijving
Beschrijf de verbinding. Beschrijf als best practice de verbinding in termen van het doel ervan, om pakketten zelfdocumenterend te maken en gemakkelijker te onderhouden.

Dynamische opties voor platte bestandsindeling

Opmaak = Afgebakend

Rijscheidingsteken
Selecteer in de lijst met beschikbare rijscheidingstekens of voer de tekst van het scheidingsteken in.

Waarde	Beschrijving
{CR}{LF}	Rijen worden gescheiden door een combinatie van regelterugloopinvoer.
{CR}	Rijen worden gescheiden door een regelterugloop.
{LF}	Rijen worden gescheiden door een regelfeed.
Puntkomma {;}	Rijen worden gescheiden door een puntkomma.
Dubbele punt {:}	Rijen worden gescheiden door een dubbele punt.
Komma {,}	Rijen worden gescheiden door een komma.
Tab {t}	Rijen worden gescheiden door een tab.
Verticale balk {|}	Rijen worden gescheiden door een verticale balk.

Kolomscheidingsteken
Selecteer in de lijst met beschikbare kolomscheidingstekens of voer de tekst van het scheidingsteken in.

Waarde	Beschrijving
{CR}{LF}	Kolommen worden gescheiden door een combinatie van regelterugloopfeeds.
{CR}	Kolommen worden gescheiden door een regelterugloop.
{LF}	Kolommen worden gescheiden door een regelfeed.
Puntkomma {;}	Kolommen worden gescheiden door een puntkomma.
Dubbele punt {:}	Kolommen worden gescheiden door een dubbele punt.
Komma {,}	Kolommen worden gescheiden door een komma.
Tab {t}	Kolommen worden gescheiden door een tabblad.
Verticale balk {|}	Kolommen worden gescheiden door een verticale balk.

Vernieuwen
Bekijk het effect van het wijzigen van de scheidingstekens om over te slaan door op Vernieuwen te klikken. Deze knop wordt alleen zichtbaar nadat u andere verbindingsopties hebt gewijzigd.

Voorbeeld van rijen
Bekijk voorbeeldgegevens in het platte bestand, onderverdeeld in kolommen en rijen met behulp van de geselecteerde opties.

Kolommen opnieuw instellen
Verwijder alle kolommen behalve de oorspronkelijke kolommen door op Kolommen opnieuw instellen te klikken.

Format = Vaste breedte

lettertype
Selecteer het lettertype waarin u de voorbeeldgegevens wilt weergeven.

Brongegevenskolommen
Pas de breedte van de rij aan door de verticale rode rijmarkering te schuiven en de breedte van de kolommen aan te passen door boven aan het voorbeeldvenster op de liniaal te klikken

Rijbreedte
Geef de lengte van de rij op voordat u scheidingstekens toevoegt voor afzonderlijke kolommen. U kunt ook de verticale rode lijn in het voorbeeldvenster slepen om het einde van de rij te markeren. De waarde voor de rijbreedte wordt automatisch bijgewerkt.

Kolommen opnieuw instellen
Verwijder alle kolommen behalve de oorspronkelijke kolommen door op Kolommen opnieuw instellen te klikken.

Opmaak = Onregelmatig rechts

Opmerking

Bestanden met onregelmatige rechterkant zijn bestanden waarin elke kolom een vaste breedte heeft, met uitzondering van de laatste kolom. Het wordt gescheiden door het scheidingsteken voor rijen.

lettertype
Selecteer het lettertype waarin u de voorbeeldgegevens wilt weergeven.

Brongegevenskolommen
Pas de breedte van de rij aan door de verticale rode rijmarkering te schuiven en de breedte van de kolommen aan te passen door boven aan het voorbeeldvenster op de liniaal te klikken

Rijscheidingsteken
Selecteer in de lijst met beschikbare rijscheidingstekens of voer de tekst van het scheidingsteken in.

Waarde	Beschrijving
{CR}{LF}	Rijen worden gescheiden door een combinatie van regelterugloopinvoer.
{CR}	Rijen worden gescheiden door een regelterugloop.
{LF}	Rijen worden gescheiden door een regelfeed.
Puntkomma {;}	Rijen worden gescheiden door een puntkomma.
Dubbele punt {:}	Rijen worden gescheiden door een dubbele punt.
Komma {,}	Rijen worden gescheiden door een komma.
Tab {t}	Rijen worden gescheiden door een tab.
Verticale balk {|}	Rijen worden gescheiden door een verticale balk.

Kolommen opnieuw instellen
Verwijder alle kolommen behalve de oorspronkelijke kolommen door op Kolommen opnieuw instellen te klikken.

Editor voor platte bestandsverbindingsbeheer (geavanceerde pagina)

Gebruik de pagina Geavanceerd van het dialoogvenster Editor voor platte bestandsverbindingsbeheer om eigenschappen in te stellen die aangeven hoe Integration Services gegevens leest en schrijft in platte bestanden. U kunt de namen van kolommen in het platte bestand wijzigen en eigenschappen instellen die gegevenstype en scheidingstekens bevatten voor elke kolom in het bestand.

De lengte van tekenreekskolommen is standaard 50 tekens. U kunt de grootte van deze kolommen wijzigen om te voorkomen dat gegevens of overtollige kolombreedte worden afgekapt. U kunt ook andere metagegevens bijwerken om compatibiliteit met doelkolommen mogelijk te maken. U kunt bijvoorbeeld het gegevenstype van een kolom met alleen gehele getallen wijzigen in een numeriek gegevenstype, zoals DT_I2. U kunt deze wijzigingen handmatig aanbrengen of u kunt op de knop Typen selecteren klikken om het dialoogvenster Kolomtypen voorstellen te gebruiken om voorbeeldgegevens te evalueren en een aantal van deze wijzigingen automatisch voor u aan te brengen.

Zie Flat File Connection Manager voor meer informatie over het verbindingsbeheer voor platte bestanden.

Opties

Verbindingsbeheernaam
Geef een unieke naam op voor het platte bestandsverbindingsbeheer in de werkstroom. De opgegeven naam wordt weergegeven in SSIS Designer.

Beschrijving
Beschrijf het verbindingsbeheer. Beschrijf als best practice het verbindingsbeheer in termen van het doel ervan, om pakketten zelfdocumenterend te maken en gemakkelijker te onderhouden.

De eigenschappen van elke kolom configureren
Selecteer een kolom in het linkerdeelvenster om de eigenschappen ervan weer te geven in het rechterdeelvenster. Zie de volgende tabel voor een beschrijving van de eigenschappen van het gegevenstype. Sommige van de vermelde eigenschappen kunnen alleen worden geconfigureerd voor sommige platte bestandsindelingen.

Vastgoed	Beschrijving
ColumnType-	Geeft aan of de kolom is gescheiden, vaste breedte of onregelmatig rechts. Deze eigenschap is alleen-lezen. Bestanden met onregelmatige rechterkant zijn bestanden waarin elke kolom een vaste breedte heeft, met uitzondering van de laatste kolom. Het wordt gescheiden door het scheidingsteken voor rijen.
OutputColumnWidth	Geef een waarde op die moet worden opgeslagen als een telling van bytes; voor Unicode-bestanden komt deze waarde overeen met het aantal tekens. In de taak Gegevensstroom wordt deze waarde gebruikt om de breedte van de uitvoerkolom voor de bron Plat bestand in te stellen. In het objectmodel is de naam van deze eigenschap MaximumWidth.
Datatype	Selecteer in de lijst met beschikbare gegevenstypen. Zie Integration Services-gegevenstypenvoor meer informatie.
TextQualified	Geef aan of tekstgegevens worden omgeven door tekstscheidingstekens, zoals aanhalingstekens. Waar: Tekstgegevens in het platte bestand zijn gekwalificeerd. Onwaar: tekstgegevens in het platte bestand zijn NIET gekwalificeerd.
Naam	Geef een beschrijvende kolomnaam op. Als u geen naam invoert, maakt Integration Services automatisch een naam in de notatie Kolom 0, Kolom 1 enzovoort.
DataScale	Geef de schaal van numerieke gegevens op. Schaal verwijst naar het aantal decimalen. Zie Integration Services-gegevenstypenvoor meer informatie.
ColumnDelimiter	Selecteer in de lijst met beschikbare kolomscheidingstekens. Kies scheidingstekens die waarschijnlijk niet in de tekst voorkomen. Deze waarde wordt genegeerd voor kolommen met vaste breedte. {CR}{LF}. Kolommen worden gescheiden door een combinatie van regelterugloopfeeds. {CR}. Kolommen worden gescheiden door een regelterugloop. {LF}. Kolommen worden gescheiden door een regelfeed. Puntkomma {;}. Kolommen worden gescheiden door een puntkomma. Dubbele punt {:}. Kolommen worden gescheiden door een dubbele punt. Komma {,}. Kolommen worden gescheiden door een komma. Tab {t}. Kolommen worden gescheiden door een tabblad. Verticale balk {|}. Kolommen worden gescheiden door een verticale balk.
DataPrecision	Geef de precisie van numerieke gegevens op. Precisie verwijst naar het aantal cijfers. Zie Integration Services-gegevenstypenvoor meer informatie.
Invoerkolombreedte	Geef een waarde op die moet worden opgeslagen als een telling van bytes; voor Unicode-bestanden wordt dit weergegeven als een telling van tekens. Deze waarde wordt genegeerd voor kolommen met scheidingstekens. Notitie In het objectmodel is de naam van deze eigenschap ColumnWidth.

Nieuw
Voeg een nieuwe kolom toe door op Nieuw te klikken. De knop Nieuw voegt standaard een nieuwe kolom toe aan het einde van de lijst. De knop bevat ook de volgende opties die beschikbaar zijn in de vervolgkeuzelijst.

Waarde	Beschrijving
Kolom toevoegen	Voeg een nieuwe kolom toe aan het einde van de lijst.
Invoegen voor	Een nieuwe kolom invoegen vóór de geselecteerde kolom.
Invoegen na	Een nieuwe kolom invoegen na de geselecteerde kolom.

Verwijderen
Selecteer een kolom en verwijder deze door op Verwijderen te klikken.

Typen voorstellen
Gebruik het dialoogvenster Kolomtypen voorstellen om voorbeeldgegevens in het bestand te evalueren en suggesties te verkrijgen voor het gegevenstype en de lengte van elke kolom. Zie Naslaginformatie over de gebruikersinterface van het dialoogvenster Kolomtypen voorstellen voor meer informatie.

Editor voor platte bestandsverbindingsbeheer (preview-pagina)

Gebruik het voorbeeldknooppunt van het dialoogvenster Editor voor platte bestandsverbindingsbeheer om de inhoud van het bronbestand in tabelvorm weer te geven.

Zie Flat File Connection Manager voor meer informatie over het verbindingsbeheer voor platte bestanden.

Opties

Verbindingsbeheernaam
Geef een unieke naam op voor de Flat File-verbinding in het werkproces. De opgegeven naam wordt weergegeven in SSIS Designer.

Beschrijving
Beschrijf de verbinding. Beschrijf als best practice de verbinding in termen van het doel ervan, om pakketten zelfdocumenterend te maken en gemakkelijker te onderhouden.

Gegevensrijen om over te slaan
Geef op hoeveel rijen u wilt overslaan aan het begin van het platte bestand.

Vernieuwen
Bekijk het effect van het wijzigen van het aantal rijen dat u wilt overslaan door op Vernieuwen te klikken. Deze knop wordt alleen zichtbaar nadat u andere verbindingsopties hebt gewijzigd.

Voorbeeld van rijen
Bekijk voorbeeldgegevens in het platte bestand, onderverdeeld in kolommen en rijen volgens de opties die u hebt geselecteerd.