Udostępnij przez

Źródło OData

Dotyczy:SQL Server SSIS Integration Runtime w ramach usługi Azure Data Factory

Użyj składnika źródła OData w pakiecie SSIS, aby korzystać z danych z usługi Open Data Protocol (OData).

Obsługiwane protokoły i formaty danych

Składnik obsługuje protokoły OData w wersji 3 i 4.

  • W przypadku protokołu OData V3 składnik obsługuje formaty danych ATOM i JSON.

  • W przypadku protokołu OData V4 składnik obsługuje format danych JSON.

Obsługiwane źródła danych

Źródło OData obejmuje obsługę następujących źródeł danych:

  • Microsoft Dynamics AX Online i Microsoft Dynamics CRM Online
  • Listy programu SharePoint. Aby wyświetlić wszystkie listy na serwerze programu SharePoint, użyj następującego adresu URL: https://<server>/_vti_bin/ListData.svc. Aby uzyskać więcej informacji na temat konwencji adresów URL programu SharePoint, zobacz Interfejs REST programu SharePoint Foundation.

Obsługiwane typy danych

Źródło OData obsługuje następujące proste typy danych: int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string i TimeSpan.

Aby sprawdzić typy danych kolumn w swoim źródle danych, odwiedź stronę https://<OData feed endpoint>/$metadata.

W przypadku typu danych dziesiętnych precyzja i skala są określane przez metadane źródłowe. Jeśli metadane źródłowe nie określają właściwości Precyzja i Skalowanie , dane mogą zostać obcięte.

Ważne

Składnik źródła OData nie obsługuje złożonych typów, takich jak elementy wielokrotnego wyboru, na listach programu SharePoint.

Uwaga / Notatka

Jeśli źródło zezwala tylko na połączenie TLS 1.2, należy wymusić protokół TLS 1.2 na maszynie za pomocą ustawień rejestru. W wierszu polecenia z podwyższonym poziomem uprawnień uruchom następujące polecenia:

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

Format I wydajność OData

Większość usług OData może zwracać wyniki w wielu formatach. Format zestawu wyników można określić przy użyciu $format opcji zapytania. Formaty, takie jak JSON i JSON Light, są wydajniejsze niż ATOM lub XML i mogą zapewnić lepszą wydajność podczas przesyłania dużych ilości danych. Poniższa tabela zawiera wyniki z przykładowych testów. Jak widać, podczas przełączania z ATOM na JSON nastąpił wzrost wydajności o 30–53%, a przy przełączaniu z ATOM na nowy format JSON light (dostępny w usługach WCF Data Services 5.1) zanotowano wzrost wydajności o 67%.

Wiersze ATOM JSON JSON (jasny)
10000 113 sekund 74 sekundy 68 sekund
1000000 1110 sekund 853 sekundy 665 sekund

Edytor źródła OData (strona połączenia)

Użyj strony Połączenie okna dialogowego Edytora źródła OData , aby wybrać menedżera połączeń OData dla źródła OData. Ta strona umożliwia również określenie kolekcji lub ścieżki zasobu oraz wszelkich opcji zapytania, aby wskazać, jakie dane należy pobrać ze źródła OData.

Opcje statyczne

Menedżer połączeń OData
Wybierz istniejącego menedżera połączeń z listy lub utwórz nowe połączenie, klikając pozycję Nowy.

Po wybraniu lub utworzeniu menedżera połączeń w oknie dialogowym zostanie wyświetlona wersja protokołu OData używana przez menedżera połączeń.

New
Utwórz nowego menedżera połączeń przy użyciu okna dialogowego Edytora menedżera połączeń OData .

Użyj kolekcji lub ścieżki zasobu
Określ metodę wybierania danych ze źródła.

Option Description
Kolekcja Pobieranie danych ze źródła OData przy użyciu nazwy kolekcji.
Ścieżka zasobu Pobierz dane ze źródła OData przy użyciu ścieżki zasobu.

Opcje zapytania
Określ opcje zapytania. Przykład: $top=5

Adres URL kanału informacyjnego
Wyświetla adres URL kanału informacyjnego tylko do odczytu na podstawie opcji wybranych w tym oknie dialogowym.

Preview
Podgląd wyników przy użyciu okna dialogowego Podgląd . Podgląd może wyświetlać maksymalnie 20 wierszy.

Opcje dynamiczne

Użyj kolekcji lub ścieżki zasobów = Kolekcja

Kolekcja
Wybierz kolekcję z listy rozwijanej.

Użyj kolekcji lub ścieżki zasobów = Ścieżka zasobów

Ścieżka zasobu
Wpisz ścieżkę zasobu. Na przykład: Pracownicy

Edytor źródła OData (strona kolumn)

Użyj strony Kolumny okna dialogowego Edytor źródła OData , aby wybrać kolumny zewnętrzne (źródłowe), które mają zostać uwzględnione w danych wyjściowych, i zamapuj je na kolumny wyjściowe.

Opcje

Dostępne kolumny zewnętrzne
Wyświetl listę dostępnych kolumn źródłowych w źródle danych. Użyj pól wyboru na liście, aby dodać lub usunąć kolumny do tabeli w dolnej części strony. Wybrane kolumny są dodawane do danych wyjściowych.

Kolumna zewnętrzna
Wyświetl kolumny źródłowe, które chcesz uwzględnić w danych wyjściowych.

kolumna wyjściowa
Podaj unikatową nazwę dla każdej kolumny danych wyjściowych. Wartość domyślna to nazwa wybranej kolumny zewnętrznej (źródłowej). można jednak wybrać dowolną unikatową, opisową nazwę.

Edytor źródła OData (strona wyjścia błędu)

Użyj strony Błędy wyjściowe okna dialogowego Edytora źródła OData, aby wybrać opcje obsługi błędów i ustawić właściwości w kolumnach błędów wyjściowych.

Opcje

wejściowe/wyjściowe
Wyświetl nazwę źródła danych.

Kolumna
Wyświetl kolumny zewnętrzne (źródłowe) wybrane na stronie Menedżer połączeń okna dialogowego Edytor źródła OData .

Error
Określ, co powinno się stać, gdy wystąpi błąd: zignoruj go, przekieruj wiersz lub spowoduj awarię składnika.

Tematy związane:Obsługa błędów w danych

Obcinania
Określ, co powinno się zdarzyć, gdy wystąpi skrócenie: zignoruj błąd związany ze skróceniem, przekieruj wiersz lub spowoduj awarię składnika.

Opis
Wyświetl opis błędu.

Przypisz tę wartość do zaznaczonych komórek
Wskaż, co powinno się zdarzyć z wszystkimi zaznaczonymi komórkami, gdy wystąpi błąd lub obcięcie: zignoruj usterkę, przekieruj wiersz lub spowoduj niepowodzenie komponentu.

Zastosuj
Zastosuj opcję obsługi błędów do zaznaczonych komórek.

Zobacz też

Menedżer połączeń OData

  • Last updated on