Wizualizowanie danych usługi Azure Cosmos DB for NoSQL przy użyciu usługi Power BI

Dowiedz się, jak połączyć dane usługi Azure Cosmos DB z programem Power BI Desktop i tworzyć szczegółowe raporty na potrzeby praktycznych analiz biznesowych.

Connecting

Połącz się z usługą Azure Cosmos DB z poziomu programu Power BI Desktop przy użyciu jednej z następujących opcji:

• Użyj Mirroring w usłudze Microsoft Fabric, aby replikować dane usługi Azure Cosmos DB do usługi Fabric OneLake. Po wprowadzeniu zmian w bazie danych aktualizacje są szybko wysyłane do usługi Fabric OneLake. Ten proces nie spowalnia głównej bazy danych ani nie korzysta z dodatkowych zasobów. Raporty usługi Power BI uzyskują dostęp do danych bezpośrednio z usługi OneLake przy użyciu trybu DirectLake. Dzięki ulepszonym funkcjom copilot w usłudze Power BI w usłudze Fabric możesz wykorzystać generowanie sztucznej inteligencji, aby uzyskać kluczowe informacje biznesowe.

• Użyj usługi Azure Synapse Link , aby tworzyć raporty usługi Power BI bez wpływu na wydajność ani koszt na obciążenia transakcyjne i bez potoków wyodrębniania i przekształcania (ETL). Możesz użyć trybu DirectQuery lub trybu importu . Tryb DirectQuery umożliwia tworzenie pulpitów nawigacyjnych/raportów przy użyciu danych na żywo z kont usługi Azure Cosmos DB bez importowania lub kopiowania danych do usługi Power BI.

• Połącz program Power BI Desktop z kontem usługi Azure Cosmos DB przy użyciu łącznika usługi Azure Cosmos DB dla usługi Power BI. Ta opcja jest dostępna tylko w trybie importu i używa jednostek żądań przydzielonych dla obciążeń transakcyjnych.

Wymagania wstępne

Przed wykonaniem instrukcji opisanych w tym samouczku usługi Power BI upewnij się, że masz dostęp do tych zasobów:

• Pobieranie najnowszej wersji programu Power BI Desktop

• Utwórz konto bazy danych usługi Azure Cosmos DB i dodaj dane do kontenerów usługi Azure Cosmos DB.

Aby udostępnić raporty w PowerBI.com, musisz mieć konto w PowerBI.com. Aby dowiedzieć się więcej na temat usług Power BI i Power BI Pro, zobacz https://powerbi.microsoft.com/pricing.

Tworzenie raportów analizy biznesowej przy użyciu dublowania w usłudze Microsoft Fabric

Włącz dublowanie istniejących kontenerów usługi Azure Cosmos DB, aby tworzyć raporty analizy biznesowej lub pulpity nawigacyjne na tych danych niemal w czasie rzeczywistym. Aby uzyskać instrukcje dotyczące rozpoczynania pracy z siecią szkieletową i dublowaniem, zobacz samouczek dublowania dla usługi Azure Cosmos DB.

Tworzenie raportów analizy biznesowej przy użyciu usługi Azure Synapse Link

Możesz włączyć usługę Azure Synapse Link w istniejących kontenerach usługi Azure Cosmos DB i tworzyć raporty analizy biznesowej na tych danych, w zaledwie kilku wybranych opcjach przy użyciu portalu usługi Azure Cosmos DB. Usługa Power BI łączy się z usługą Azure Cosmos DB przy użyciu trybu zapytania bezpośredniego, umożliwiając wykonywanie zapytań dotyczących danych na żywo w usłudze Azure Cosmos DB bez wpływu na obciążenia transakcyjne.

Aby utworzyć raport/pulpit nawigacyjny usługi Power BI:

1. Zaloguj się do witryny Azure Portal i przejdź do swojego konta usługi Azure Cosmos DB.

