Delen via

OData-bron

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

Gebruik het OData-brononderdeel in een SSIS-pakket om gegevens te gebruiken van een OData-service (Open Data Protocol).

Ondersteunde protocollen en gegevensindelingen

Het onderdeel ondersteunt de OData v3- en v4-protocollen.

  • Voor het OData V3-protocol ondersteunt het onderdeel de ATOM- en JSON-gegevensindelingen.

  • Voor het OData V4-protocol ondersteunt het onderdeel de JSON-gegevensindeling.

Ondersteunde gegevensbronnen

De OData-bron bevat ondersteuning voor de volgende gegevensbronnen:

  • Microsoft Dynamics AX Online en Microsoft Dynamics CRM Online
  • SharePoint-lijsten. Als u alle lijsten op een SharePoint-server wilt zien, gebruikt u de volgende URL: https://<server>/_vti_bin/ListData.svc Zie de SHAREPoint Foundation REST Interface voor meer informatie over URL-conventies van SharePoint.

Ondersteunde gegevenstypen

De OData-bron ondersteunt de volgende eenvoudige gegevenstypen: int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string en TimeSpan.

Als u de gegevenstypen van kolommen in uw gegevensbron wilt detecteren, controleert u de https://<OData feed endpoint>/$metadata pagina.

Voor het gegevenstype Decimaal worden de precisie en schaal bepaald door de bronmetagegevens. Als de bronmetagegevens niet de eigenschappen Precisie en Schaal opgeven, worden de gegevens mogelijk afgekapt.

Belangrijk

Het OData-brononderdeel biedt geen ondersteuning voor complexe typen, zoals items met meerdere keuzen, in SharePoint-lijsten.

Opmerking

Als de bron alleen TLS 1.2-verbinding toestaat, moet u TLS 1.2 op uw computer afdwingen via registerinstellingen. Voer in een opdrachtprompt met verhoogde bevoegdheid de volgende opdrachten uit:

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-indeling en -prestaties

De meeste OData-services kunnen resultaten retourneren in meerdere indelingen. U kunt de indeling van de resultatenset opgeven met behulp van de $format queryoptie. Indelingen zoals JSON en JSON Light zijn efficiënter dan ATOM of XML en kunnen u betere prestaties bieden bij het overdragen van grote hoeveelheden gegevens. De volgende tabel bevat resultaten van voorbeeldtests. Zoals u kunt zien, was er een prestatiewinst van 30-53% bij het overschakelen van ATOM naar JSON en een prestatiewinst van 67% bij het overschakelen van ATOM naar de nieuwe JSON-lichtindeling (beschikbaar in WCF Data Services 5.1).

Rows ATOM JSON JSON (licht)
10000 113 seconden 74 seconden 68 seconden
1000000 1110 seconden 853 seconden 665 seconden

OData-broneditor (verbindingspagina)

Gebruik de pagina Verbinding van het dialoogvenster OData-broneditor om het OData-verbindingsbeheer voor de OData-bron te selecteren. Op deze pagina kunt u ook een verzameling of een resourcepad en queryopties opgeven om aan te geven welke gegevens moeten worden opgehaald uit de OData-bron.

Statische opties

OData-verbindingsbeheer
Selecteer een bestaand verbindingsbeheer in de lijst of maak een nieuwe verbinding door op Nieuw te klikken.

Nadat u een verbindingsbeheer hebt geselecteerd of gemaakt, wordt in het dialoogvenster de OData-protocolversie weergegeven die de verbindingsbeheerder gebruikt.

Nieuw
Maak een nieuw verbindingsbeheer met behulp van het dialoogvenster OData Connection Manager Editor .

Verzameling of bronnenpad gebruiken
Geef de methode op voor het selecteren van gegevens uit de bron.

Optie Description
Collection Gegevens ophalen uit de OData-bron met behulp van een verzamelingsnaam.
Resourcepad Gegevens ophalen uit de OData-bron met behulp van een resourcepad.

Queryopties
Geef opties op voor de query. Bijvoorbeeld: $top=5

Url van feed
Geeft de URL van de alleen-lezenfeed weer op basis van opties die u in dit dialoogvenster hebt geselecteerd.

Voorbeeld
Voorbeeldresultaten bekijken met behulp van het dialoogvenster Voorbeeld . Een voorbeeld kan maximaal 20 rijen weergeven.

Dynamische opties

Gebruik verzameling of pad naar bron = Verzameling

verzameling
Selecteer een verzameling in de vervolgkeuzelijst.

Verzameling of resourcepad gebruiken = Resourcepad

Pad naar bron
Typ een bronpad. Bijvoorbeeld: Werknemers

OData-broneditor (kolommenpagina)

Gebruik de pagina Kolommen van het dialoogvenster OData-broneditor om externe (bron) kolommen te selecteren die moeten worden opgenomen in de uitvoer en deze toe te wijzen aan uitvoerkolommen.

Options

beschikbare externe kolommen
Bekijk de lijst met beschikbare bronkolommen in de gegevensbron. Schakel selectievakjes in de lijst in om kolommen aan de tabel onder aan de pagina toe te voegen of te verwijderen. De geselecteerde kolommen worden toegevoegd aan de uitvoer.

Externe Kolom
Bronkolommen weergeven die u hebt gekozen voor opname in de uitvoer.

Uitvoerkolom
Geef een unieke naam op voor elke uitvoerkolom. De standaardwaarde is de naam van de geselecteerde externe kolom (bronkolom; U kunt echter elke unieke, beschrijvende naam kiezen.

OData-broneditor (foutuitvoerpagina)

Gebruik de pagina Foutuitvoer van het dialoogvenster OData-broneditor om opties voor foutafhandeling te selecteren en eigenschappen in te stellen voor kolommen voor foutuitvoer.

Options

Invoer/Uitvoer
Bekijk de naam van de gegevensbron.

kolom
Bekijk de externe (bron)kolommen die u hebt geselecteerd op de pagina Verbindingsbeheer van het dialoogvenster OData-broneditor .

Error
Geef op wat er moet gebeuren wanneer er een fout optreedt: de fout negeren, de rij omleiden of het onderdeel mislukken.

verwante onderwerpen:foutafhandeling in gegevens

Afkorting
Geef op wat er moet gebeuren wanneer er een afkapping plaatsvindt: de fout negeren, de rij omleiden of het onderdeel laten falen.

Beschrijving
Bekijk de beschrijving van de fout.

deze waarde instellen op geselecteerde cellen
Geef op wat er moet gebeuren met alle geselecteerde cellen wanneer er een fout of truncatie optreedt: negeer de fout, leid de rij om, of laat het onderdeel falen.

Toepassen
Pas de foutafhandelingsoptie toe op de geselecteerde cellen.

Zie ook

OData Connection Manager

  • Last updated on