Visualisieren von Daten von Azure Cosmos DB for NoSQL mithilfe von Power BI

Erfahren Sie, wie Sie Daten von Azure Cosmos DB mit Power BI Desktop verbinden und aussagekräftige Berichte für umsetzbare Geschäftserkenntnisse erstellen.

Verbindung

Stellen Sie eine Verbindung mit Azure Cosmos DB über Power BI Desktop her, indem Sie eine der folgenden Optionen verwenden:

• Verwenden Sie die Spiegelung in Microsoft Fabric, um Azure Cosmos DB-Daten in Fabric OneLake zu replizieren. Wenn Sie Änderungen an Ihrer Datenbank vornehmen, werden die Updates schnell an Fabric OneLake gesendet. Dieser Vorgang verlangsamt Ihre Hauptdatenbank nicht und verwendet keine zusätzliche Ressourcen. Power BI-Berichte greifen mithilfe des DirectLake-Modus direkt über OneLake auf Daten zu. Mit den erweiterten Copilot-Features in Power BI in Fabric können Sie mithilfe generativer KI wichtige geschäftliche Einblicke erlangen.

• Verwenden Sie Synapse Link, um Power BI-Berichte ohne Leistungs- oder Kostenauswirkungen auf Ihre Transaktionsworkloads und ohne ETL-Pipelines (Extract-Transform-Load) zu erstellen. Sie können entweder den Modus DirectQuery oder Import verwenden. Mit DirectQuery können Sie Dashboards oder Berichte mit Livedaten aus Ihren Azure Cosmos DB-Konten erstellen, ohne die Daten in Power BI importieren oder kopieren zu müssen.

• Verbinden von Power BI Desktop mit dem Azure Cosmos DB-Konto über den Azure Cosmos DB-Connector für Power BI. Diese Option ist nur im Importmodus verfügbar und verwendet Anforderungseinheiten (RUs), die für Ihre Transaktionsworkloads zugewiesen wurden.

Voraussetzungen

Bevor Sie die Anweisungen von diesem Power BI-Tutorial befolgen, stellen Sie sicher, dass Sie Zugriff auf diese Ressourcen haben:

• Herunterladen der neuesten Version von Power BI Desktop

• Erstellen Sie ein Azure Cosmos DB-Datenbankkonto, und fügen Sie Ihren Azure Cosmos DB-Containern Daten hinzu.

Um Ihre Berichte in PowerBI.com freizugeben, benötigen Sie ein Konto in PowerBI.com. Weitere Informationen zu Power BI und zu Power BI Pro finden Sie unter https://powerbi.microsoft.com/pricing.

Erstellen von BI-Berichten mithilfe der Spiegelung in Microsoft Fabric

Aktivieren Sie die Spiegelung für Ihre vorhandenen Azure Cosmos DB-Container, um BI-Berichte oder -Dashboards für diese Daten in nahezu Echtzeit zu erstellen. Anweisungen für die ersten Schritte mit Fabric und mit der Spiegelung finden Sie im Tutorial zur Spiegelung für Azure Cosmos DB.

Erstellen von BI-Berichten mit Azure Synapse Link

Sie können im Azure Cosmos DB-Portal mit wenigen Klicks Azure Synapse Link für Ihre vorhandenen Azure Cosmos DB-Container aktivieren und BI-Berichte für diese Daten erstellen. Power BI stellt eine Verbindung mit Azure Cosmos DB mithilfe des Direct Query-Modus her, sodass Sie Live-Daten von Azure Cosmos DB abfragen können, ohne dass sich dies auf Transaktionsworkloads auswirkt.

So erstellen Sie Berichte/Dashboards mit Power BI:

1. Melden Sie sich am Azure-Portal an, und navigieren Sie zu Ihrem Azure Cosmos DB-Konto.

2. Öffnen Sie im Abschnitt „Integrationen“ den Power BI-Bereich, und wählen Sie „Erste Schritte“ aus.

   Hinweis

   Derzeit ist diese Option nur für die API für NoSQL-Konten verfügbar. Sie können T-SQL-Sichten direkt in serverlosen Synapse-SQL-Pools erstellen und BI-Dashboards für Azure Cosmos DB for MongoDB erstellen. Weitere Informationen finden Sie unter Verwenden von Power BI und serverlosen Synapse SQL-Pools zum Analysieren von Azure Cosmos DB-Daten mit Synapse Link.

