メイン コンテンツにスキップする

データ モデリング OData サービス

Cognite Data Fusion (CDF) データ モデルをデータ ソースとして接続し、OData クライアントを使用して CDF データ モデルに保存されているデータをクエリ、変換、および可視化します。

データ モデリング OData サービスは、OData プロトコルを使用して CDF で作成されたデータ モデルにアクセスすることを可能にします。

データ モデリング OData サービスは、以下のスキーマを持つ URL を受け入れます。

https://{cluster}.cognitedata.com/odata/{apiVersion}/projects/{project}/models/spaces/{spaceExternalId}/datamodels/{dataModelExternalId}/versions/{dataModelVersion}

ここで

  • {cluster}: CDF クラスターの名前、例: westeurope-1。
  • {apiVersion}: OData サービス API のバージョン（最新は 20230821）。
  • {project}: CDF プロジェクトの名前、例: publicdata。
  • {spaceExternalId}: データ モデルが公開されている space の外部 ID。
  • {dataModelExternalId}: データ モデルの外部 ID。
  • {dataModelVersion}: データ モデルのバージョン。

OData クライアントを正しいデータ モデル OData URL にポイントし、認証すると、サーバーは関連するデータ モデル上のすべての views を含むテーブルを返します。

文字使用ガイドライン​

Power BI の space および externalId フィールドでは、これらの文字使用ガイドラインに従ってください。

  • 安全に使用できるもの:

    • 英数字: a-z A-Z 0-9
    • 予約されていない特殊文字: - _ . ~

  • 慎重に使用するもの:

    • 以下の予約文字は使用できるかもしれませんが、常に使用できる保証はありません: ! * ' ( ) ; : @ & = + $ ,

  • 使用を避けるもの:

    • 上記に記載されていない特殊文字は、Power BI が正しくデータを読み込んだりナビゲートしたりするのを妨げる可能性があります。

データ モデルでアイテムをフィルタリングする​

レポートやダッシュボード作成のために使用可能なデータ セットを作成するためにフィルターを使用します。データ モデリング OData サービスはサーバー側のフィルタリングをサポートしており、すべてのデータをクライアントにダウンロードすることなく、フィルターをサーバーにプッシュダウンすることができます。

タイププッシュダウン
モデル プロパティはい、EndsWith と Contains を除きます
時系列メタデータいいえ
データと文字列のポイントtimestamp のみ
ファイル メタデータいいえ

Power Query はメモリ内で EndsWith と Contains の文字列フィルタリング操作を実行します。

JSONObjects は Power BI のテキスト値として表示されます。

時系列とデータ ポイントの操作​

データ モデリング OData サービスは、データ モデルから Timeseries を取得する操作をサポートしています。

特定の時系列のデータ ポイントを取得するために、string または dataPoints に移動できます。時間範囲からデータ ポイントを取得するには、タイムスタンプ値でデータ ポイントをフィルタリングします。

CDF は、値に基づいた時系列のフィルタリングをサポートしていません。

時系列は非常に粒度の高いデータを含むことができます。パフォーマンスを向上させ、データ負荷を軽減するために、dataPoint Aggregate 関数を使用します。

既知の制限と問題​

以下のセクションでは、CDF データ モデルを Power BI のデータ ソースとして使用する際の既知の制限と問題について説明します。

他のタイプとの関係を持つタイプ​

CDF データモデルと Power BI の統合では、OData の "expand" コンセプト] を使用したノード間の直接関係のトラバースに対するサポートが限られています。

Power BI は、展開する各インスタンス/行ごとに個別の API リクエストを発行して、expand 関係を使用してテーブルを平坦化する操作を処理します。大量のデータがあると、これには非常に時間がかかります。

グラフ エッジと添付プロパティ​

現在、エッジ上のプロパティの取得はサポートされていません。

データ更新​

Power BI のデータの最小更新レートは 15 分です。OData サービスは、ダッシュボードの更新のためにデータを少量ずつロードすることを許可しません。ダッシュボードに頻繁な更新が必要な大量のデータが含まれている場合、データ モデリング OData サービスを使用するよりも優れたオプションがあるかもしれません。

最後の更新: