Znane ograniczenia i rozwiązywanie problemów z wirtualnymi tabelami

W tym artykule opisano znane ograniczenia i porady dotyczące rozwiązywania problemów podczas pracy z tabelami wirtualnymi w Microsoft Dataverse.

Znane ograniczenia

Poniżej znajduje się lista znanych ograniczeń tabel wirtualnych utworzonych przy użyciu dostawcy łącznika wirtualnego.

Ogólne

• Używana tabela lub lista musi zawierać co najmniej jedno pole łańcuchowe, które ma być używane jako pole podstawowe, oraz jedno pole GUID. Bez tych pól ciągów nie można utworzyć tabeli wirtualnej i podczas etapu pobierania szczegółów tabeli zostanie wygenerowany błąd.
  • SharePoint używa ukrytego pola identyfikatora liczbowego obecnego na wszystkich listach
  • SQL może używać pola GUID lub liczby całkowitej
  • Program Excel musi mieć pole identyfikatora GUID
• Dataverse może tworzyć tylko kolumny zawierają typy danych zgodne z Dataverse. Obejmuje to następujące typy danych:
  • String
  • Tekst wielowierszowy (memo)
  • Liczba całkowita / Liczba całkowita
  • Dziesiętne
  • Obrót
  • Data/godzina
  • Wartość logiczna (tak/nie)
  • Wybory (wybór wielu wartości)
  • Hiperłącze/URL
• Typy danych nieobsługiwane dla tabel wirtualnych:
  • Pliki i załączniki
  • Image
  • Lookup
• Maksymalna długość znaków dozwolona dla kolumny tekstowej w tabeli wirtualnej to 4000 znaków. Jeśli tabela źródłowa ma maksymalny limit znaków większy niż ta wartość, każda operacja tworzenia/aktualizacji przekraczająca maksymalny limit rezultatów spowoduje błąd walidacji, a operacja zakończy się niepowodzeniem.
• Zapytania tabel wirtualnych nie mogą zwracać więcej niż 1 000 rekordów. W przypadku relacji 1:N lub N z niestandardową tabelą wirtualną wszelkie zapytania przekraczające to ograniczenie kończy się niepowodzeniem i występuje błąd. Użyj filtrowania w zapytaniu, aby zmniejszyć zestaw rekordów jako obejście tego ograniczenia.
• Funkcja audytu nie jest dostępna dla tabel wirtualnych, ponieważ Dataverse może wykonywać i przechowywać dane audytu tylko dla danych przechowywanych lokalnie.
• Zestawienia i pola obliczeniowe nie mogą być obliczane dla tabel wirtualnych. Wynika to z faktu, że zestawienia są obliczeniami po stronie serwera w Dataverse, co wymaga lokalnego przechowywania danych.
• Wirtualna tabela tożsamości Microsoft Entra dostarczana przez firmę Microsoft umożliwia dostęp tylko do odczytu.
• W tabelach wirtualnych Dataverse można wyświetlać wartości w polach, których maksymalna wartość przekracza normalne wartości Dataverse. Wynika to z tego, że przedstawiane wartości nie są przechowywane lokalnie. Na przykład maksymalna wartość całkowita Dataverse wynosi 100 000 000 000, ale może pobrać i wyświetlić 9 000 000 000 000 z programu SharePoint. Jeśli jednak użytkownik próbuje edytować numer w rozmiarze większym niż maksymalny Dataverse zaakceptowany w błędzie, jest wyświetlany wskazanie, że rekord nie może zostać zapisany, ponieważ przekracza maksymalny rozmiar.
• Importowanie i eksportowanie danych tabel nie jest obsługiwane w tabelach wirtualnych.

Dla każdego źródła danych

Poniżej przedstawiono ograniczenia dla każdego źródła danych.

SQL Server

