Flatfile-Verbindungs-Manager

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

Mit einem Verbindungs-Manager für Flatfiles kann ein Paket auf Daten in einer Flatfile zugreifen. Beispielsweise können die Flatfile-Quelle und das Flatfile-Ziel Flatfile-Verbindungs-Manager zum Extrahieren und Laden der Daten verwenden.

Der Verbindungs-Manager für Flatfiles kann nur auf eine einzige Datei zugreifen. Wenn Sie auf mehrere Dateien verweisen möchten, verwenden Sie anstelle eines Verbindungs-Managers für Flatfile-Dateien einen Verbindungs-Manager für mehrere Flatfile-Dateien. Weitere Informationen finden Sie unter Multiple Flat Files Verbindungs-Manager.

Spaltenlänge

Der Verbindungs-Manager für Flatfiles legt die Länge von Zeichenfolgenspalten standardmäßig auf 50 Zeichen fest. Sie können im Dialogfenster Verbindungs-Manager-Editor für Flatfiles Beispieldaten auswerten und automatisch die Länge dieser Spalten ändern, um zu vermeiden, dass die Daten abgeschnitten werden oder die Spaltenbreite überschritten wird. Es sei denn, Sie ändern danach die Spaltenlänge in einer Flatfilequelle oder in einer Transformation. Dann bleibt die Spaltenlänge der Zeichenfolgenspalte im gesamten Datenfluss gleich. Wenn diese Zeichenfolgenspalten Zielspalten zugeordnet sind, die schmaler sind, werden in der Benutzeroberfläche Warnungen angezeigt. Außerdem können zur Laufzeit Fehler aufgrund von Datenkürzung auftreten. Um Fehler oder Abschneiden zu vermeiden, können Sie die Spalten im Flatfile-Verbindungs-Manager, in der Flatfilequelle oder in einer Transformation so anpassen, dass sie mit den Zielspalten kompatibel sind. Legen Sie zum Ändern der Länge von Ausgabespalten auf der Registerkarte Eingabe- und Ausgabeeigenschaften im Dialogfeld Erweiterter Editor die Length -Eigenschaft der Ausgabespalte fest.

Wenn Sie die Spaltenlängen im Verbindungs-Manager für Flatfiles aktualisieren, nachdem Sie die Flatfilequelle, die den Verbindungs-Manager verwendet, hinzugefügt und geändert haben, ist das manuelle Ändern der Ausgabespaltengröße in der Flatfilequelle nicht erforderlich. Wenn Sie das Dialogfeld Flatfilequelle öffnen, stellt die Flatfilequelle eine Option zum Synchronisieren der Spaltenmetadaten bereit.

Konfiguration des Flatfile-Verbindungs-Managers

Wenn Sie einem Paket einen Verbindungs-Manager für Flatfiles hinzufügen, erstellt SQL Server Integration Services einen Verbindungs-Manager, der zur Laufzeit in eine Flatfileverbindung aufgelöst wird, die Eigenschaften der Flatfileverbindung festlegt und den Verbindungs-Manager für Flatfiles zur Connections-Sammlung des Pakets hinzufügt.

Die ConnectionManagerType -Eigenschaft des Verbindungs-Managers ist auf FLATFILEfestgelegt.

Standardmäßig sucht der Verbindungs-Manager für Flatfiles immer nach einem Zeilentrennzeichen in Daten ohne Anführungszeichen und startet eine neue Zeile, wenn ein Zeilentrennzeichen gefunden wird. Dadurch kann der Verbindungs-Manager Flatfiledateien mit Zeilen, in denen Spaltenfelder fehlen, korrekt analysieren.

In einigen Fällen wird die Paketleistung verbessert, wenn Sie diese Funktion deaktivieren. Sie können diese Funktion deaktivieren, indem Sie die Eigenschaft AlwaysCheckForRowDelimiters des Flatfile-Verbindungs-Managers auf False festlegen.

