Udostępnij przez


Źródło danych OData

Podsumowanie

Produkt Description
Status wydania Ogólna dostępność
Products Excel
Power BI (modele semantyczne)
Power BI (przepływy danych)
Sieć szkieletowa (Dataflow Gen2)
Power Apps (przepływy danych)
Dynamics 365 Customer Insights
Analysis Services
Obsługiwane typy uwierzytelniania Anonim
Windows (wymaga bramy)
Podstawowa (wymaga bramy)
Internetowe API
Konto organizacyjne
Dokumentacja referencyjna funkcji OData.Feed, ODataOmitValues.Nulls

Uwaga / Notatka

Niektóre funkcje mogą być obecne w jednym produkcie, ale nie w innych ze względu na harmonogramy wdrażania i możliwości specyficzne dla hosta.

Obsługiwane funkcje

  • Basic
  • Zaawansowany
    • Części adresu URL
    • Kolumny typu otwartego
  • Wybieranie powiązanych tabel

Uwaga / Notatka

Program Microsoft Graph nie jest obsługiwany. Więcej informacji: Brak obsługi programu Microsoft Graph w dodatku Power Query

Ładowanie danych ze źródła danych OData w programie Power Query Desktop

Aby załadować dane ze źródła danych OData w programie Power Query Desktop:

  1. Wybierz OData lub OData Feed w środowisku uzyskiwania danych. Środowisko pobierania danych w programie Power Query Desktop różni się między aplikacjami. Aby uzyskać więcej informacji na temat środowiska pobierania danych w Power Query Desktop dla swojej aplikacji, przejdź do Gdzie uzyskać dane.

  2. Wybierz przycisk Podstawowy i wprowadź adres URL w polu tekstowym. Ten adres URL powinien być korzeniem usługi OData, z którą chcesz nawiązać połączenie. Na przykład wprowadź https://services.odata.org/V4/northwind/northwind.svc/. Następnie wybierz opcję OK.

    Zrzut ekranu przedstawiający okno dialogowe połączenia ze źródłem danych OData z wprowadzonym przykładowym adresem URL OData.

    Jeśli wprowadzony adres URL jest nieprawidłowy, obok pola tekstowego ADRESU URL zostanie wyświetlona ikona ostrzeżenia.

  3. Jeśli łączysz się przy użyciu źródła danych OData po raz pierwszy, wybierz typ uwierzytelniania, wprowadź poświadczenia (w razie potrzeby) i wybierz poziom, do którego chcesz zastosować ustawienia uwierzytelniania. Następnie wybierz pozycję Połącz.

    Zrzut ekranu przedstawiający okno dialogowe uwierzytelniania, w którym wprowadzasz poświadczenia OData.

  4. W oknie dialogowym Nawigator możesz wybrać tabelę, a następnie przekształcić dane w edytorze Power Query, wybierając pozycję Przekształć dane lub załadować dane, wybierając pozycję Załaduj.

    Zrzut ekranu przedstawiający nawigator z wybraną alfabetyczną listą produktów.

    Jeśli masz wiele tabel, które mają bezpośrednią relację z jedną lub kilkoma już wybranymi tabelami, możesz wybrać przycisk Wybierz powiązane tabele . W takim przypadku importowane są również wszystkie tabele, które mają bezpośrednią relację z co najmniej jedną z już wybranych tabel.

Ładowanie danych ze źródła danych OData w usłudze Power Query Online

Aby załadować dane ze źródła danych OData w usłudze Power Query Online:

  1. Wybierz opcję Źródło danych OData lub Źródło danych OData Feed w interfejsie pobierania danych. Różne aplikacje mają różne sposoby uzyskiwania danych w usłudze Power Query Online. Aby uzyskać więcej informacji na temat sposobu dotarcia do funkcji pobierania danych w Power Query Online z aplikacji, przejdź do Gdzie uzyskać dane.

    Zrzut ekranu przedstawiający okno pobierania danych z wyróżnieniem OData.

  2. W wyświetlonym oknie dialogowym OData wprowadź adres URL w polu tekstowym.

    Zrzut ekranu przedstawiający stronę logowania online OData.

  3. Jeśli łączysz się przy użyciu źródła danych OData po raz pierwszy, wybierz rodzaj uwierzytelniania i wprowadź swoje poświadczenia (jeśli to konieczne). Następnie wybierz Dalej.

  4. W oknie dialogowym Nawigator możesz wybrać tabelę, a następnie przekształcić dane w edytorze Power Query, wybierając pozycję Przekształć dane.

    Zrzut ekranu przedstawiający nawigatora online z alfabetyczną listą wybranych i wyświetlanych produktów.

    Jeśli masz wiele tabel, które mają bezpośrednią relację z jedną lub kilkoma już wybranymi tabelami, możesz wybrać przycisk Wybierz powiązane tabele . W takim przypadku importowane są również wszystkie tabele, które mają bezpośrednią relację z co najmniej jedną z już wybranych tabel.