2. W sekcji Integracje otwórz okienko usługi Power BI i wybierz pozycję Rozpocznij.

   Uwaga / Notatka

   Ta opcja jest obecnie dostępna tylko dla kont interfejsu API dla kont NoSQL. Widoki języka T-SQL można tworzyć bezpośrednio w bezserwerowych pulach SQL usługi Synapse i tworzyć pulpity nawigacyjne analizy biznesowej dla usługi Azure Cosmos DB dla bazy danych MongoDB. Aby uzyskać więcej informacji, zobacz Używanie usługi Power BI i bezserwerowej puli SQL usługi Synapse do analizowania danych usługi Azure Cosmos DB za pomocą usługi Synapse.

3. Na karcie Włącz usługę Azure Synapse Link możesz włączyć usługę Azure Synapse Link na swoim koncie w sekcji Włączanie usługi Azure Synapse Link dla tego konta. Jeśli usługa Azure Synapse Link jest już włączona dla Twojego konta, nie możesz wyświetlić tej karty. Ten krok jest wymaganiem wstępnym, aby rozpocząć włączanie usługi Azure Synapse Link w kontenerach.

   Uwaga / Notatka

   Włączenie usługi Azure Synapse Link ma wpływ na koszty. Aby uzyskać więcej informacji, zobacz Cennik usługi Azure Synapse Link.

4. Następnie w sekcji Włączanie usługi Azure Synapse Link dla kontenerów wybierz wymagane kontenery, aby włączyć usługę Azure Synapse Link.

   • Jeśli usługa Azure Synapse Link została już włączona w niektórych kontenerach, obok nazwy kontenera jest zaznaczone pole wyboru. Opcjonalnie możesz usunąć ich zaznaczenie na podstawie danych, które chcesz wizualizować w usłudze Power BI.

   • Jeśli usługa Azure Synapse Link nie jest włączona, możesz włączyć tę funkcję w istniejących kontenerach. Jeśli włączenie usługi Azure Synapse Link jest w toku w żadnym z kontenerów, dane z tych kontenerów nie są uwzględniane. Wróć do tej karty później i zaimportuj dane po włączeniu kontenerów.

   

5. W zależności od ilości danych w kontenerach może upłynąć trochę czasu, aby włączyć usługę Azure Synapse Link. Aby dowiedzieć się więcej, zobacz artykuł włączanie usługi Azure Synapse Link w istniejących kontenerach .

   Postęp można sprawdzić w portalu, jak pokazano na poniższym ekranie. Kontenery są włączone za pomocą usługi Azure Synapse Link, gdy postęp osiągnie 100%.

   

6. Na karcie Wybierz obszar roboczy wybierz obszar roboczy usługi Azure Synapse Analytics, a następnie wybierz pozycję Dalej. Ten krok automatycznie tworzy widoki języka T-SQL w usłudze Synapse Analytics dla wybranych wcześniej kontenerów. Aby uzyskać więcej informacji na temat widoków języka T-SQL wymaganych do połączenia usługi Azure Cosmos DB z usługą Power BI, zobacz artykuł Przygotowywanie widoków .

   Uwaga / Notatka

   Twoje trzeźwości kontenera usługi Azure Cosmos DB są reprezentowane jako kolumny w widokach języka T-SQL, w tym głębokie zagnieżdżone dane JSON. Ta reprezentacja to szybki start dla pulpitów nawigacyjnych analizy biznesowej. Te widoki są dostępne w obszarze roboczym/bazie danych usługi Synapse; Możesz również użyć tych samych widoków w obszarze roboczym usługi Synapse na potrzeby eksploracji danych, nauki o danych lub inżynierii danych. Zaawansowane scenariusze mogą wymagać bardziej złożonych widoków lub precyzyjnego dostrajania tych widoków, aby uzyskać lepszą wydajność. Więcej informacji. Zobacz artykuł Najlepsze rozwiązania dotyczące usługi Azure Synapse Link podczas korzystania z bezserwerowych pul SQL usługi Synapse .

7. Wybierz istniejący obszar roboczy lub utwórz nowy. Aby wybrać istniejący obszar roboczy, podaj szczegóły subskrypcji, obszaru roboczego i bazy danych. Witryna Azure Portal używa poświadczeń firmy Microsoft Entra do automatycznego łączenia się z obszarem roboczym usługi Synapse i tworzenia widoków języka T-SQL. Upewnij się, że masz uprawnienia administratora usługi Synapse do tego obszaru roboczego.

   