Es gibt folgende Möglichkeiten, um den Verbindungs-Manager für Flatfiles zu konfigurieren:

  • Geben Sie die Datei, das Gebietsschema und die Codepage an, die Sie verwenden möchten. Das Gebietsschema wird verwendet, um gebietsschemaabhängige Daten wie beispielsweise Datumsangaben zu interpretieren, und die Codepage wird verwendet, um Zeichenfolgendaten in Unicode zu konvertieren.

  • Geben Sie das Dateiformat an. Sie können ein Format mit Trennzeichen, fester Breite oder rechtem Flatterrand verwenden.

  • Geben Sie eine Kopfzeile, eine Datenzeile und Spaltentrennzeichen an. Spaltentrennzeichen können auf Dateiebene festgelegt und auf Spaltenebene überschrieben werden.

  • Zeigen Sie an, ob die erste Zeile in der Datei Spaltennamen enthält.

  • Geben Sie ein Textbegrenzungszeichen an. Für jede Spalte kann die Erkennung eines Textqualifizierers konfiguriert werden.

    Die Verwendung eines Qualifiziererzeichens zum Einbetten eines Qualifiziererzeichens in eine qualifizierte Zeichenfolge wird durch den Verbindungs-Manager für Flatfiles unterstützt. Eine doppelte Instanz eines Textqualifizierers wird als literale, einzelne Instanz dieser Zeichenfolge interpretiert. Ist der Textqualifizierer beispielsweise ein einfaches Anführungszeichen, und die Eingabedaten sind 'abc', 'def', 'g'hi', so sind die Ausgabedaten abc, def, g'hi. Wenn jedoch ein Textqualifizierer innerhalb einer qualifizierten Zeichenfolge eingebettet ist, schlägt die Flat File Source mit dem Fehler DTS_E_PRIMEOUTPUTFAILED fehl.

  • Legen Sie Eigenschaften wie z. B. den Namen, den Datentyp und die maximale Breite für einzelne Spalten fest.

Sie können die ConnectionString-Eigenschaft für den Verbindungs-Manager für Flatfiles festlegen, indem Sie einen Ausdruck im Eigenschaftenfenster von SQL Server Data Tools (SSDT)angeben. Um einen Überprüfungsfehler zu vermeiden, gehen Sie wie folgt vor.

  • Wenn Sie einen Ausdruck verwenden, um die Datei anzugeben, geben Sie im Feld Dateiname im Editor für den Flatfile-Verbindungs-Manager einen Dateipfad ein.

  • Legen Sie die Eigenschaft DelayValidation im Verbindungs-Manager für Flatfiles auf Truefest.

Sie können einen Ausdruck verwenden, um zur Laufzeit einen Dateinamen zu erstellen, indem Sie den Flatfile-Verbindungs-Manager mit dem Flatfile-Ziel verwenden.

Sie können Eigenschaften mit dem SSIS -Designer oder programmgesteuert festlegen.

Informationen zum programmgesteuerten Konfigurieren eines Verbindungsmanagers finden Sie unter ConnectionManager und Programmgesteuertes Hinzufügen von Verbindungen.

Verbindungs-Manager-Editor für Flatfiles (Seite Allgemein)

Auf der Seite Allgemein des Dialogfelds Verbindungs-Manager-Editor für Flatfiles wählen Sie eine Datei und ein Dateiformat aus. Eine Flatfile-Verbindung ermöglicht einem Paket die Verbindung mit einer Textdatei.

Weitere Informationen zum Verbindungs-Manager für Flatfiles finden Sie unter Flat File Verbindungs-Manager.

Optionen

Name des Verbindungs-Managers
Geben Sie einen eindeutigen Namen für die Flatfileverbindung im Workflow an. Der angegebene Name wird im SSIS -Designer angezeigt.

Beschreibung
Beschreiben Sie die Verbindung. Es ist eine bewährte Methode, die Verbindung zweckbezogen zu beschreiben, sodass Pakete selbsterklärend und einfacher zu verwalten sind.

Dateiname
Geben Sie den Pfad und den Dateinamen ein, die für die Flatfileverbindung verwendet werden sollen.

Durchsuchen
Suchen Sie den Dateinamen, der für die Flatfile-Verbindung verwendet wird.

Gebietsschema
Gibt das Gebietsschema für die Bereitstellung sprachspezifischer Informationen für das Bestellen sowie für Datums- und Zeitformate an.

