Dataverse

Podsumowanie

Produkt	opis
Stan wydania	Ogólna dostępność
Produkty	Excel Power BI (modele semantyczne) Power BI (przepływy danych) Sieć szkieletowa (Dataflow Gen2) Power Apps (przepływy danych) Dynamics 365 Customer Insights
Typy uwierzytelniania	Konto organizacji Jednostka usługi

Uwaga

Typ uwierzytelniania jednostki usługi nie jest obsługiwany przy korzystaniu z bramy danych lokalnej ani bramy danych sieci wirtualnej (VNet).

Uwaga

Niektóre funkcje mogą być obecne w jednym produkcie, ale nie w innych ze względu na harmonogramy wdrażania i możliwości specyficzne dla hosta.

Wymagania wstępne

Musisz mieć środowisko Dataverse.

Aby uzyskać dostęp do danych w tabelach, musisz mieć uprawnienia do odczytu.

Aby korzystać z łącznika Dataverse, ustawienie punktu końcowego TDS musi być włączone w Twoim środowisku. Więcej informacji: Zarządzanie ustawieniami funkcji i rozwiązywanie problemów z połączeniem przy użyciu programu SQL do wykonywania zapytań dotyczących danych

Aby użyć łącznika usługi Dataverse, należy otworzyć jeden z portów TCP 1433 lub 5558, aby nawiązać połączenie. Port 1433 jest używany automatycznie. Jeśli jednak port 1433 jest zablokowany, możesz zamiast tego użyć portu 5558. Aby włączyć port 5558, należy dołączyć ten numer portu do adresu URL środowiska Usługi Dataverse, na przykład yourenvironmentid.crm.dynamics.com, 5558. Więcej informacji: SQL Server problem z połączeniem z powodu zamkniętych portów

Uwaga

Jeśli używasz Power BI Desktop i musisz użyć portu 5558, musisz utworzyć źródło z adresem URL środowiska Dataverse, takim jak yourenvironmentid.crm.dynamics.com,5558 w Power Query M. Więcej informacji: Finding your Dataverse environment URL

Obsługiwane funkcje

• Adres URL serwera
• Importuj
• DirectQuery (modele semantyczne Power BI)
• Zaawansowany
  • Dołącz kolumny relacji

Nawiązywanie połączenia z usługą Dataverse z poziomu programu Power Query Desktop

Uwaga

Łącznik Power Query Dataverse jest głównie dostosowany do obciążeń analitycznych, a nie do wyodrębniania danych zbiorczych. Więcej informacji: Alternatywne połączenia usługi Dataverse

Aby nawiązać połączenie z usługą Dataverse z Power Query Desktop:

1. Wybierz opcję Dataverse z pozycji Pobierz dane. Więcej informacji: Gdzie uzyskać dane

2. Jeśli łączysz się z tą witryną po raz pierwszy, wybierz pozycję Zaloguj się i wprowadź swoje poświadczenia. Następnie wybierz pozycję Połącz.

   

3. W nawigatorze wybierz wymagane dane, a następnie załaduj lub przekształć dane.

   

4. Jeśli używasz Power Query z Power BI Desktop, zostanie wyświetlony monit o wybranie trybu łączności danych Import lub DirectQuery. Następnie wybierz opcję OK.

   

Nawiązywanie połączenia z usługą Dataverse z usługi Power Query Online

Aby nawiązać połączenie z usługą Dataverse z usługi Power Query Online:

1. Wybierz opcję Dataverse na stronie Wybieranie źródła danych. Więcej informacji: Gdzie uzyskać dane

2. Na stronie Łączenie ze źródłem danych pozostaw pusty adres URL serwera. Pozostawienie pustego adresu wyświetla listę wszystkich dostępnych środowisk, których masz uprawnienia do użycia w oknie Power Query Navigator.

   

   Uwaga

   Jeśli musisz użyć portu 5558, aby uzyskać dostęp do danych, musisz załadować określone środowisko z portem 5558 dołączonym na końcu adresu URL serwera. W takim przypadku przejdź do pozycji Znajdowanie adresu URL środowiska usługi Dataverse, aby uzyskać instrukcje dotyczące uzyskiwania poprawnego adresu URL serwera.

3. W razie potrzeby wprowadź lokalną bramę danych, jeśli zamierzasz używać danych lokalnych. Jeśli na przykład połączysz dane z usługi Dataverse i lokalnej bazy danych SQL Server.

4. Zaloguj się do konta organizacyjnego.

5. Po pomyślnym zalogowaniu wybierz pozycję Dalej.