Nawiązywanie połączenia z programem Microsoft Graph

Nawiązywanie połączenia z interfejsami API REST programu Microsoft Graph z poziomu dodatku Power Query nie jest zalecane ani obsługiwane. Aby uzyskać więcej informacji, zobacz Brak obsługi programu Microsoft Graph w dodatku Power Query.

Znane problemy i ograniczenia

Połączenia zamknięte podczas dołączania do źródeł OData/Sieci Web

Ze względu na architekturę protokołu OData i innych łączników sieci Web sprzężenia mogą być powolne. Powolne sprzężenie może czasami spowodować niepowodzenie połączenia ze źródłem, co powoduje błąd, taki jak "Istniejące połączenie zostało wymuszone przez hosta zdalnego". Chociaż istnieje możliwość użycia kolumn nawigacji podczas scalania tabel ze źródła OData, nie masz tej opcji podczas scalania ze źródłami innych niż OData. Jeśli podczas scalania źródła OData lub źródła sieci Web występują takie problemy i nie można użyć kolumny nawigacji, należy zastosować Table.Buffer do zapytania w edytorze zaawansowanym, zanim scalone zostaną dane.

Zalecamy buforowanie mniejszych scalonych zapytań w celu zoptymalizowania wydajności. Możesz również spróbować zmienić kolejność zapytań w sprzężeniu, aby zoptymalizować zapytanie.

Testowanie problemów z połączeniem

W przypadkach, gdy przekazujesz adres URL do łącznika OData, który nie jest tylko podstawowym adresem URL usługi (na przykład, jeśli masz filtr w adresie URL), przy konfigurowaniu odświeżania w usłudze należy wybrać opcję Pomiń połączenie testowe.

Po wprowadzeniu poświadczeń dla usługi OData w usłudze Power BI (na przykład po opublikowaniu pliku PBIX, który używa OData.Feed), usługa Power BI testuje poświadczenia, ale ignoruje wszystkie opcje zapytania określone w zapytaniu M. Te opcje zapytania mogły zostać określone bezpośrednio w formule (na przykład przy użyciu paska formuły lub edytora zaawansowanego) lub mogły zostać domyślnie dodane przez edytor Power Query. Pełną listę tych opcji zapytań można znaleźć w pliku OData.Feed.

Uwierzytelnianie w dowolnych serwisach

Niektóre usługi obsługują łączenie łącznika OData z uwierzytelnianiem OAuth/Microsoft Entra ID bez dodatkowej konfiguracji. Jednak ta możliwość nie działa w większości przypadków.

Jeśli podczas próby uwierzytelnienia wystąpi następujący błąd:

We were unable to connect because this credential type isn’t supported for this resource. Please choose another credential type.

Zrzut ekranu przedstawiający błąd podczas nawiązywania połączenia z punktem końcowym, który nie obsługuje protokołu OAuth z łącznikiem internetowym.

Skontaktuj się z właścicielem usługi. Muszą zmienić konfigurację uwierzytelniania lub utworzyć łącznik niestandardowy.

Maksymalna długość adresu URL

Jeśli używasz łącznika źródła danych OData do nawiązywania połączenia z listą programu SharePoint, listą usługi SharePoint Online lub usługą Project Online, maksymalna długość adresu URL dla tych połączeń wynosi około 2100 znaków. Przekroczenie limitu znaków powoduje błąd 401. Ta maksymalna długość adresu URL jest wbudowana w fronton programu SharePoint i nie można jej zmienić.

Aby obejść to ograniczenie, zacznij od głównego punktu końcowego OData, a następnie nawiguj i filtruj w dodatku Power Query. Dodatek Power Query filtruje ten adres URL lokalnie, gdy jest on zbyt długi, aby SharePoint nie mógł go obsłużyć. Na przykład zacznij od:

OData.Feed("https://contoso.sharepoint.com/teams/sales/_api/ProjectData")

Zamiast

OData.Feed("https://contoso.sharepoint.com/teams/sales/_api/ProjectData/Projects?select=_x0031_MetricName...etc...")