Unicode-
Gibt an, ob Unicode verwendet werden soll. Wenn Sie Unicode verwenden, können Sie keine Codepage angeben.

Codeseite
Gibt die Codepage für Nicht-Unicode-Text an.

Format
Gibt an, ob die Datei Formatierung mit Trennzeichen, fester Breite oder rechtem Flatterrand verwendet.

Wert BESCHREIBUNG
Durch Trennzeichen getrennt Die Trennung von Spalten erfolgt durch Trennzeichen. Welche Trennzeichen dies sind, wird auf der Seite Spalten angegeben.
Feste Breite Spalten haben eine feste Breite.
Rechter Flatterrand Dateien mit ungleichmäßigem rechten Rand sind Dateien, in denen jede Spalte eine feste Breite hat, außer der letzten Spalte. Es wird durch den Zeilenbegrenzer getrennt.

Textqualifizierer
Gibt die zu verwendenden Textqualifizierer an. So können Sie beispielsweise angeben, dass Textfelder in Anführungszeichen eingeschlossen sind.

Hinweis

Nachdem Sie einen Textqualifizierer ausgewählt haben, können Sie die Option Keine nicht erneut auswählen. Geben Sie Keine ein, um die Auswahl des Textqualifizierers aufzuheben.

Kopfzeilentrennzeichen
Wählen Sie aus einer Liste mit Trennzeichen für Kopfzeilen ein Trennzeichen aus, oder geben Sie den Trennzeichentext ein.

Wert BESCHREIBUNG
{CR}{LF} Die Kopfzeile wird durch die Kombination aus Carriage Return und Line Feed getrennt.
{CR} Die Kopfzeile wird durch einen Zeilenumbruch getrennt.
{LF} Die Kopfzeile wird durch einen Zeilenvorschub getrennt.
Semikolon {;} Die Kopfzeile ist durch ein Semikolon getrennt.
Doppelpunkt {:} Die Kopfzeile ist durch einen Doppelpunkt getrennt.
Komma {,} Die Kopfzeile wird durch ein Komma getrennt.
Tab {t} Die Kopfzeile ist durch einen Tabulator getrennt.
Senkrechter Strich {|} Die Kopfzeile wird durch einen senkrechten Strich getrennt.

Auszulassende Kopfzeilen
Gibt an, wie viele Kopfzeilen bzw. erste Datenzeilen ggf. ausgelassen werden sollen.

Spaltennamen in der ersten Datenzeile
Gibt an, ob in der ersten Datenzeile Spaltennamen erwartet werden bzw. bereitzustellen sind.

Editor für Flatfile-Verbindungs-Manager (Seite „Spalten“)

Verwenden Sie die Seite Spalten des Dialogfelds Verbindungs-Manager-Editor für Flatfile, um die Zeilen- und Spalteninformationen anzugeben und eine Vorschau der Datei anzuzeigen.

Weitere Informationen zum Verbindungs-Manager für Flatfiles finden Sie unter Flat File Verbindungs-Manager.

Statische Optionen

Name des Verbindungs-Managers
Geben Sie einen eindeutigen Namen für die Flatfile-Verbindung im Workflow an. Der angegebene Name wird im SSIS -Designer angezeigt.

Beschreibung
Beschreiben Sie die Verbindung. Es ist eine bewährte Methode, die Verbindung zweckbezogen zu beschreiben, sodass Pakete selbsterklärend und einfacher zu verwalten sind.

Flatfileformat (dynamische Optionen)

Format = Getrennt

Zeilentrennzeichen
Wählen Sie aus der Liste verfügbarer Zeilentrennzeichen ein Trennzeichen aus, oder geben Sie den Trennzeichentext ein.

Wert BESCHREIBUNG
{CR}{LF} Zeilen werden durch eine Kombination aus Wagenrücklauf und Zeilenvorschub getrennt.
{CR} Als Trennzeichen für Zeilen dient ein Wagenrücklauf.
{LF} Zeilen werden durch einen Zeilenvorschub getrennt.
Semikolon {;} Als Trennzeichen für Zeilen dient ein Semikolon.
Doppelpunkt {:} Zeilen werden durch einen Doppelpunkt getrennt.
Komma {,} Als Trennzeichen für Zeilen dient ein Komma.
Tab {t} Zeilen werden durch einen Tabulator getrennt.
Senkrechter Strich {|} Zeilen werden durch einen vertikalen Strich getrennt.