8. Następnie wybierz pozycję Pobierz plik pbids, aby pobrać plik źródła danych usługi Power BI. Otwórz pobrany plik. Zawiera wymagane informacje o połączeniu i otwiera program Power BI Desktop.

   

9. Teraz możesz nawiązać połączenie z danymi usługi Azure Cosmos DB z poziomu programu Power BI Desktop. Zostanie wyświetlona lista widoków języka T-SQL odpowiadających danym w każdym kontenerze.

   Na przykład na poniższym ekranie przedstawiono dane floty pojazdów. Te dane można załadować do dalszej analizy lub przekształcić przed załadowaniem.

   

10. Teraz możesz rozpocząć tworzenie raportu przy użyciu danych analitycznych usługi Azure Cosmos DB. Wszelkie zmiany danych nie są odzwierciedlane w raporcie, gdy tylko dane są replikowane do magazynu analitycznego, co zwykle występuje w ciągu kilku minut.

Tworzenie raportów analizy biznesowej przy użyciu łącznika usługi Power BI

Nawiązywanie połączenia z usługą Azure Cosmos DB za pomocą łącznika usługi Power BI jest obecnie obsługiwane tylko dla usługi Azure Cosmos DB dla noSQL i interfejsu API dla kont języka Gremlin.

1. Uruchom program Power BI Desktop.

2. Możesz pobrać dane, wyświetlić ostatnie źródła lub otworzyć inne raporty bezpośrednio na ekranie powitalnym. Zamknij ekran, wybierając opcję "X". Zostanie wyświetlony widok Raport programu Power BI Desktop.

   

3. Wybierz wstążkę Narzędzia główne, a następnie wybierz pozycję Pobierz dane. Powinno zostać wyświetlone okno Pobieranie danych.

4. Wybierz pozycję Na platformie Azure, wybierz pozycję Azure Cosmos DB (beta), a następnie wybierz pozycję Połącz.

   

5. Na stronie Łącznik wersji zapoznawczej wybierz pozycję Kontynuuj. Zostanie wyświetlone okno usługi Azure Cosmos DB.

6. Określ adres URL punktu końcowego konta usługi Azure Cosmos DB, z którego chcesz pobrać dane, a następnie wybierz przycisk OK. Aby użyć własnego konta, możesz pobrać adres URL z pola identyfikatora URI w sekcji Klucze w witrynie Azure Portal. Opcjonalnie możesz podać nazwę bazy danych, nazwę kolekcji lub użyć nawigatora, aby wybrać bazę danych i kolekcję, aby określić, skąd pochodzą dane.

7. Jeśli łączysz się z tym punktem końcowym po raz pierwszy, zostanie wyświetlony monit o podanie poświadczeń konta.

8. Po pomyślnym połączeniu konta zostanie wyświetlone okienko Nawigator. Nawigator przedstawia listę baz danych w ramach konta.

9. Wybierz i rozwiń bazę danych, z której pochodzą dane raportu. Teraz wybierz kolekcję zawierającą dane do pobrania.

   W okienku Podgląd zostanie wyświetlona lista elementów rekordu. Dokument jest reprezentowany jako typ rekordu w usłudze Power BI. Podobnie zagnieżdżony blok JSON wewnątrz dokumentu jest również rekordem. Aby wyświetlić dokumenty właściwości jako kolumny, wybierz szary przycisk z dwoma strzałkami w przeciwnych kierunkach, które symbolizują rozszerzenie rekordu.

10. Widok raportów programu Power BI Desktop umożliwia rozpoczęcie tworzenia raportów w celu wizualizacji danych. Twórz raporty, przeciągając i upuszczając pola na kanwę raportu.

11. Istnieją dwa sposoby odświeżania danych: nieplanowane i zaplanowane. Wybierz pozycję Odśwież teraz , aby odświeżyć dane. Zapoznaj się z dokumentacją usługi Power BI, aby uzyskać więcej informacji na temat opcji zaplanowanego odświeżania.

Znane problemy i ograniczenia