3. Sie können diese Funktion auf der Registerkarte „Azure Synapse Link aktivieren“ im Abschnitt „Azure Synapse Link für dieses Konto aktivieren“ aktivieren. Wenn Azure Synapse Link für Ihr Konto bereits aktiviert ist, wird diese Registerkarte nicht angezeigt. Dieser Schritt ist eine Voraussetzung für der Aktivierung von Azure Synapse Link auf Ihren Containern.

   Hinweis

   Die Aktivierung von Azure Synapse Link hat Auswirkungen auf die Kosten. Weitere Informationen finden Sie unter Preise für Azure Synapse Link.

4. Wählen Sie als Nächstes im Abschnitt „Azure Synapse Link für Ihre Container aktivieren“ die erforderlichen Container aus, um Azure Synapse Link zu aktivieren.

   • Wenn Sie den Azure Synapse-Link für einige Container bereits aktiviert haben, wird das Kontrollkästchen neben dem Containernamen aktiviert. Sie können die Auswahl optional aufheben, basierend auf den Daten, die Sie in Power BI visualisieren möchten.

   • Wenn Azure Synapse Link nicht aktiviert ist, können Sie dieses Feature für Ihre vorhandenen Container aktivieren. Während der Aktivierung von Azure Synapse Link für einen der Container werden die Daten aus dem jeweiligen Container nicht einbezogen. Sie müssen später zu dieser Registerkarte zurückkehren und Daten importieren, wenn die Container aktiviert sind.

   

5. Je nach Datenmenge in Ihren Containern kann die Aktivierung von Azure Synapse Link eine Weile dauern. Weitere Informationen finden Sie im Artikel Aktivieren von Azure Synapse Link für vorhandene Container.

   Sie können den Fortschritt im Portal überprüfen, wie im folgenden Screenshot gezeigt. Azure Synapse Link ist für die Container aktiviert, wenn der Fortschritt 100 % erreicht.

   

6. Wählen Sie auf der Registerkarte „Arbeitsbereich auswählen“ den Azure Synapse Analytics-Arbeitsbereich und dann „Weiter“ aus. Durch diesen Schritt werden in Synapse Analytics automatisch T-SQL-Ansichten für die zuvor ausgewählten Container erstellt. Weitere Informationen zu T-SQL-Sichten, die zum Verbinden Ihrer Azure Cosmos DB-Instanz mit Power BI erforderlich sind, finden Sie unter Vorbereiten von Sichten.

   Hinweis

   Die Eigenschaften Ihrer Azure Cosmos DB-Container werden als Spalten in T-SQL-Ansichten dargestellt, einschließlich tief geschachtelter JSON-Daten. Diese Darstellung dient als Schnellstart für Ihre BI-Dashboards. Diese Ansichten sind in Ihrem Synapse-Arbeitsbereich / Ihrer Datenbank verfügbar. Sie können diese genauen Ansichten auch in Synapse Workspace für die Datensuche, Data Science oder Data Engineering verwenden. Erweiterte Szenarien erfordern möglicherweise komplexere Ansichten oder die Feinabstimmung dieser Ansichten, um eine bessere Leistung zu erzielen. Weitere Informationen. Weitere Informationen finden Sie im Artikel Best Practices für Azure Synapse Link bei Verwendung von serverlosen SQL-Synapse-Pools.

7. Wählen Sie einen vorhandenen Arbeitsbereich aus, oder erstellen Sie einen neuen Arbeitsbereich. Wenn Sie einen vorhandenen Arbeitsbereich auswählen möchten, geben Sie die Details Abonnement, Arbeitsbereich und Datenbank an. Das Azure-Portal verwendet Ihre Microsoft Entra-Anmeldedaten, um sich automatisch mit Ihrem Synapse-Arbeitsbereich zu verbinden und T-SQL-Ansichten zu erstellen. Stellen Sie sicher, dass Sie über die Berechtigungen „Synapse-Administrator“ für diesen Arbeitsbereich verfügen.

   

8. Wählen Sie als Nächstes PBIDS herunterladen aus, um die Power BI-Datenquelldatei herunterzuladen. Öffnen Sie die heruntergeladene Datei. Sie enthält die erforderlichen Verbindungsinformationen und öffnet Power BI Desktop.

   