Spaltentrennzeichen
Wählen Sie aus der Liste verfügbarer Spaltentrennzeichen ein Trennzeichen aus, oder geben Sie den Trennzeichentext ein.

Wert BESCHREIBUNG
{CR}{LF} Spalten werden durch eine Wagenrücklauf-Zeilenvorschub-Kombination getrennt.
{CR} Spalten werden durch einen Zeilenrücklauf getrennt.
{LF} Spalten werden durch einen Zeilenumbruch getrennt.
Semikolon {;} Als Trennzeichen für Spalten dient ein Semikolon.
Doppelpunkt {:} Spalten werden durch einen Doppelpunkt getrennt.
Komma {,} Als Trennzeichen für Spalten dient ein Komma.
Tab {t} Spalten werden durch einen Tabulator getrennt.
Senkrechter Strich {|} Als Trennzeichen für Spalten dient ein senkrechter Strich.

Aktualisieren
Sehen Sie sich durch Klicken auf Aktualisieren die Auswirkung der Änderung der zu überspringenden Trennzeichen an. Diese Schaltfläche wird erst angezeigt, nachdem Sie andere Verbindungsoptionen geändert haben.

Vorschau der Zeilen
Zeigt Beispieldaten in der Flatfile an, die entsprechend den von Ihnen ausgewählten Optionen in Spalten und Zeilen unterteilt sind.

Spalten zurücksetzen
Entfernen Sie alle Spalten bis auf die ursprünglichen, indem Sie auf Spalten zurücksetzen klicken.

Format = Feste Breite

Schriftart
Wählen Sie die Schriftart aus, in der die Vorschaudaten angezeigt werden sollen.

Quelldatenspalten
Passen Sie die Zeilenbreite an, indem Sie die vertikale rote Zeilenmarkierungslinie verschieben, und passen Sie die Spaltenbreite an, indem Sie auf das Lineal am oberen Rand des Vorschaufensters klicken.

Zeilenbreite
Geben Sie erst die Länge der Zeile an, bevor Sie einzelnen Spalten Trennzeichen hinzufügen. Sie können auch die vertikale rote Linie im Vorschaufenster verschieben, um das Zeilenende zu kennzeichnen. Der Wert der Zeilenbreite wird automatisch aktualisiert.

Spalten zurücksetzen
Entfernen Sie alle Spalten bis auf die ursprünglichen, indem Sie auf Spalten zurücksetzen klicken.

Format = Rechter Flatterrand

Hinweis

Dateien mit ungleichmäßigem rechten Rand sind Dateien, in denen jede Spalte eine feste Breite hat, außer der letzten Spalte. Es wird durch den Zeilenbegrenzer getrennt.

Schriftart
Wählen Sie die Schriftart aus, in der die Vorschaudaten angezeigt werden sollen.

Quelldatenspalten
Passen Sie die Zeilenbreite an, indem Sie die vertikale rote Zeilenmarkierungslinie verschieben, und passen Sie die Spaltenbreite an, indem Sie auf das Lineal am oberen Rand des Vorschaufensters klicken.

Zeilentrennzeichen
Wählen Sie aus der Liste verfügbarer Zeilentrennzeichen ein Trennzeichen aus, oder geben Sie den Trennzeichentext ein.

Wert BESCHREIBUNG
{CR}{LF} Zeilen werden durch eine Kombination aus Wagenrücklauf und Zeilenvorschub getrennt.
{CR} Als Trennzeichen für Zeilen dient ein Wagenrücklauf.
{LF} Zeilen werden durch einen Zeilenvorschub getrennt.
Semikolon {;} Als Trennzeichen für Zeilen dient ein Semikolon.
Doppelpunkt {:} Zeilen werden durch einen Doppelpunkt getrennt.
Komma {,} Als Trennzeichen für Zeilen dient ein Komma.
Tab {t} Zeilen werden durch einen Tabulator getrennt.
Senkrechter Strich {|} Zeilen werden durch einen vertikalen Strich getrennt.

