OData フィード

まとめ

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

Note

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

サポートされる機能

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

Note

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

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

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

  1. データの取得エクスペリエンスで [OData] または [OData Feed] を選択します。 Power Query Desktop でのデータの取得エクスペリエンスは、アプリによって異なります。 アプリの Power Query Desktop データの取得エクスペリエンスの詳細については、「データを取得する場所」を参照してください。

  2. [基本] ボタンを選び、テキスト ボックスに URL アドレスを入力します。 この URL は、接続する OData サービスのルートである必要があります。 たとえば、「http://services.odata.org/V4/northwind/northwind.svc/」を入力します。 [OK] をクリックします。

    OData URL selection.

    入力した URL アドレスが無効な場合は、URL テキスト ボックスの横に Warning icon. 警告アイコンが表示されます。

  3. OData フィードを使用して初めて接続する場合は、認証の種類を選び、(必要に応じて) 資格情報を入力して、認証設定を適用するレベルを選びます。 次に、 [接続](Connect) を選択します。

    OData credentials selection.

  4. [ナビゲーター] ダイアログからテーブルを選ぶと、Power Query エディターで [データの変換] を選んでデータを変換することや、[読み込み] を選んでデータを読み込むことができます。

    Web table selection.

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

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

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

  1. データの取得エクスペリエンスで [OData] または [OData Feed] オプションを選択します。 Power Query Online のデータの取得エクスペリエンスに到達する方法は、アプリによって異なります。 Power Query Online のデータの取得エクスペリエンスに到達する方法の詳細については、「データを取得する場所」を参照してください。

    Screenshot of the get data window with OData emphasized.

  2. 表示される [OData] ダイアログボックスで、テキストボックスに URL を入力します。

    Screenshot of the OData online sign in page.

  3. OData Feed を使って初めて接続する場合は、認証の種類を選び、(必要に応じて) 資格情報を入力します。 [次へ] を選択します。

  4. [ナビゲーター] ダイアログでテーブルを選ぶと、Power Query エディターで [データの変換] を選んでデータを変換することができます。

    Screenshot of the online navigator with the alphabetical list of products selected and displayed.

    選択済みの 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.

Error from connecting to an endpoint that doesn't support OAuth with the web connector.

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

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...")