9. Sie können jetzt von Power BI Desktop aus eine Verbindung mit Azure Cosmos DB-Daten herstellen. Es wird eine Liste der T-SQL-Ansichten angezeigt, die den Daten in den einzelnen Containern entsprechen.

   Im folgenden Screenshot werden z. B. Fuhrparkdaten angezeigt. Sie können diese Daten zur weiteren Analyse laden oder vor dem Laden transformieren.

   

10. Sie können jetzt mit dem Erstellen des Berichts unter Verwendung der analytischen Daten von Azure Cosmos DB beginnen. Alle Änderungen an Ihren Daten werden im Bericht angezeigt, sobald die Daten in den Analysespeicher repliziert wurden, was in der Regel innerhalb von ein paar Minuten erfolgt.

Erstellen von BI-Berichten mit Power BI Connector

Das Herstellen einer Verbindung mit Azure Cosmos DB mit dem Power BI-Connector wird derzeit nur für Azure Cosmos DB for NoSQL- und API für Gremlin-Konten unterstützt.

1. Führen Sie Power BI Desktop aus.

2. Direkt über die Willkommensseite können Sie Daten abrufen, aktuelle Quellen anzeigen oder andere Berichte öffnen. Schließen Sie den Bildschirm, indem Sie die Option „X“ auswählen. Die Ansicht „Bericht“ von Power BI Desktop wird angezeigt.

   

3. Wählen Sie das Menüband „Start“ aus, und klicken Sie dann auf „Daten abrufen“. Das Fenster „Daten abrufen“ wird angezeigt.

4. Klicken Sie auf „Azure“, wählen Sie „Azure Cosmos DB (Beta)“ aus, und klicken Sie dann auf „Verbinden“.

   

5. Klicken Sie auf der Seite „Connector (Vorschau)“ auf „Fortfahren“. Das Fenster „Azure Cosmos DB“ wird angezeigt.

6. Geben Sie die Endpunkt-URL des Azure Cosmos DB-Kontos an, aus dem Sie die Daten abrufen möchten, und wählen Sie dann „OK“ aus. Um Ihr eigenes Konto zu verwenden, können Sie die URL aus dem Feld „URI“ auf dem Abschnitt „Schlüssel“ des Azure-Portals abrufen. Optional können Sie den Datenbanknamen oder den Namen der Sammlung angeben oder den Navigator verwenden, um die Datenbank und die Sammlung auszuwählen, um festzustellen, woher die Daten stammen.

7. Wenn Sie zum ersten Mal eine Verbindung mit diesem Endpunkt herstellen, werden Sie aufgefordert, die Anmeldeinformationen anzugeben.

8. Wenn das Konto erfolgreich verbunden wurde, wird der Bereich „Navigator“ angezeigt. Der Navigator zeigt eine Liste der Datenbanken für das Konto an.

9. Klicken Sie auf die Datenbank, aus der die Daten für den Bericht stammen, und erweitern Sie diese. Wählen Sie jetzt eine Sammlung mit den abzurufenden Daten aus.

   Im Vorschaubereich wird eine Liste der Datensatz-Elemente angezeigt. Ein Dokument wird mit dem Typ „Datensatz“ in Power BI dargestellt. Auch ein geschachtelter JSON-Block innerhalb eines Dokuments ist ein Datensatz. Um die Eigenschaftendokumente als Spalten anzuzeigen, wählen Sie die graue Schaltfläche mit zwei Pfeilen in entgegengesetzte Richtungen aus, die die Erweiterung des Datensatzes symbolisieren.

10. In der Berichtsansicht von Power BI Desktop können Sie Berichte erstellen, um Daten zu visualisieren. Sie können Berichte erstellen, indem Sie Felder in den Zeichenbereich „Bericht“ ziehen.

11. Es gibt zwei Möglichkeiten zum Aktualisieren von Daten: ungeplant und geplant. Wählen Sie Jetzt aktualisieren aus, um die Daten zu aktualisieren. Weitere Informationen zur Option für geplante Aktualisierung finden Sie in der Power BI-Dokumentation.

Bekannte Probleme und Einschränkungen

