Freigeben über

OData-Quelle

  • Artikel

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

Verwenden Sie die OData-Quellkomponente in einem SSIS-Paket, um Daten aus einem Open Data Protocol (OData)-Dienst zu nutzen.

Unterstützte Protokolle und Datenformate

Die Komponente unterstützt die OData v3 und v4-Protokolle.

  • Für OData V3-Protokolle unterstützt die Komponente das ATOM- und das JSON-Datenformat.

  • Für OData V4-Protokolle unterstützt die Komponente das JSON-Datenformat.

Unterstützte Datenquellen

Die OData-Quelle umfasst Unterstützung für die folgenden Datenquellen:

  • Microsoft Dynamics AX Online und Microsoft Dynamics CRM Online
  • SharePoint-Listen. Um alle Listen auf einem SharePoint-Server anzuzeigen, verwenden Sie die folgende URL: https://<server>/_vti_bin/ListData.svc. Weitere Informationen zu den URL-Konventionen in SharePoint finden Sie unter SharePoint Foundation-REST-Schnittstelle.

Unterstützte Datentypen

Die OData-Datenquelle unterstützt die folgenden einfachen Datentypen: int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string und TimeSpan.

Um die Datentypen der Spalten in der Datenquelle zu ermitteln, lesen Sie die https://<OData feed endpoint>/$metadata-Seite.

Beim Datentyp Decimal werden Genauigkeit und Skalierung durch die Quellmetadaten bestimmt. Wenn die Quellmetadaten die Eigenschaften Precision und Scale nicht angeben, werden die Daten möglicherweise abgeschnitten.

Wichtig

Die OData-Quellkomponente unterstützt keine komplexen Typen wie Multiple-Choice-Elemente in SharePoint-Listen.

Hinweis

Wenn die Quelle nur eine TLS 1.2-Verbindung zulässt, müssen Sie TLS 1.2 auf Ihrem Computer über Registereinstellungen erzwingen. Führen Sie in einer Eingabeaufforderung mit erhöhten Rechten die folgenden Befehle aus:

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:64

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:32

OData-Format und Leistung

Die meisten OData-Dienste können Ergebnisse in verschiedenen Formaten zurückgeben. Sie können das Format des Resultsets mithilfe der $format-Abfrageoption angeben. Formate wie JSON und JSON Light sind effizienter als ATOM oder XML und erzielen bei der Übertragung großer Datenmengen möglicherweise eine bessere Leistung. In der folgenden Tabelle sind Ergebnisse aus Beispieltests dargestellt. Wie Sie erkennen können, ergab der Wechsel von ATOM zu JSON einen Leistungszuwachs von 30-53% und der Wechsel von ATOM zum neuen JSON Light-Format (verfügbar in WCF Data Services 5.1) einen Leistungszuwachs von 67 %.

Zeilen ATOM JSON JSON (Light)
10000 113 Sekunden 74 Sekunden 68 Sekunden
1000000 1110 Sekunden 853 Sekunden 665 Sekunden

Quellen-Editor für OData (Seite 'Verbindung')

Auf der Seite Verbindung des Dialogfelds Quellen-Editor für OData wählen Sie den OData-Verbindungs-Manager für die OData-Quelle aus. Auf dieser Seite können Sie außerdem eine Auflistung oder einen Ressourcenpfad sowie beliebige Abfrageoptionen angeben, mit denen die aus der OData-Quelle abzurufenden Daten bestimmt werden.

Statische Optionen

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

Nach dem Auswählen oder Erstellen eines Verbindungs-Managers wird im Dialogfeld die vom Verbindungs-Manager verwendete OData-Protokollversion angezeigt.

Neu
Erstellen Sie mithilfe des Dialogfelds OData-Verbindungs-Manager-Editor einen neuen Verbindungs-Manager.

Auflistung oder Ressourcenpfad verwenden
Geben Sie die Methode für die Auswahl von Daten aus der Quelle an.

Option BESCHREIBUNG
Sammlung Rufen Sie mithilfe eines Auflistungsnamens Daten aus der OData-Quelle ab.
Ressourcenpfad Rufen Sie mithilfe eines Ressourcenpfads Daten aus der OData-Quelle ab.

Abfrageoptionen
Geben Sie Optionen für die Abfrage an. Beispiel: $top=5

Feed-URL
Zeigt die schreibgeschützte Feed-URL auf Grundlage der Optionen an, die Sie in diesem Dialogfeld ausgewählt haben.

Vorschau
Zeigt mithilfe des Dialogfelds Vorschau eine Vorschau der Ergebnisse an. In derVorschau können bis zu 20 Zeilen angezeigt werden.

Dynamische Optionen

Auflistung oder Ressourcenpfad verwenden = Auflistung

Sammlung
Wählen Sie eine Auflistung aus dem Dropdownlistenfeld aus.

Auflistung oder Ressourcenpfad verwenden = Ressourcenpfad

Resource path
Geben Sie einen Ressourcenpfad ein. Beispiel: Mitarbeiter

Quellen-Editor für OData (Seite 'Spalten')

Verwenden Sie die Seite Spalten im Dialogfeld Quellen-Editor für OData , um externe (Quell-)Spalten auszuwählen, die in der Ausgabe enthalten sein sollen, und um die Spalten und Ausgabespalten einander zuzuordnen.

Tastatur

Verfügbare externe Spalten
Zeigt die Liste der in der Datenquelle verfügbaren Quellspalten an. Verwenden Sie Kontrollkästchen in der Liste, um in der Tabelle am Ende der Seite Spalten hinzuzufügen bzw. Spalten zu entfernen. Die ausgewählten Spalten werden der Ausgabe hinzugefügt.

Externe Spalte
Zeigt auswählbare Quellspalten an, die Sie in die Ausgabe einschließen können.

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.

Quellen-Editor für OData (Seite 'Fehlerausgabe')

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

Tastatur

Eingabe/Ausgabe
Zeigt den Namen der Datenquelle an.

Spalte
Zeigt die externen (Quell-)Spalten an, die im Dialogfeld Quellen-Editor für OData auf der Seite Verbindungs-Manager ausgewä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.

Weitere Informationen

OData-Verbindungs-Manager