• W przypadku partycjonowanych kontenerów usługi Azure Cosmos DB zapytanie SQL z funkcją agregowaną jest przekazywane do usługi Azure Cosmos DB, jeśli zapytanie zawiera filtr (WHERE klauzulę) klucza partycji. Jeśli zapytanie agregacji nie zawiera filtru klucza partycji, łącznik wykonuje agregację.

• Łącznik nie przekazuje funkcji agregującej, gdy następuje lub TOPLIMIT.

• Usługa Azure Cosmos DB przetwarza operację TOP na końcu podczas przetwarzania zapytania. Na przykład w poniższym zapytaniu funkcja TOP jest stosowana w podzapytaniu, podczas gdy funkcja agregacji jest stosowana na podstawie tego zestawu wyników:

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

• Jeśli DISTINCT jest uwzględniona w funkcji agregującej, łącznik nie przekazuje funkcji agregującej do usługi Azure Cosmos DB. DISTINCT w funkcji agregującej nie jest obsługiwana usługa Azure Cosmos DB for NoSQL.

• SUM W przypadku funkcji agregującej usługa Azure Cosmos DB zwraca wartość niezdefiniowaną, jeśli jakiekolwiek argumenty w usłudze SUM są ciągami, wartościami logicznymi lub null. Jeśli istnieją wartości null, łącznik przekazuje zapytanie do usługi Azure Cosmos DB w celu zastąpienia wartości null wartością zero podczas obliczania SUM.

• AVG W przypadku funkcji agregującej usługa Azure Cosmos DB zwraca niezdefiniowane jako zestaw wyników, jeśli którykolwiek z argumentów w usłudze SUM to ciąg, wartość logiczna lub wartość null. Łącznik uwidacznia właściwość połączenia, aby wyłączyć przekazywanie funkcji agregującej AVG do usługi Azure Cosmos DB w przypadku, gdy to domyślne zachowanie usługi Azure Cosmos DB musi zostać zastąpione. Gdy AVG przekazywanie jest wyłączone, nie jest przekazywane do usługi Azure Cosmos DB, a łącznik obsługuje wykonywanie samej operacji agregacji AVG. Aby uzyskać więcej informacji, przejdź do pozycji "Włącz AVERAGE przekazywanie funkcji" w obszarze Opcje zaawansowane.

• Kontenery usługi Azure Cosmos DB z dużymi kluczami partycji nie są obsługiwane w łączniku.

• Przekazywanie agregacji jest wyłączone dla następującej składni z powodu ograniczeń serwera:

  • Zapytanie nie filtruje klucza partycji lub gdy filtr klucza partycji używa OR operatora z innym predykatem na najwyższym poziomie w klauzuli WHERE .

  • Zapytanie zawiera co najmniej jeden klucz partycji wyświetlany w IS NOT NULL klauzuli w klauzuli WHERE .

• Łącznik w wersji 2 nie obsługuje złożonych typów danych, takich jak tablice, obiekty i struktury hierarchiczne. W tych scenariuszach użyj funkcji dublowania sieci szkieletowej dla usługi Azure Cosmos DB .

• Łącznik V2 używa próbkowania pierwszych 1000 dokumentów, aby opracować wywnioskowany schemat. Takie podejście nie jest zalecane w przypadku scenariuszy ewolucji schematu, w których są aktualizowane tylko niektóre dokumenty. Na przykład nowo dodana właściwość do jednego dokumentu w kontenerze z tysiącami dokumentów może nie zostać uwzględniona w schemacie wnioskowanym. W tych scenariuszach zalecamy funkcję dublowania sieci szkieletowej dla usługi Azure Cosmos DB .

• Łącznik w wersji 2 nie obsługuje wartości nieciągujących we właściwościach obiektu.

• Przekazywanie filtru jest wyłączone dla następującej składni z powodu ograniczeń serwera:

  • Gdy zapytanie zawierające co najmniej jedną kolumnę agregowaną jest przywoływana w klauzuli WHERE

Treści powiązane

• Dowiedz się więcej o usłudze Power BI w artykule Wprowadzenie do usługi Power BI.
• Dowiedz się więcej o usłudze Azure Cosmos DB na stronie docelowej dokumentacji usługi Azure Cosmos DB.