• Wirtualne tabele SQL mogą używać identyfikatora GUID lub pola liczby całkowitej jako klucza podstawowego dla funkcjonalności.
• Tabele programu SQL Server bez kluczy podstawowych: jako klucz podstawowy można wybrać dowolne pole niebędące ciągiem znaków. Tabela wirtualna powinna zostać utworzona pomyślnie. RetrieveMultiple works, inne operacje zakończyły się niepowodzeniem z następującym komunikatem o błędzie (pochodzącej z programu SQL Connector): "Niepowodzenie żądania APIM: BadRequest: W tabeli nie istnieje klucz podstawowy". Aby można było korzystać z funkcji typu GUID lub pola liczby całkowitej, należy użyć jako klucza podstawowego.
• Tabele SQL Server używające klucza podstawowego ciągu tekstowego: Klucz podstawowy ciągu SQL jest jedyną opcją dostępną dla klucza podstawowego tabeli wirtualnej. Klucze podstawowe ciągu SQL Server są obsługiwane tylko wtedy, gdy wartości można przeanalizować jako identyfikator GUID. Jeśli nie mogą być analizowane jako identyfikator GUID, tworzenie tabeli wirtualnej kończy się pomyślnie, ale kończy się niepowodzeniem w czasie wykonywania z następującymi błędami:
  • Maker Portal: „Nie mogliśmy otworzyć twojego stołu. Spróbuj ponownie załadować lub otworzyć ponownie”.
  • Śledzenie sieci: „klucze podstawowe w postaci ciągu znaków są obsługiwane tylko wtedy, gdy można je przeanalizować jako identyfikator GUID”.
• Tabele programu SQL Server bez pól ciągów klucza innego niż klucz podstawowy do użycia jako nazwa podstawowa: Jeśli tabela SQL nie ma dostępnego pola ciągu jako nazwy podstawowej, w kroku konfiguracji zostanie wyświetlony następujący błąd: „Tabela nie nie ma pola podstawowego”
• Widoki SQL mogą służyć do tworzenia wirtualnej tabeli, ale zapewniają tylko operacje odczytu.
• Aby zapoznać się z ograniczeniami SQL Server Connector, przejdź do Odwołanie do łącznika serwera SQL.
• Kolumny Bigint typu danych SQL w tabeli źródłowej są mapowane jako dziesiętny typ danych w tabelach wirtualnych Dataverse. Gdy obsługa platformy jest dostępna dla mapowania bigint na liczbę całkowitą, wcześniej utworzone kolumny w tabeli wirtualnej będą musiały zostać usunięte i należy utworzyć nowe kolumny.
• Obecnie w tabeli wirtualnej nie można obecnie znaleźć kolumn następujących typów:
  • Czas
  • Datetime2
  • Obraz
  • Geometria
  • Obszar geograficzny
  • RowVersion
• Poniższe typy kolumn zawierają tabelę wirtualną, ale są one wyświetlane tylko jako pola tekstowe:
  • HierarchyID
  • Kod XML
  • Sqlvariant

Microsoft Excel Online (Business)

• Program Excel nie jest obecnie obsługiwany w tabeli obsługiwanej przez tabelę wirtualną
• Pliki Excel muszą być przechowywane na OneDrive, aby uczestniczyć w połączeniu wirtualnej tabeli.
• Kolumna Klucz podstawowy powinna być dołączona do formularza tworzenia, jeśli kolumna nie jest automatycznie ustawiana do przyrostu podczas projektowania tabeli źródłowej. Aby operacja wstawiania powiodła się, należy wprowadzić prawidłową wartość w kolumnie klucza podstawowego.
• Jeśli tworzenie Katalogu jednostek zajmuje dużo czasu, możesz sprawdzić stan ukończenia zadania, przechodząc do Ustawienia -> Ustawienia zaawansowane -> Ustawienia -> Widok zadań systemowych.
• Klucz podstawowy może być tylko kolumną zawierającą wartości identyfikatora GUID: ponieważ metadane tabeli programu Excel pokazują wszystkie kolumny jako ciągi, nasz obecny projekt zakłada, że klucz podstawowy będzie zawsze miał identyfikator GUID reprezentowany jako ciąg.

  Uwaga

  Podczas tworzenia jednostki wirtualnej nie jest wykonywana weryfikacja, jeśli wybrano kolumnę bez identyfikatora GUID, jednostka zakończy się niepowodzeniem w czasie wykonywania z następującym błędem: „Klucze podstawowe ciągu są obsługiwane tylko wtedy, gdy można je przeanalizować jako identyfikator GUID”.

