OData-Service für die Datenmodellierung
Verbinden Sie ein Cognite Data Fusion (CDF)-Datenmodell als Datenquelle und verwenden Sie OData-Clients zur Abfrage, Transformation und Visualisierung von in CDF-Datenmodellen gespeicherten Daten.
Der OData-Service für die Datenmodellierung gibt Ihnen Zugriff auf Datenmodelle, die in CDF mithilfe von OData-Protokollen erstellt wurden.
Der OData-Service für die Datenmodellierung akzeptiert URLs mit dem folgenden Schema:
https://{cluster}.cognitedata.com/odata/{apiVersion}/projects/{project}/models/spaces/{spaceExternalId}/datamodels/{dataModelExternalId}/versions/{dataModelVersion}
Mit:
{cluster}
: Name desCDF-Clusters, zum Beispielwesteurope-1
.{apiVersion}
: Version derOData-Service-API (die neueste Version ist20230821
).{project}
: Name desCDF-Projekts, zum Beispielpublicdata
.{spaceExternalId}
: Externe ID desspace, in dem das Datenmodell veröffentlicht ist.{dataModelExternalId}
: Externe ID des Datenmodells.{dataModelVersion}
: Version des Datenmodells.
Wenn Sie den OData-Client zur richtigen OData-URL des Datenmodells führen und authentifizieren, gibt der Server eine Tabelle mit allen views zurück, die im zugehörigen Datenmodell existieren.
Leitfaden für die Zeichennutzung
Befolgen Sie diese Anweisungen für die Zeichennutzung in den Feldern space
und externalId
in Power BI:
-
Die folgenden Zeichen können problemlos genutzt werden:
- Alphanumerische Zeichen:
a-z
A-Z
0-9
- Nicht anderweitig reservierte Sonderzeichen:
-
_
.
~
- Alphanumerische Zeichen:
-
Die folgenden Zeichen können mit Vorsicht genutzt werden:
- Die folgenden reservierten Zeichen können funktionieren, jedoch ist eine konsistente Funktion nicht garantiert:
!
*
'
(
)
;
:
@
&
=
+
$
,
- Die folgenden reservierten Zeichen können funktionieren, jedoch ist eine konsistente Funktion nicht garantiert:
-
Die folgenden Zeichen sind zu vermeiden:
- Andere Sonderzeichen als die oben aufgeführten können
Power BIdaran hindern, Daten korrekt zu laden oder in den Daten zu navigieren.
- Andere Sonderzeichen als die oben aufgeführten können
Elemente in Datenmodellen filtern
Verwenden Sie Filter, um brauchbare Datensätze für Berichte oder Dashboards zu erstellen. Der OData-Service für die Datenmodellierung unterstützt serverseitiges Filtern. Sie können also Filter zum Server weiterleiten, um zu vermeiden, dass sämtliche Daten in den Client heruntergeladen werden.
Typ | Weiterleitung |
---|---|
Modelleigenschaft | Ja, außer EndsWith und Contains |
Zeitreihen-Metadaten | Nein |
Daten- und Zeichenfolgenpunkte | Nur timestamp |
Dateien-Metadaten | Nein |
Mit Power Query werden EndsWith
- und Contains
-Zeichenfolgenfilterungen im Arbeitsspeicher durchgeführt.
JSONObjects
werden als Textwerte in Power BI dargestellt.
Arbeiten mit Zeitreihen und Datenpunkten
Der OData-Service für die Datenmodellierung unterstützt den Abruf von Timeseries
aus Datenmodellen.
Um Datenpunkte für bestimmte Zeitreihen zu erhalten, können Sie zu string
oder dataPoints
navigieren. Um Datenpunkte aus einem Zeitbereich zu erhalten, filtern Sie den Datenpunkt nach einem Zeitstempelwert.
Die Filterung von Zeitreihen basierend auf ihren Werten wird von CDF nicht unterstützt.
Zeitreihen können sehr detaillierte Daten enthalten. Verwenden Sie die Aggregate
-Funktion für Datenpunkte, um die Leistung zu verbessern und die Datenlast zu reduzieren.
Bekannte Einschränkungen und Probleme
Die unten stehenden Abschnitte beschreiben bekannte Einschränkungen und Probleme im Zusammenhang mit der Verwendung von CDF-Datenmodellen als Datenquelle für Power BI.
Typen mit Beziehungen zu anderen Typen
Die Integration von CDF-Datenmodellen in Power BI bietet nur begrenzte Unterstützung beim Durchlauf direkter Beziehungen zwischen Knoten mithilfe des OData-Erweiterungskonzepts.
Power BI verarbeitet einen Vorgang zum Glätten einer Tabelle mithilfe einer Erweiterungsbeziehung. Dabei wird für jede zu erweiternde Instanz/Zeile eine separate API-Anfrage gesendet. Der Zeitaufwand ist dabei für größere Datenvolumen sehr hoch.
Diagrammränder und zugehörige Eigenschaften
Der Abruf von Eigenschaften an Rändern wird derzeit nicht unterstützt.
Datenaktualisierung
Die Mindestaktualisierungsrate für Daten in Power BI beträgt 15 Minuten. Mit dem OData-Service können Daten für die Aktualisierung von Dashboards nicht kleinschrittig geladen werden. Wenn ein Dashboard große Datenmengen umfasst, die häufig aktualisiert werden müssen, gibt es unter Umständen besser geeignete Möglichkeiten als den OData-Service für die Datenmodellierung.