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 Ansicht.

  • 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 werden.

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 Verbindungs-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 Excel-Dateien und -Tabellen mit einem Foreach-Loop-Container durchlaufen.

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

OLE DB-Verbindungs-Manager
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 Ansicht 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 Ansicht

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 Tabellen- oder Ansichtsname

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 mithilfe von ? eingegeben haben Wenn Sie im Abfragetext einen Parameterplatzhalter verwenden, können Sie mithilfe des Dialogfelds Abfrageparameter festlegen die Eingabeparameter der Abfrage Paketvariablen 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.

Excel-Quelleditor (Spaltenseite)

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

Optionen

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.

Excel-Quellen-Editor (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.

Optionen

Eingabe oder Ausgabe
Zeigt den Namen der Datenquelle an.

Spalte
Zeigen Sie die externen Spalten (Quellspalten) an, die Sie auf der Seite "Verbindungs-Manager " im Dialogfeld " Excel-Quell-Editor " ausgewählt haben.

Fehler
Geben Sie an, was geschehen soll, wenn ein Fehler auftritt: den Fehler ignorieren, die Zeile umleiten oder einen Fehler für die Komponente auslösen.

Verwandte Themen:Fehlerbehandlung in Daten

Abschneidung
Gibt an, was bei einer Abschneidung geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente fehlschlagen lassen.

Beschreibung
Zeigt die Beschreibung des Fehlers an.

Diesen Wert für ausgewählte Zellen festlegen
Legen Sie fest, was mit allen ausgewählten Zellen geschehen soll, wenn ein Fehler auftritt oder Daten abgeschnitten werden: den Fehler ignorieren, die Zeile umleiten oder einen Fehler für die Komponente verursachen.

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