• Bei partitionierten Azure Cosmos DB-Containern wird eine SQL-Abfrage mit einer Aggregatfunktion an Azure Cosmos DB übergeben, wenn die Abfrage einen Filter (WHERE-Klausel) für den Partitionsschlüssel enthält. Wenn die Aggregatabfrage keinen Filter für den Partitionsschlüssel enthält, führt der Connector die Aggregation aus.

• Der Connector übergibt keine Aggregatfunktion, wenn er auf TOP oder LIMIT folgt.

• Azure Cosmos DB verarbeitet den TOP-Vorgang am Ende beim Verarbeiten einer Abfrage. In der folgenden Abfrage wird TOP beispielsweise in der Unterabfrage angewendet, während die Aggregatfunktion über diesem Resultset angewendet wird:

  SELECT COUNT(1) FROM (SELECT TOP 4 - FROM EMP) E
  

• Wenn DISTINCT in einer Aggregatfunktion enthalten ist, übergibt der Connector die Aggregatfunktion nicht an Azure Cosmos DB. DISTINCT wird in einer Aggregatfunktion bei Azure Cosmos DB for NoSQL nicht unterstützt.

• Für die Aggregatfunktion SUM gibt Azure Cosmos DB „Nicht definiert“ zurück, wenn eines der Argumente in SUM eine Zeichenfolge, ein boolescher Wert oder NULL ist. Wenn Nullwerte vorhanden sind, übergibt der Connector die Abfrage an Azure Cosmos DB, um Nullwerte während der Berechnung von SUM durch Null zu ersetzen.

• Für die Aggregatfunktion AVG gibt Azure Cosmos DB als Resultset „Nicht definiert“ zurück, wenn eines der Argumente in SUM eine Zeichenfolge, ein boolescher Wert oder Null ist. Der Connector macht eine Verbindungseigenschaft verfügbar, um die Übergabe der AVG-Aggregatfunktion an Azure Cosmos DB zu deaktivieren, falls dieses Standardverhalten von Azure Cosmos DB überschrieben werden muss. Wenn der AVG-Passdown deaktiviert ist, wird er nicht an Azure Cosmos DB übergeben, und der Connector übernimmt den AVG-Aggregationsvorgang selbst. Weitere Informationen finden Sie unter „Passdown-Funktion AVERAGE aktivieren“ im Abschnitt Erweiterte Optionen.

• Azure Cosmos DB-Container mit großem Partitionsschlüssel werden nicht im Connector unterstützt.

• Der Aggregations-Passdown ist aufgrund von Serverbeschränkungen für die folgende Syntax deaktiviert:

  • Wenn die Abfrage nicht nach einem Partitionsschlüssel filtert oder wenn der Partitionsschlüsselfilter den OR-Operator mit einem anderen Prädikat auf der obersten Ebene in der WHERE-Klausel verwendet.

  • Die Abfrage enthält mindestens einen Partitionsschlüssel, der in einer IS NOT NULL-Klausel in der WHERE-Klausel angezeigt wird.

• Der V2-Connector unterstützt keine komplexen Datentypen wie Arrays, Objekte und hierarchische Strukturen. Verwenden Sie das Fabric Mirroring für Azure Cosmos DB-Feature für diese Szenarien.

• Der V2-Connector verwendet das Sampling der ersten 1.000 Dokumente, um das abgeleitete Schema zu erstellen. Dieser Ansatz wird nicht für die Entwicklung von Schemata empfohlen, in denen nur einige Dokumente aktualisiert werden. Ein Beispiel: Eine neu hinzugefügte Eigenschaft zu einem Dokument in einem Container mit Tausenden von Dokumenten ist möglicherweise nicht im abgeleiteten Schema enthalten. Wir empfehlen die Funktion Fabric Mirroring für Azure Cosmos DB für diese Anwendungsfälle.

• Der V2-Connector unterstützt keine Zeichenfolgenwerte in Objekteigenschaften.

• Der Filter-Passdown ist aufgrund von Serverbeschränkungen für die folgende Syntax deaktiviert:

  • Wenn auf die Abfrage mit einer oder mehreren Aggregatspalten in der WHERE-Klausel verwiesen wird

Verwandte Inhalte

• Weitere Informationen zu Power BI finden Sie unter Erste Schritte mit Power BI.
• Weitere Informationen zu Azure Cosmos DB finden Sie auf der Startseite der Azure Cosmos DB-Dokumentation.