• Obsługa automatycznie generowanej kolumny PowerAppsId__: automatycznie generowana kolumna PowerAppsId zostanie użyta, jeśli zostanie znaleziona (będzie to jedyna opcja dostępna dla klucza podstawowego). Podanie wartości dla PowerAppsId jest wymagane podczas tworzenia rekordu, nawet jeśli wartość zostanie faktycznie nadpisana przez automatycznie wygenerowaną. Nie dzieje się tak, jeśli kolumna klucza podstawowego nie jest automatycznie generowaną kolumną PowerAppsId.
• Obecnie w tabeli wirtualnej nie można obecnie znaleźć kolumn następujących typów:
  • Godzina (te pola zostaną utworzone jako pola Data/godzina.
• Konkretne ograniczenia programu Excel Connector: Odwołanie łącznika Excel Online (Business).

Microsoft SharePoint

• Obecnie nie można wybrać widoku Wszystko dla kolumn SharePoint w tabeli wirtualnej. Jest to znany problem.
• Obecnie w tabeli wirtualnej nie można obecnie znaleźć kolumn następujących typów:
  • Osoba
  • Obraz
  • Zarządzane metadane
  • Lokalizacja: Współrzędne
  • Załącznik
• Konkretne kolumny SharePoint, które będą wyświetlane w tabeli wirtualnej:
  • Identyfikator zasobu zgodności to kolumna wewnętrzna, z których SharePoint możne śledzić dane. Można to zignorować.
  • Identyfikator to zewnętrzny klucz podstawowy z SharePoint. Jest tylko do odczytu i można go zignorować.

Salesforce (wersja zapoznawcza)

• Aby uzyskać informacje o ograniczeniach programu Salesforce Connector, przejdź do odwołania do programu Salesforce Connector.
• Pola odwołujące się do innych obiektów Salesforce są zablokowane.

Oracle (wersja zapoznawcza)

• Aby uzyskać informacje o ograniczeniach łącznika Oracle, przejdź do dokumentacji łącznika Oracle.
• Tabela Oracle musi mieć zdefiniowany klucz podstawowy.
• Tabela Oracle musi zawierać co najmniej jedno pole typu ciągu oprócz klucza podstawowego.

Rozwiązywanie problemów

• W tabeli wirtualnej jest tylko jeden (1) rekord, mimo że w tabeli źródłowej jest ich więcej.
  Rozwiązanie: sprawdź tabelę źródłową i upewnij się, że jest zdefiniowana klucz podstawowy.

• Otrzymuję jeden z następujących błędów, gdy usługa Power Apps (make.powerapps.com) pobiera moją listę tabel lub gdy wybieram opcję Zakończ, aby utworzyć tabelę:

  • "Nie znaleziono zasobu dla segmentu msdyn_get_required_fields"
  • „Wywoływanie błędów... sprawdź, czy połączenie... "Środowisko"
  • "Sekwencja nie odpowiada żadnemu elementowi msdyn_get_required_fields"
    Rozwiązanie: w niektórych przypadkach dostawca łącznika wirtualnego może nie mieć najbardziej aktualnego rozwiązania. Aby ustalić, czy rozwiązanie dostawcy łącznika wirtualnego wymaga aktualizacji:
  1. Wybierz Rozwiązania w lewym okienku nawigacyjnym. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
  2. Wybierz kartę Historia.
  3. Wyszukaj dla ConnectorProvider.
  4. Wyświetl informacje, aby sprawdzić, czy rozwiązanie wymaga aktualizacji.
  5. Jeśli historia wskazuje, że konieczna jest aktualizacja, przejdź do komercyjnego portalu Microsoft Marketplace wyszukaj Virtual Connector Provider, a następnie wybierz Pobierz teraz, aby zaimportować rozwiązanie do swojego środowiska.
  6. Wykonaj kroki, aby ponownie utworzyć tabelę wirtualną.

• Zostanie wyświetlony komunikat „Połączenie 'xyz' nie znaleziono w bieżącym środowisku”.podczas pobierania listy połączeń.
  Rozwiązanie: taka sytuacja występuje, gdy w środowisku użytkownika znajduje się duża liczba połączeń Dataverse. Zostało to naprawione w wersji 1029 rozwiązania dostawcy łącznika. Zaktualizowana wersja powinna być dostępna we wszystkich regionach do 20 lutego 2023 r. Aby ustalić, czy rozwiązanie dostawcy łącznika wirtualnego wymaga aktualizacji:

  1. Wybierz Rozwiązania w lewym okienku nawigacyjnym. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
  2. Wybierz kartę Historia.
  3. Wyszukaj dla ConnectorProvider.
  4. Wyświetl informacje, aby sprawdzić, czy rozwiązanie wymaga aktualizacji.
  5. Jeśli historia wskazuje, że konieczna jest aktualizacja, przejdź do komercyjnego portalu Microsoft Marketplace wyszukaj Virtual Connector Provider, a następnie wybierz Pobierz teraz, aby zaimportować rozwiązanie do swojego środowiska.
  6. Wykonaj kroki, aby ponownie utworzyć tabelę wirtualną.

• Otrzymuję powiadomienie, że przekroczono limit czasu podczas tworzenia tabeli wirtualnej.
  Rozwiązanie: taka sytuacja może wystąpić, gdy inne istniejące zadania spowodują opóźnienie tworzenia tabeli wirtualnej. Zaczekaj kilka minut i spróbuj ponownie.

• Otrzymuję powiadomienie, że „Wystąpił nieoczekiwany błąd”
  Rozwiązanie: Dzieje się tak, gdy źródło danych tabeli wirtualnej zostało utworzone z nieprawidłowymi wartościami. Aby rozwiązać ten problem, musisz zlokalizować źródło danych tabeli wirtualnej, które powoduje błąd, usunąć je, a następnie ponownie utworzyć tabelę wirtualną.

  1. Wybierz pozycję Ustawienia (ikona koła zębatego) > Ustawienia zaawansowane z usługi Power Apps.
  2. W górnym menu wybierz Ustawienia.
  3. Przejdź na stronę Rozwiązania. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
  4. Przejdź do rozwiązania, które obejmuje tabelę wirtualną (jeśli nie korzystałeś z rozwiązania, przejdź do rozwiązania domyślnego Common Data Services).
  5. W lewym panelu wybierz pozycję Źródła danych tabeli wirtualnej.
  6. Kliknij dwukrotnie wszystkie źródła danych (wszystkie zaczynają się od VCP_DS_..."), po zlokalizowaniu jednego z błędów, usuń to źródło danych.
  7. Odtwórz swój wirtualny stół.

• Zostanie wyświetlony komunikat „Ta tabela już istnieje, jest to oznacza, że ponownie tworzysz tabelę. Nie można zmienić pola podstawowego i nazwy schematu”.
  Rozwiązanie: ta tabela została wcześniej utworzona. Kontynuowanie tworzenia spowoduje ponowne utworzenie tabeli, co spowoduje, że wszelkie zmiany tabeli dokonane w źródle danych zostaną zaktualizowane w tabeli wirtualnej (obejmuje to dodanie lub usunięcie pól). Niestandardowa nazwa i wartości pola podstawowego nie będą edytowalne.

• Komunikat o błędzie: „primary_key_name nie mogą być puste”
  Rozwiązanie: wybrano tabelę lub listę, która nie zawiera wartości identyfikatora GUID klucza podstawowego. Aby utworzyć tabelę wirtualną, należy dodać w tabeli źródłowej dodatkową kolumnę GUID.

• Stworzyłem wirtualną tabelę Excel, ale nie widzę jej w „Tabelach”.
  Rozwiązanie: Ponieważ tworzenie tabeli wirtualnej jest asynchroniczne, możesz sprawdzić stan procesu w Zadaniach systemowych. Poszukaj zadań systemowych z nazwą rozpoczynającą się Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin i wartością kolumny Dotyczy równą nazwie nowej tabeli wirtualnej. Jeśli status jest nadal W toku, poczekaj na zakończenie zadania. Jeśli wystąpi błąd, możesz uzyskać szczegółowe informacje, klikając system, hiperłącze z nazwą zadania. W tym przykładzie tworzenie tabeli jest nadal w toku:

  

  W tym przypadku tworzenie tabeli nie powiodło się z powodu błędu 429 „Zbyt wiele żądań”:

  

• Zadanie systemowe tworzenia tabeli powiodło się, ale otrzymuję błędy w czasie wykonywania związane z nieprawidłowymi lub brakującymi kolumnami
  Rozwiązanie: Jeśli wystąpi błąd podczas tworzenia pola tabeli, proces tworzenia tabeli nie zakończy się niepowodzeniem i spróbuje kontynuować z pozostałymi polami. Dzieje się tak, ponieważ nie chcemy blokować tworzenia tabel wirtualnych, gdy niektóre typy kolumn nie są obsługiwane. Aby uzyskać szczegółowe informacje o błędzie, możesz włączyć logowanie w Administracja> Ustawienia systemu > Dostosowania > Włącz logowanie do dziennika śledzenia wtyczek, a następnie usuń tabelę wirtualną i spróbuj ją ponownie utworzyć.

Następne kroki

Tworzenie tabel wirtualnych przy użyciu dostawcy wirtualnego łącznika (wersja zapoznawcza)

Konfigurowanie relacji między tabelami wirtualnymi