Konfigurowanie połączenia usługi Dataverse

W tym artykule opisano kroki tworzenia połączenia usługi Dataverse.

Podsumowanie

Złącze Dataverse obsługuje następujące typy uwierzytelniania odpowiednio na potrzeby kopiowania i przepływu danych Gen2.

Ustaw połączenie z dataflow Gen2

Możesz połączyć przepływ danych Gen2 z usługą Dataverse w środowisku Fabric za pomocą łączników Power Query. Wykonaj następujące kroki, aby utworzyć połączenie:

1. Sprawdź możliwości, ograniczenia i aspekty, aby upewnić się, że Państwa scenariusz jest obsługiwany.
2. Pełne wymagania wstępne dotyczące usługi Dataverse.
3. Pobieranie danych w systemie Fabric.
4. Znajdź adres URL środowiska Dataverse.
5. Nawiązywanie połączenia z usługą Dataverse.

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

Obsługiwane funkcje

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

Ustawienia połączenia

Pobierz dane

Aby uzyskać dane w usłudze Data Factory:

1. Po lewej stronie Data Factory wybierz Obszary robocze .

2. W obszarze roboczym Data Factory wybierz pozycję Nowy>, a następnie wybierz element usługi Data Factory: przepływ danych, potok, zadanie kopiowania lub zadanie tworzenia kopii lustrzanej.

   

3. W Power Query wybierz Pobierz dane na wstążce lub wybierz Pobierz dane z innego źródła w bieżącym widoku.

   

4. Na stronie Wybieranie źródła danych użyj pozycji Wyszukaj , aby wyszukać nazwę łącznika, lub wybierz pozycję Wyświetl więcej z prawej strony listy łączników, aby wyświetlić wszystkie łączniki dostępne w usłudze Data Factory.

   

5. Jeśli zdecydujesz się wyświetlić więcej łączników, nadal możesz użyć funkcji Wyszukaj , aby wyszukać nazwę łącznika lub wybrać kategorię, aby wyświetlić listę łączników skojarzonych z tą kategorią.

   

Znajdowanie adresu URL środowiska

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 ikonę ustawień, a następnie wybierz Zaawansowane ustawienia.

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.dynamics.com,5558.

Instrukcje dotyczące połączenia

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 / Notatka

   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 bazy danych Dataverse i lokalnej bazy danych programu 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.

   

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:

• Funkcja Azure Synapse Link w usłudze Power Apps umożliwia wyodrębnianie danych z usługi Dataverse do usługi Azure Data Lake Storage Gen2, która następnie może służyć do uruchamiania analiz. Aby uzyskać więcej informacji na temat funkcji usługi Azure Synapse Link, przejdź do tematu 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.

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 Edytor zaawansowany. 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, zwrócenie wyniku nadal może trwać dużo czasu.

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]),

Treści powiązane

• Aby uzyskać więcej informacji na temat tego łącznika, przeczytaj dokumentację łącznika Dataverse.