OData フィード

[アーティクル]
02/16/2024

まとめ

項目	説明
リリース状態	一般提供
製品	Excel Power BI (セマンティックモデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) Dynamics 365 Customer Insights Analysis Services
サポートされている認証の種類	匿名 Windows (ゲートウェイが必要) 基本 (ゲートウェイが必要) Web API 組織アカウント
関数リファレンスドキュメント	OData.Feed、ODataOmitValues.Nulls

Note

デプロイスケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。

サポートされる機能

基本
詳細
- URL パーツ
- オープン型の列
関連テーブルを選ぶ

Note

Microsoft Graph はサポートされていません。詳細情報: Power Query で Microsoft Graph がサポートされていない

Power Query Desktop で OData フィードからデータを読み込む

Power Query Desktop で OData フィードからデータを読み込むには:

データの取得エクスペリエンスで [OData] または [OData Feed] を選択します。 Power Query Desktop でのデータの取得エクスペリエンスは、アプリによって異なります。アプリの Power Query Desktop データの取得エクスペリエンスの詳細については、「データを取得する場所」を参照してください。
[基本] ボタンを選び、テキストボックスに URL アドレスを入力します。この URL は、接続する OData サービスのルートである必要があります。たとえば、「http://services.odata.org/V4/northwind/northwind.svc/」を入力します。 [OK] をクリックします。

入力した URL アドレスが無効な場合は、URL テキストボックスの横に警告アイコンが表示されます。
OData フィードを使用して初めて接続する場合は、認証の種類を選び、(必要に応じて) 資格情報を入力して、認証設定を適用するレベルを選びます。次に、 [接続](Connect) を選択します。
[ナビゲーター] ダイアログからテーブルを選ぶと、Power Query エディターで [データの変換] を選んでデータを変換することや、[読み込み] を選んでデータを読み込むことができます。

選択済みの 1 つ以上のテーブルと直接リレーションシップのあるテーブルが複数ある場合、[関連テーブルの選択] ボタンを選択できます。この操作で、選択済みの 1 つ以上のテーブルと直接リレーションシップのあるすべてのテーブルもインポートされます。

Power Query Online で OData フィードからデータを読み込む

Power Query Online で OData フィードからデータを読み込むには:

データの取得エクスペリエンスで [OData] または [OData Feed] オプションを選択します。 Power Query Online のデータの取得エクスペリエンスに到達する方法は、アプリによって異なります。 Power Query Online のデータの取得エクスペリエンスに到達する方法の詳細については、「データを取得する場所」を参照してください。
表示される [OData] ダイアログボックスで、テキストボックスに URL を入力します。
OData Feed を使って初めて接続する場合は、認証の種類を選び、(必要に応じて) 資格情報を入力します。 [次へ] を選択します。
[ナビゲーター] ダイアログでテーブルを選ぶと、Power Query エディターで [データの変換] を選んでデータを変換することができます。

選択済みの 1 つ以上のテーブルと直接リレーションシップのあるテーブルが複数ある場合、[関連テーブルの選択] ボタンを選択できます。この操作で、選択済みの 1 つ以上のテーブルと直接リレーションシップのあるすべてのテーブルもインポートされます。

Microsoft Graph への接続

Power Query から Microsoft Graph REST API への接続は推奨されておらず、サポートされていません。詳細情報: Power Query で Microsoft Graph がサポートされていない

既知の問題と制限事項

結合

OData やその他の Web コネクタのアーキテクチャによっては、結合でパフォーマンスが低下する可能性があります。 OData ソースのテーブル間を結合するときには、ナビゲーション列を使うオプションがありますが、非 OData ソースとの結合時にはこのオプションがありません。

OData ソースをマージする際に、パフォーマンスの問題が発生した場合、データをマージする前に、Table.Buffer を詳細エディターの OData クエリに適用する必要があります。

接続の問題をテストする

サービスルートではない OData コネクターに URL を渡している場合、たとえば URL にフィルターを適用している場合は、サービスで更新を設定するときに [テスト接続をスキップする] を選ぶ必要があります。

OData サービスの資格情報を Power BI サービスに入力すると (たとえば、OData.Feed を使用する PBIX を発行した後)、Power BI サービスは資格情報をテストしますが、M クエリで指定されたクエリオプションは無視されます。これらのクエリオプションは、数式で直接指定されている (数式バーや詳細エディターを使用するなど) か、Power Query エディターによってデフォルトで追加されている場合があります。これらのクエリオプションの完全な一覧は、OData.Feed にあります。

任意のサービスへの認証

一部のサービスは、OData コネクタが、OAuth/Microsoft Entra ID 認証ですぐに認証を行う機能をサポートしています。ただし、ほとんどの場合に機能しません。

認証をしようとした際に、次のエラーが発生した場合:

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

サービス所有者までお問い合わせください。認証構成を変更するか、カスタムコネクタを構築する必要があります。

URL の最大長

OData フィードコネクタを使って SharePoint リスト、SharePoint Online リスト、または Project Online に接続する場合、これらの接続の最大 URL 長は約 2100 文字です。文字数制限を超えると、401 エラーが発生します。この最大 URL 長は SharePoint フロントエンドに組み込まれており、変更することはできません。

この制限を回避するには、ルート OData エンドポイントから開始し、Power Query 内でナビゲートしてフィルター処理します。 URL が長すぎて SharePoint で処理できない場合、この URL は Power Query によってローカルでフィルター処理されます。たとえば、次のように開始します。

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

( ではなく )

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

次の方法で共有