6. Na stronie nawigacji wybierz wymagane dane, a następnie wybierz pozycję Przekształć dane.

   

Nawiązywanie połączenia przy użyciu opcji zaawansowanych

Power Query Online udostępnia zaawansowane opcje, które można dodać do zapytania w razie potrzeby.

W poniższej tabeli wymieniono opcje zaawansowane, które można ustawić w usłudze Power Query Online.

Opcja zaawansowana	opis
Dołącz kolumny relacji	Jeśli jest zaznaczone, zawiera kolumny, które mogą mieć relacje z innymi tabelami. Jeśli to pole zostanie wyczyszczone, nie będzie można wyświetlić tych kolumn. Więcej informacji: Problemy z wydajnością dotyczące kolumn relacyjnych

Po wybraniu opcji zaawansowanych, których potrzebujesz, wybierz przycisk Dalej , aby nawiązać połączenie z usługą Dataverse.

Jak znaleźć adres URL środowiska Dataverse

Jeśli musisz użyć portu 5558 do nawiązania połączenia z usługą Dataverse, musisz znaleźć adres URL środowiska Usługi Dataverse. Otwórz Power Apps. W prawym górnym rogu strony Power Apps wybierz środowisko, z którym chcesz nawiązać połączenie. Wybierz Ikona ustawień, a następnie wybierz pozycję Ustawienia zaawansowane.

Na nowej karcie przeglądarki, która zostanie otwarta, skopiuj główną część adresu URL. Ten główny adres URL jest unikatowym adresem URL twojego środowiska. Adres URL jest w formacie https://<yourenvironmentid>.crm.dynamics.com/. Przed wklejeniem go w celu nawiązania połączenia ze środowiskiem upewnij się, że usunięto https:// i końcowe /z adresu URL. Dołącz port 5558 na końcu adresu URL środowiska, na przykład yourenvironmentid.crm.dyamics.com 5558.

Kiedy używać łącznika usługi Common Data Service (starsza wersja)

Usługa Dataverse jest bezpośrednim zamiennikiem łącznika usługi Common Data Service. Jednak czasami konieczne może być wybranie łącznika usługi Common Data Service (starsza wersja) zamiast łącznika Usługi Dataverse :

Istnieją pewne typy danych Tabular Data Stream (TDS), które są obsługiwane przez OData przy korzystaniu z usługi Common Data Service (wersja Legacy), ale nie są obsługiwane w Dataverse. Obsługiwane i nieobsługiwane typy danych są wymienione w Jak usługa Dataverse SQL różni się od Transact-SQL.

Wszystkie te funkcje zostaną dodane do łącznika Dataverse w przyszłości, a w tym momencie łącznik usługi Common Data Service (starsza wersja) zostanie wycofany.

Więcej informacji: dostęp do dużych ilości danych usługi Dataverse

Ograniczenia i zagadnienia

Specyficzny dla hosta programu Excel

Łącznik Power Query Dataverse w programie Excel nie obsługuje obecnie klastrów suwerennej chmury (na przykład Chiny, Niemcy, Stany Zjednoczone).

Limity wydajności i ograniczania przepustowości usługi Dataverse

Aby uzyskać informacje na temat wydajności i limitów ograniczania przepustowości dla połączeń usługi Dataverse, przejdź do tematu Limity żądań i alokacje. Te ograniczenia mają zastosowanie zarówno do łącznika Dataverse, jak i do łącznika OData Feed podczas uzyskiwania dostępu do tego samego punktu końcowego.

Szybkość pobierania tabeli

Zgodnie z wytycznymi większość tabel domyślnych jest pobierana z szybkością około 500 wierszy na sekundę przy użyciu łącznika Usługi Dataverse. Weź pod uwagę tę stawkę podczas podejmowania decyzji, czy chcesz nawiązać połączenie z usługą Dataverse, czy wyeksportować je do usługi Data Lake. Jeśli potrzebujesz szybszego pobierania danych, rozważ użycie funkcji Eksport do Data Lake lub punktu końcowego Tabular Data Stream (TDS). Aby uzyskać więcej informacji, przejdź do pozycji Alternatywne połączenia usługi Dataverse.

Alternatywne połączenia usługi Dataverse

Istnieje kilka alternatywnych sposobów wyodrębniania i migrowania danych z usługi Dataverse:

• Użyj funkcji Azure Synapse Link w Power Apps, aby wyodrębnić dane z usługi Dataverse do Azure Data Lake Storage Gen2, która następnie może służyć do uruchamiania analizy. Aby uzyskać więcej informacji na temat funkcji azure Synapse Link, przejdź do Co to jest usługa Azure Synapse Link dla usługi Dataverse?.

