Dateiverbindungs-Manager

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

Mit einem Dateiverbindungs-Manager kann ein Paket auf eine vorhandene Datei oder einen vorhandenen Ordner verweisen bzw. eine Datei oder einen Ordner zur Laufzeit erstellen. Beispielsweise können Sie auf eine Excel-Datei verweisen. Zur Ausführung bestimmter Komponenten in Microsoft SQL Server Integration Services werden in Dateien enthaltene Informationen verwendet. Beispielsweise kann eine „SQL ausführen“-Task auf eine Datei verweisen, die die SQL-Anweisungen enthält, welche von der Task ausgeführt werden. Mit anderen Komponenten werden Vorgänge für Dateien ausgeführt. Mit dem Task Dateisystem kann beispielsweise auf eine Datei verwiesen werden, die an einen neuen Ort kopiert werden soll.

Verwendungstypen des Dateiverbindungs-Managers

Mit der FileUsageType -Eigenschaft des Dateiverbindungs-Managers wird angegeben, wie die Dateiverbindung verwendet wird. Der Dateiverbindungs-Manager kann eine Datei bzw. einen Ordner erstellen und eine vorhandene Datei bzw. einen vorhandenen Ordner verwenden.

In der folgenden Tabelle sind die Werte von FileUsageTypeaufgeführt.

Wert Beschreibung
0 Der Dateiverbindungs-Manager verwendet eine vorhandene Datei.
1 Der Dateiverbindungs-Manager erstellt eine Datei.
2 Der Dateiverbindungs-Manager verwendet einen vorhandenen Ordner.
3 Der Dateiverbindungs-Manager erstellt einen Ordner.

Mehrere Datei- oder Ordnerverbindungen

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

Konfiguration des Verbindungs-Managers für Dateien

Wenn Sie einem Paket einen Dateiverbindungs-Manager hinzufügen, erstellt Integration Services einen Verbindungs-Manager, der zur Laufzeit in eine Dateiverbindung aufgelöst wird, die Eigenschaften der Dateiverbindung festlegt und der Connections -Sammlung des Pakets die Dateiverbindung hinzufügt.

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

Es gibt folgende Möglichkeiten, um einen Dateiverbindungs-Manager zu konfigurieren:

  • Geben Sie den Verwendungstyp an.

  • Geben Sie eine Datei oder einen Ordner an.

Sie können die ConnectionString-Eigenschaft für den Dateiverbindungs-Manager festlegen, indem Sie einen Ausdruck im Eigenschaftenfenster von SQL Server Data Tools (SSDT)angeben. Um jedoch einen Validierungsfehler zu vermeiden, wenn Sie mithilfe eines Ausdrucks die Datei oder den Ordner angeben, fügen Sie im Dateiverbindungs-Manager-Editor für Datei/Ordner einen Pfad für eine Datei oder einen Ordner hinzu.

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.

Dateiverbindungs-Manager-Editor

Im Dialogfeld Dateiverbindungs-Manager-Editor werden die Eigenschaften angegeben, die zum Herstellen einer Verbindung zu einer Datei oder einem Ordner verwendet werden.

Hinweis

Sie können die ConnectionString-Eigenschaft für den Dateiverbindungs-Manager festlegen, indem Sie einen Ausdruck im Eigenschaftenfenster von SQL Server Data Tools (SSDT)angeben. Um jedoch einen Validierungsfehler zu vermeiden, wenn Sie einen Ausdruck verwenden, um die Datei oder den Ordner anzugeben, fügen Sie im Editor für den Dateiverbindungs-Manager unter Datei/Ordner einen Datei- oder Ordnerpfad hinzu.

Weitere Informationen zum Dateiverbindungs-Manager finden Sie unter File Verbindungs-Manager.

Optionen

Verwendungstyp
Geben Sie an, ob die Verbindung vom Dateiverbindungs-Manager zu einer vorhandenen Datei oder einem vorhandenen Ordner hergestellt werden soll, oder ob dafür eine neue Datei oder ein neuer Ordner erstellt werden soll.

Wert Beschreibung
Datei erstellen Erstellen Sie zur Laufzeit eine neue Datei.
Vorhandene Datei Verwenden Sie eine vorhandene Datei.
Ordner erstellen Erstellen Sie zur Laufzeit einen neuen Ordner.
Vorhandener Ordner Verwenden Sie einen vorhandenen Ordner.

Datei/Ordner
Bei Dateigeben Sie die zu verwendende Datei an.

Bei Ordnergeben Sie den zu verwendenden Ordner an.

