Teilen über


Excel-Quelle

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

Die Excel-Quelle extrahiert Daten aus Arbeitsblättern oder Bereichen in Microsoft Excel-Arbeitsmappen.

Wichtig

Ausführliche Informationen über das Herstellen einer Verbindung mit Excel-Dateien sowie Einschränkungen und bekannte Probleme beim Laden von Daten aus oder in Excel-Dateien finden Sie unter Load data from or to Excel with SQL Server Integration Services (SSIS) (Laden von Daten aus oder in Excel mit SQL Server Integration Services (SSIS)).

Zugriffsmodi

Die Excel-Quelle stellt vier verschiedene Datenzugriffsmodi zum Extrahieren von Daten bereit:

  • Eine Tabelle oder Sicht.

  • Eine in einer Variablen angegebene Tabelle oder Sicht.

  • Die Ergebnisse einer SQL-Anweisung. Bei der Abfrage kann es sich um eine parametrisierte Abfrage handeln.

  • Die Ergebnisse einer SQL-Anweisung, die in einer Variablen gespeichert ist.

Die Excel-Quelle verwendet einen Excel-Verbindungs-Manager zum Herstellen einer Verbindung mit einer Datenquelle. Dieser Verbindungs-Manager gibt die zu verwendende Arbeitsmappendatei an. Weitere Informationen finden Sie unter Excel Connection Manager.

Die Excel-Quelle weist eine reguläre Ausgabe und eine Fehlerausgabe auf.

Konfiguration der Excel-Quelle

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

Das Dialogfeld Erweiterter Editor enthält alle Eigenschaften, die programmgesteuert festgelegt werden können. Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im Dialogfeld Erweiterter Editor oder programmgesteuert festlegen können:

Informationen zum Durchlaufen einer Gruppe von Excel-Dateien finden Sie unter Schleife durch Excel-Dateien und Tabellen mit einem Foreach-Schleifencontainer.

Quellen-Editor für Excel (Seite Verbindungs-Manager)

Mithilfe des Knotens Verbindungs-Manager im Dialogfeld Quellen-Editor für Excel können Sie eine Microsoft Excel -Arbeitsmappe für die Quelle auswählen. Die Excel-Quelle liest Daten aus einem Arbeitsblatt oder dem benannten Bereich einer vorhandenen Arbeitsmappe.

Hinweis

Die CommandTimeout -Eigenschaft der Excel-Quelle ist nicht im Quellen-Editor für Excelverfügbar, kann jedoch mit dem Dialogfeld Erweiterter Editorfestgelegt werden. Weitere Informationen zu dieser Eigenschaft finden Sie im Abschnitt Excel-Quelle von Excel Custom Properties.

Statische Optionen

Teilcache
Wählen Sie einen vorhandenen Excel-Verbindungs-Manager aus der Liste aus, oder erstellen Sie eine neue Verbindung, indem Sie auf Neuklicken.

Neu
Erstellen Sie mithilfe des Dialogfelds Excel-Verbindungs-Manager eine neue Verbindung.

Datenzugriffsmodus
Geben Sie die Methode für die Auswahl von Daten aus der Quelle an.

Wert BESCHREIBUNG
Tabelle oder Sicht Ruft Daten aus einem Arbeitsblatt oder dem benannten Bereich einer Excel-Datei ab.
Variable für Tabellenname oder Sichtname Geben Sie den Namen des Arbeitsblatts oder Bereichs in einer Variablen an.

Verwandte Informationen: Verwenden von Variablen in Paketen
SQL-Befehl Ruft mithilfe einer SQL-Abfrage Daten aus einer Excel-Datei ab.
SQL-Befehl aus Variable Gibt den SQL-Abfragetext in einer Variablen an.

Vorschau
Zeigen Sie mithilfe des Dialogfelds Datenansicht eine Vorschau der Ergebnisse an. In der Vorschau können bis zu 200 Zeilen angezeigt werden.

Dynamische Optionen (Datenzugriffsmodus)

Datenzugriffsmodus = Tabelle oder Sicht