Spalten zurücksetzen
Entfernen Sie alle Spalten bis auf die ursprünglichen, indem Sie auf Spalten zurücksetzen klicken.

Editor für Flatfile-Verbindungs-Manager (Erweitert)

Verwenden Sie im Dialogfeld Verbindungs-Manager-Editor für Flatfiles die Seite Erweitert , um die Eigenschaften festzulegen, mit denen angegeben wird, wie mit Integration Services Daten in Flatfiles gelesen und geschrieben werden. Sie können die Namen der Spalten in der Flatfile ändern und Eigenschaften festlegen. Zu den Eigenschaften zählen der Datentyp und die Trennzeichen für jede Spalte in der Datei.

Standardmäßig beträgt die Länge von Zeichenfolgenspalten 50 Zeichen. Sie können die Länge dieser Spalten ändern, um das Abschneiden von Daten und das Entstehen übermäßig breiter Spalten zu verhindern. Sie können darüber hinaus andere Metadaten aktualisieren, um Kompatibitlität mit Zielspalten zu aktivieren. Sie können beispielsweise den Datentyp einer Spalte, die nur ganzzahlige Daten enthält, in einen numerischen Datentyp ändern, z. B. DT_I2. Nehmen Sie diese Änderungen manuell vor, oder klicken Sie auf die Schaltfläche Typen vorschlagen , um mithilfe des Dialogfelds Spaltentypen vorschlagen Beispieldaten auszuwerten und einige dieser Änderungen automatisch vornehmen zu lassen.

Weitere Informationen zum Verbindungs-Manager für Flatfiles finden Sie unter Flat File Verbindungs-Manager.

Optionen

Name des Verbindungs-Managers
Geben Sie einen eindeutigen Namen für den Verbindungs-Manager für Flatfiles im Workflow an. Der angegebene Name wird im SSIS -Designer angezeigt.

Beschreibung
Beschreiben Sie den Verbindungs-Manager. Die bewährte Methode ist hierbei, den Verbindungs-Manager zweckbezogen zu beschreiben, sodass Pakete selbsterklärend und leichter zu verwalten sind.

Konfigurieren Sie die Eigenschaften für jede Spalte.
Wählen Sie eine Spalte im linken Bereich, um im rechten Bereich ihre Eigenschaften anzuzeigen. In der folgenden Tabelle werden die Datentypeigenschaften beschrieben. Einige der aufgeführten Eigenschaften können nur für einige Flatfileformate konfiguriert werden.

Eigenschaft BESCHREIBUNG
ColumnType Gibt an, ob eine Spalte getrennt ist, eine feste Breite hat bzw. einen unregelmäßigen rechten Rand aufweist. Diese Eigenschaft ist schreibgeschützt. Dateien mit ungleichmäßigem rechten Rand sind Dateien, in denen jede Spalte eine feste Breite hat, außer der letzten Spalte. Es wird durch den Zeilenbegrenzer getrennt.
OutputColumnWidth Geben Sie einen Wert an, der als Anzahl von Bytes gespeichert werden soll; bei Unicode-Dateien entspricht dieser Wert einer Zeichenanzahl. Im Datenflusstask dient dieser Wert dem Festlegen der Breite der Ausgabespalte für die Flatfilequelle. Im Objektmodell heißt diese Eigenschaft MaximumWidth.
Datatype Wählen Sie eine Option aus der Liste der verfügbaren Datentypen aus. Weitere Informationen finden Sie unter Integration Services Datentypen.
TextQualified Geben Sie an, ob Textdaten von Textbegrenzerzeichen wie etwa Anführungszeichen umschlossen werden.

True: Die Textdaten in der Flatfile sind gekennzeichnet. False: Die Textdaten in der Flatfile sind nicht gekennzeichnet.
Name Geben Sie einen beschreibenden Spaltennamen an. Wenn Sie keinen Namen eingeben, wird in Integration Services automatisch ein Name im Format Spalte 0, Spalte 1 usw. erstellt.
DataScale Gibt die Skala numerischer Daten an. Skala bezieht sich auf die Anzahl der Dezimalstellen. Weitere Informationen finden Sie unter Integration Services Datentypen.
ColumnDelimiter Wählen Sie eine Option aus der Liste der verfügbaren Spaltentrennzeichen aus. Wählen Sie Trennzeichen aus, die wahrscheinlich nicht im Text vorkommen. Bei Spalten fester Breite wird dieser Wert ignoriert.