Durchsuchen
Wählen Sie die Datei oder den Ordner mithilfe des Dialogfelds Datei auswählen oder des Dialogfelds Ordner suchen aus.

Referenz zur Benutzeroberfläche des Dialogfelds „Dateiverbindungs-Manager hinzufügen“

Mithilfe des Dialogfelds Dateiverbindungs-Manager hinzufügen können Sie eine Verbindung zu einer Gruppe von Dateien oder Ordnern definieren.

Weitere Informationen zum Verbindungs-Manager für mehrere Dateien finden Sie unter Multiple Files Verbindungs-Manager.

Hinweis

Die integrierten Tasks und Datenflusskomponenten in Integration Services verwenden keinen Verbindungs-Manager für mehrere Dateien. Sie können den Verbindungs-Manager jedoch im Skripttask oder in der Skriptkomponente verwenden.

Dialogfeldoptionen zum Hinzufügen von Datei-Verbindungs-Manager

Verwendungstyp
Geben Sie den Dateityp an, der vom Verbindungs-Manager für mehrere Dateien verwendet werden soll.

Wert Beschreibung
Erstellen von Dateien Der Verbindungs-Manager erstellt die Dateien.
Vorhandene Dateien Der Verbindungs-Manager verwendet vorhandene Dateien.
Ordner erstellen Der Verbindungs-Manager erstellt die Ordner.
Vorhandene Ordner Der Verbindungs-Manager verwendet vorhandene Ordner.

Dateien / Ordner
Zeigen Sie die hinzugefügten Dateien oder Ordner an, indem Sie die im Folgenden beschriebenen Schaltflächen verwenden.

Add (Hinzufügen)
Fügen Sie eine Datei hinzu, indem Sie das Dialogfeld Dateien auswählen verwenden, oder fügen Sie mithilfe des Dialogfelds Ordner suchen einen Ordner hinzu.

Bearbeiten
Wählen Sie eine Datei oder einen Ordner aus, und ersetzen Sie diese(n) dann mithilfe des Dialogfelds Dateien auswählen bzw. Ordner suchen durch eine andere Datei oder einen anderen Ordner.

Entfernen
Wählen Sie eine Datei oder einen Ordner aus, und klicken Sie auf die Schaltfläche Entfernen , um das betreffende Objekt aus der Liste zu entfernen.

Pfeilschaltflächen
Wählen Sie eine Datei oder einen Ordner aus, und verschieben Sie das Objekt dann mit den Pfeilschaltflächen nach oben oder unten, um die Reihenfolge des Zugriffs festzulegen.

Referenz der Benutzeroberfläche für das Dialogfeld „Spaltentypen vorschlagen“

Identifizieren Sie mithilfe des Dialogfelds Spaltentypen vorschlagen den Datentyp und die -länge von Spalten im Verbindungs-Manager für Flatfiles basierend auf einer Stichprobe für den Dateiinhalt.

Weitere Informationen zu den von Integration Servicesverwendeten Datentypen, finden Sie unter Integration Services-Datentypen.

Dialogfeldoptionen für „Spaltentypen vorschlagen“

Anzahl von Zeilen
Geben Sie die Anzahl der Zeilen in der Stichprobe ein, die der Algorithmus verwendet, oder wählen Sie sie aus.

Den kleinsten integer-Datentyp vorschlagen
Deaktivieren Sie dieses Kontrollkästchen, um die Analyse auszulassen. Wenn diese Option ausgewählt ist, wird der kleinstmögliche Ganzzahl-Datentyp für Spalten bestimmt, die ganzzahlige numerische Daten enthalten.

Den kleinsten Real-Datentyp vorschlagen
Deaktivieren Sie dieses Kontrollkästchen, um die Analyse auszulassen. Wenn dieses Kontrollkästchen aktiviert ist, bestimmt es, ob Spalten mit numerischen Daten vom real-Typ den kleineren real-Datentyp, DT_R4, verwenden können.

Boolesche Spalten mithilfe der folgenden Werte identifizieren
Geben Sie die beiden Werte ein, die Sie als die booleschen Werte für true und false verwenden möchten. Die Werte müssen durch ein Komma getrennt sein. Der erste Wert repräsentiert True.

Zeichenfolgenspalten auffüllen
Aktivieren Sie dieses Kontrollkästchen, um die Zeichenfolgenauffüllung zu aktivieren.

Innenabstand in Prozent
Geben Sie den Prozentsatz der Spaltenlänge ein, um den die Länge von Spalten für Zeichendatentypen vergrößert werden soll, oder wählen Sie den Wert aus. Der Prozentsatz muss als ganze Zahl angegeben werden.