• Użyj łącznika OData, aby przenieść dane do i z usługi Dataverse. Aby uzyskać więcej informacji na temat migrowania danych między środowiskami Dataverse przy użyciu łącznika OData przepływów danych, zobacz Migrowanie danych między środowiskami Dataverse przy użyciu łącznika OData przepływów danych.

Uwaga

Zarówno łącznik Usługi Dataverse, jak i interfejsy API OData mają obsługiwać scenariusze analityczne, w których woluminy danych są stosunkowo małe. Zalecaną metodą wyodrębniania danych zbiorczych jest "Azure Synapse Link".

SQL Server problem z połączeniem z powodu zamkniętych portów

Podczas nawiązywania połączenia z łącznikiem Dataverse może wystąpić błąd Nie można nawiązać połączenia, wskazujący, że podczas nawiązywania połączenia z SQL Server wystąpił błąd związany z siecią lub konkretnym wystąpieniem. Ten błąd jest prawdopodobnie spowodowany zablokowaniem portów TCP 1433 lub 5558 podczas połączenia. Aby rozwiązać problem z zablokowanym portem, przejdź do pozycji Zablokowane porty.

Używanie natywnych zapytań bazy danych z usługą Dataverse

Możesz nawiązać połączenie z usługą Dataverse przy użyciu niestandardowej instrukcji SQL lub natywnego zapytania bazy danych. Chociaż nie ma interfejsu użytkownika dla tego środowiska, możesz wprowadzić zapytanie przy użyciu Power Query Advanced Editor. Aby można było użyć natywnego zapytania bazy danych, należy określić bazę danych jako źródło.

Source = CommonDataService.Database([DATABASE URL])

Po zdefiniowaniu źródła bazy danych można określić zapytanie natywne przy użyciu funkcji Value.NativeQuery .

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

W sumie zapytanie wygląda następująco.

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Błędna pisownia nazwy kolumny może spowodować wyświetlenie komunikatu o błędzie dotyczącego składania zapytań, zamiast komunikatu o brakującej kolumnie.

Uzyskiwanie dostępu do dużych ilości danych usługi Dataverse

Zapytania w tabelach Usługi Dataverse mogą zwracać duże ilości danych. Jeśli używasz łącznika Power Query Dataverse, każde konkretne zapytanie, które uzyskuje dostęp do modelu, ma stały limit czasu pięciu (5) minut niezależnie od rozmiaru danych. Aby uzyskać więcej informacji, przejdź do ograniczeń. Dlatego może być konieczne wielokrotne wykonywanie zapytań dotyczących danych w celu uzyskania dostępu do wszystkich danych w modelu. Użycie wielu zapytań może zająć dużo czasu, aby zwrócić wszystkie dane.

Jeśli używasz łącznika usługi Common Data Service (starsza wersja), możesz użyć pojedynczego zapytania, aby uzyskać dostęp do wszystkich danych. Ten łącznik działa inaczej i zwraca wynik w stronach zawierających po 5 tys. rekordów. Chociaż łącznik Common Data Service (starsza wersja) jest bardziej wydajny w zwracaniu dużych ilości danych, nadal może zająć dużo czasu na zwrócenie wyniku.

Zamiast używać tych łączników do uzyskiwania dostępu do dużych ilości danych usługi Dataverse, zalecamy użycie Azure Synapse Link aby uzyskać dostęp do dużych modeli. Korzystanie z usługi Azure Synapse Link jest jeszcze bardziej wydajne niż korzystanie z łączników Power Query Dataverse lub Common Data Service (wersja starsza) i jest specjalnie zaprojektowane pod kątem scenariuszy integracji danych.

Problemy z wydajnością związane z kolumnami relacji

Błędy podglądu mogą wystąpić z powodu znanego ograniczenia, gdy funkcja Właściwości nawigacji jest włączona w usłudze Dataverse.

Możesz na przykład zobaczyć komunikat podobny do następującego: Preview.Error: The type of the current preview value is too complex to display.

Aby rozwiązać ten problem, podobnie jak w przypadku łącznika SQL Server, istnieje opcja wyłączenia właściwości nawigacyjnych (kolumn relacji) w łączniku Dataverse dla poprawy wydajności. Tę opcję można ustawić w zaawansowanych opcjach dostępnych w usłudze Power Query Online lub można ją ustawić przy użyciu parametru CreateNavigationProperties=false w funkcji łącznika Usługi Dataverse.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),