{CR}{LF} . Spalten werden durch eine Wagenrücklauf-Zeilenvorschub-Kombination getrennt.

{CR} . Spalten werden durch einen Zeilenrücklauf getrennt.

{LF} . Spalten werden durch einen Zeilenumbruch getrennt.

Semikolon {;} . Als Trennzeichen für Spalten dient ein Semikolon.

Doppelpunkt {:} . Spalten werden durch einen Doppelpunkt getrennt.

Komma {,}. Als Trennzeichen für Spalten dient ein Komma.

Tab {t}. Spalten werden durch einen Tabulator getrennt.

Senkrechter Strich (|). Als Trennzeichen für Spalten dient ein senkrechter Strich.
DataPrecision Gibt die Präzision numerischer Daten an. Präzision bezieht sich auf die Anzahl der Ziffern. Weitere Informationen finden Sie unter Integration Services Datentypen.
Eingabespaltenbreite Gibt an, welcher Wert als Anzahl von Bytes gespeichert werden soll; bei Unicode-Dateien wird dieser Wert als Zeichenanzahl angezeigt. Bei mit Trennzeichen versehenen Spalten wird dieser Wert ignoriert.

Hinweis: Im Objektmodell heißt diese Eigenschaft ColumnWidth.

Neu
Durch Klicken auf Neufügen Sie eine neue Spalte hinzu. Die neue Spalten wird beim Klicken auf Neu standardmäßig am Ende der Liste hinzugefügt. Ferner sind für die Schaltfläche folgende, über die Dropdownliste auswählbare Optionen verfügbar.

Wert BESCHREIBUNG
Spalte hinzufügen Fügt am Ende der Liste eine neue Spalte hinzu.
Einfügen vor Fügt vor der ausgewählten Spalte eine neue Spalte ein.
Einfügen nach Fügt nach der ausgewählten Spalte eine neue Spalte ein.

Löschen
Wählen Sie eine Spalte aus, und entfernen Sie sie dann, indem Sie auf Löschenklicken.

Typen vorschlagen
Im Dialogfeld Spaltentypen vorschlagen können Sie die Beispieldaten in der Datei auswerten, um Vorschläge für den Datentyp und die -länge der einzelnen Spalten zu erhalten. Weitere Informationen finden Sie unter Referenz zur Benutzeroberfläche des Dialogfelds „Spaltentypen vorschlagen“.

Verbindungs-Manager-Editor für Flatfiles (Vorschauseite)

Über den Knoten Vorschau im Dialogfeld Verbindungs-Manager-Editor für Flatfiles können Sie den Inhalt der Quelldatei im Tabellenformat anzeigen.

Weitere Informationen zum Verbindungs-Manager für Flatfiles finden Sie unter Flat File Verbindungs-Manager.

Optionen

Name des Verbindungs-Managers
Geben Sie einen eindeutigen Namen für die Flatfile-Verbindung im Workflow an. Der angegebene Name wird im SSIS -Designer angezeigt.

Beschreibung
Beschreiben Sie die Verbindung. Es ist eine bewährte Methode, die Verbindung zweckbezogen zu beschreiben, sodass Pakete selbsterklärend und einfacher zu verwalten sind.

Auszulassende Datenzeilen
Geben Sie an, wie viele Zeilen am Anfang von Flatfiles ausgelassen werden sollen.

Aktualisieren
Zeigen Sie an, welche Auswirkung die Änderung der Anzahl der auszulassenden Zeilen hat, indem Sie auf Aktualisierenklicken. Diese Schaltfläche wird erst angezeigt, nachdem Sie andere Verbindungsoptionen geändert haben.

Vorschau der Zeilen
Zeigen Sie Beispieldaten in der Flatfile an, die entsprechend der von Ihnen gewählten Option in Spalten und Zeilen unterteilt sind.

  • Last updated on