Zdroj OData

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Pomocí komponenty OData Source v balíčku SSIS můžete využívat data ze služby OData (Open Data Protocol).

Podporované protokoly a formáty dat

Komponenta podporuje protokoly OData v3 a v4.

  • Pro protokol OData V3 komponenta podporuje formáty dat ATOM a JSON.

  • Pro protokol OData V4 komponenta podporuje formát dat JSON.

Podporované zdroje dat

Zdroj OData zahrnuje podporu pro následující zdroje dat:

  • Microsoft Dynamics AX Online a Microsoft Dynamics CRM Online
  • SharePointové seznamy Pokud chcete zobrazit všechny seznamy na sharepointovém serveru, použijte následující adresu URL: https://<server>/_vti_bin/ListData.svc. Další informace o konvencích adresy URL služby SharePoint naleznete v tématu Rozhraní REST služby SharePoint Foundation.

Podporované datové typy

Zdroj OData podporuje následující jednoduché datové typy: int, byte[], bool, byte, DateTime, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string a TimeSpan.

Pokud chcete zjistit datové typy sloupců ve zdroji dat, zkontrolujte https://<OData feed endpoint>/$metadata stránku.

U datového typu Decimal se přesnost a měřítko určují zdrojovými metadaty. Pokud zdrojová metadata nezadávají vlastnosti Přesnost a měřítko , mohou být data zkrácena.

Důležité

Komponenta Zdroj OData nepodporuje složité typy, jako jsou položky s více volbami, v seznamech SharePointu.

Poznámka:

Pokud zdroj povoluje pouze připojení TLS 1.2, musíte na svém počítači vynutit protokol TLS 1.2 prostřednictvím nastavení registru. Na příkazovém řádku se zvýšenými oprávněními spusťte následující příkazy:

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

Formát a výkon OData

Většina služeb OData může vrátit výsledky ve více formátech. Formát sady výsledků můžete zadat pomocí $format možnosti dotazu. Formáty, jako jsou JSON a JSON Light, jsou efektivnější než ATOM nebo XML a můžou vám poskytnout lepší výkon při přenosu velkých objemů dat. Následující tabulka obsahuje výsledky ukázkových testů. Jak vidíte, při přechodu z ATOMu na JSON došlo ke zvýšení výkonu o 30 až 53 % a při přechodu z ATOMu na nový světlý formát JSON (k dispozici ve službách WCF Data Services 5.1) došlo ke zvýšení výkonu o 67 %.

Rows ATOM JSON JSON (Light)
10000 113 sekund 74 sekund 68 sekund
1000000 1110 sekund 853 sekund 665 sekund

Editor zdroje OData (stránka připojení)

Pomocí stránky Připojení v dialogovém okně Editoru zdrojů OData vyberte správce připojení OData pro zdroj OData. Tato stránka umožňuje zadat buď kolekci, nebo cestu k prostředku a také jakékoli možnosti dotazu pro určení, jaká data je potřeba načíst ze zdroje OData.

Statické možnosti

Správce připojení OData
V seznamu vyberte existujícího správce připojení nebo kliknutím na Nový vytvořte nové připojení.

Po výběru nebo vytvoření správce připojení se v dialogovém okně zobrazí verze protokolu OData, kterou správce připojení používá.

Nový
Pomocí dialogového okna Editoru správce připojení OData vytvořte nového správce připojení.

Použijte cestu ke kolekci nebo prostředku
Zadejte metodu pro výběr dat ze zdroje.

Možnost Description
Collection Načtěte data ze zdroje OData pomocí názvu kolekce.
Cesta k prostředku Načtěte data ze zdroje OData pomocí cesty prostředku.

Možnosti dotazu
Zadejte možnosti dotazu. Příklad: $top=5

Adresa URL informačního kanálu
Zobrazí adresu URL informačního kanálu jen pro čtení na základě možností, které jste vybrali v tomto dialogovém okně.

Preview
Náhled výsledků pomocí dialogového okna Náhled Náhled může zobrazit až 20 řádků.

Dynamické možnosti

Použití kolekce nebo cesty ke zdroji = Kolekce

Kolekce
V rozevíracím seznamu vyberte kolekci.

Použití cesty k kolekci nebo prostředku = Cesta k prostředku nebo kolekci

Cesta ke zdroji
Zadejte cestu k prostředku. Příklad: Zaměstnanci

Editor zdrojového kódu OData (stránka sloupců)

Stránka Sloupce v dialogovém okně Editor zdrojů OData slouží k výběru externích (zdrojových) sloupců, které se mají zahrnout do výstupu, a jejich mapování na výstupní sloupce.

Možnosti

Dostupné externí sloupce
Zobrazí seznam dostupných zdrojových sloupců ve zdroji dat. Zaškrtávací políčka v seznamu slouží k přidání nebo odebrání sloupců do tabulky v dolní části stránky. Vybrané sloupce se přidají do výstupu.

externí sloupec
Zobrazit zdrojové sloupce, které jste zvolili pro zahrnutí do výstupu.

Výstupní sloupec
Zadejte jedinečný název pro každý výstupní sloupec. Výchozí hodnota je název vybraného externího (zdrojového) sloupce; můžete ale zvolit libovolný jedinečný popisný název.

Editor zdroje OData (chybová stránka výstupu)

Pomocí stránky Výstup chyby v dialogovém okně Editor zdroje OData vyberte možnosti zpracování chyb a nastavte vlastnosti u výstupních sloupců chyb.

Možnosti

vstupní/výstupní
Zobrazí název zdroje dat.

sloupce
Zobrazte externí (zdrojové) sloupce, které jste vybrali na stránce Správce připojení v dialogovém okně Editor zdrojů OData .

Error
Určete, co se má stát, když dojde k chybě: ignorovat selhání, přesměrovat řádek nebo nechat komponentu selhat.

Související témata:Zpracování chyb v datech

Zkrácení
Určete, co se má stát, když dojde ke zkrácení: ignorovat selhání, přesměrovat řádek nebo nechat komponentu selhat.

Description
Zobrazte popis chyby.

Nastavit tuto hodnotu pro vybrané buňky
Určete, co se má stát se všemi vybranými buňkami, když dojde k chybě nebo zkrácení: ignorujte selhání, přesměrujte řádek nebo nechte komponentu selhat.

Použít
Použití možnosti zpracování chyb u vybraných buněk

Viz také

Správce připojení OData

  • Last updated on