Name der Excel-Tabelle
Wählen Sie in der Liste der in der Excel-Arbeitsmappe verfügbaren Objekte den Namen des Arbeitsblatts oder des benannten Bereichs aus.

Datenzugriffsmodus = Variable für Tabellenname oder Sichtname

Variablenname
Wählen Sie die Variable aus, die den Namen des Arbeitsblatts oder des benannten Bereichs enthält.

Datenzugriffsmodus = SQL-Befehl

SQL-Befehlstext
Geben Sie den Text der SQL-Abfrage ein, und erstellen Sie die Abfrage, indem Sie auf Abfrage erstellenklicken. Wahlweise können Sie auch nach der Datei mit dem Abfragetext suchen, indem Sie auf Durchsuchenklicken.

Parameter
Wenn Sie eine parametrisierte Abfrage eingeben und im Abfragetext ? als Parameterplatzhalter verwenden, können Sie den Paketvariablen mithilfe des Dialogfelds Abfrageparameter festlegen Abfrageeingabeparameter zuordnen.

Abfrage erstellen
Mithilfe des Dialogfelds Abfrage-Generator können Sie die SQL-Abfrage visuell erstellen.

Durchsuchen
Mithilfe des Dialogfelds Öffnen können Sie nach der Datei suchen, die den Text der SQL-Abfrage enthält.

Abfrage analysieren
Überprüft die Syntax des Abfragetexts.

Datenzugriffsmodus = SQL-Befehl aus Variable

Variablenname
Wählen Sie die Variable aus, die den Text für die SQL-Abfrage enthält.

Quellen-Editor für Excel (Seite Spalten)

Mithilfe der Seite Spalten des Dialogfelds Quellen-Editor für Excel können Sie jeder externen (Quell-)Spalte eine Ausgabespalte zuordnen.

Tastatur

Verfügbare externe Spalten
Zeigt die Liste der in der Datenquelle verfügbaren externen Spalten an. Mit der Tabelle können keine Spalten hinzugefügt oder gelöscht werden.

Externe Spalte
Zeigt die externen (Quell-)Spalten in der Reihenfolge an, in der sie von dem Task gelesen werden. Sie können die Reihenfolge ändern, indem Sie zunächst die ausgewählten Spalten in der oben besprochenen Tabelle löschen. Wählen Sie anschließend die externen Spalten in einer anderen Reihenfolge aus der Liste aus.

Ausgabespalte
Geben Sie für jede Ausgabespalte einen eindeutigen Namen an. Standardmäßig wird der Name der ausgewählten externen (Quell-)Spalte verwendet. Sie können jedoch auch einen beschreibenden Namen angeben, sofern dieser eindeutig ist. Der angegebene Name wird im SSIS -Designer angezeigt.

Quellen-Editor für Excel (Seite Fehlerausgabe)

Mithilfe der Seite Fehlerausgabe des Dialogfelds Quellen-Editor für Excel können Sie Fehlerbehandlungsoptionen auswählen und Eigenschaften für Fehlerausgabespalten festlegen.

Tastatur

Eingabe oder Ausgabe
Zeigt den Namen der Datenquelle an.

Spalte
Zeigt die externen (Quell-)Spalten an, die im Dialogfeld Quellen-Editor für Excel auf der Seite Verbindungs-Managerausgewählt wurden.

Fehler
Gibt an, was bei Auftreten eines Fehlers geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente mit einem Fehler abbrechen.

Verwandte Themen: Fehlerbehandlung in Daten

Abschneiden
Gibt an, was im Falle einer Kürzung geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente mit einem Fehler abbrechen.

Beschreibung
Zeigt die Beschreibung des Fehlers an.

Diesen Wert für ausgewählte Zellen festlegen
Gibt an, was im Falle eines Fehlers oder einer Kürzung mit den ausgewählten Zellen geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente mit einem Fehler abbrechen.

Anwenden
Wendet die Fehlerbehandlungsoption auf die ausgewählten Zellen an.

Laden von Daten aus oder in Excel mit SQL Server Integration Services (SSIS)
Excel-Ziel
Excel-Verbindungs-Manager