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.

Na poniższej liście opisano znane ograniczenia dotyczące tabel wirtualnych utworzonych przy użyciu dostawcy łącznika wirtualnego.

Ogólne ograniczenia

• Używana tabela lub lista musi zawierać co najmniej jedno pole ciągu do użycia jako pole podstawowe i jedno pole GUID. Bez tych pól ciągów nie można utworzyć tabeli wirtualnej i wystąpi błąd podczas etapu pobierania szczegółów tabeli.
  • SharePoint używa ukrytego pola identyfikatora liczbowego na wszystkich listach.
  • Język SQL może używać identyfikatora GUID lub pola liczby całkowitej.
  • Excel musi mieć pole GUID.
• Dataverse może tworzyć tylko kolumny z typami danych zgodnymi z Dataverse. To ograniczenie obejmuje następujące typy danych:
  • Ciąg
  • Tekst wielowierszowy (memo)
  • Liczba całkowita / Liczba całkowita
  • Dziesiętny
  • Pływak
  • Data i godzina
  • Wartość logiczna (tak/nie)
  • Wybory (wybór wielu wartości)
  • Hiperłącze/URL
• Usługa Dataverse nie obsługuje następujących typów danych dla tabel wirtualnych:
  • Pliki i załączniki
  • obraz
• 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 lub aktualizowania przekraczająca maksymalny limit znaków powoduje błąd sprawdzania poprawności, a operacja kończy się niepowodzeniem.
• Zapytania dotyczące tabeli wirtualnej są ograniczone do zwracania 1000 rekordów. Jeśli masz relację 1:N lub N:1 niestandardową wielotabelową (polimorficzną) z tabelą wirtualną, każde zapytanie, które przekracza ten limit, kończy się niepowodzeniem i zwraca błąd. Użyj filtrowania w zapytaniu, aby zmniejszyć zestaw rekordów jako obejście tego ograniczenia.
• Funkcja inspekcji nie jest dostępna dla tabel wirtualnych, ponieważ Dataverse może wykonywać i przechowywać dane inspekcji tylko dla danych przechowywanych lokalnie.
• Zestawienia i pola obliczeniowe nie mogą być obliczane dla tabel wirtualnych. To ograniczenie istnieje, ponieważ sumowania są obliczeniami po stronie serwera w usłudze Dataverse, co wymaga lokalnego przechowywania danych.
• Kolumny formuł nie mogą używać tabel wirtualnych.
• Tabela wirtualna Microsoft Entra ID udostępniana przez firmę Microsoft zezwala tylko na dostęp do odczytu.
• W tabelach wirtualnych Dataverse można wyświetlać wartości w polach, których maksymalna wartość przekracza normalne wartości Dataverse. To zachowanie występuje, ponieważ prezentowane wartości nie są przechowywane lokalnie. Na przykład maksymalna wartość liczby całkowitej w usłudze Dataverse wynosi 100 000 000 000, ale może pobrać i wyświetlić 9 000 000 000 000 z SharePoint. Jeśli jednak użytkownik próbuje edytować liczbę do rozmiaru większego niż maksymalny zaakceptowany rozmiar w usłudze Dataverse, zostanie podany błąd wskazujący, że nie można zapisać rekordu, ponieważ przekracza maksymalny rozmiar.
• Importowanie i eksportowanie danych tabel nie jest obsługiwane w tabelach wirtualnych.
• Zapytania dotyczące tabel wirtualnych używających negatywnych operatorów filtrujących, takich jak "Nie równa się" lub "Nie zawiera", mogą prowadzić do nieprawidłowego działania stronicowania po pierwszej stronie. Obecnie nie ma obsługiwanego obejścia. Unikaj używania filtrów ujemnych.

Ograniczenia dotyczące każdego źródła danych

Następujące ograniczenia dotyczą każdego źródła danych.

SQL Server

• W przypadku funkcji tabele wirtualne SQL używają identyfikatora GUID lub pola liczby całkowitej jako klucza podstawowego.
• SQL Server tabele bez kluczy podstawowych: możesz wybrać dowolne pole nieciągające jako klucz podstawowy. Tabelę wirtualną można utworzyć pomyślnie. RetrieveMultiple działa, ale inne operacje kończą się błędem z następującym komunikatem o błędzie (pochodzącym z łącznika SQL): "Żądanie usługi APIM nie powiodło się: BadRequest: W tabeli brakuje klucza podstawowego". Dla zachowania funkcjonalności należy użyć identyfikatora GUID lub pola liczby całkowitej jako klucza podstawowego.
• SQL Server tabele używające klucza podstawowego ciągu znaków: klucz podstawowy ciągu znaków SQL jest jedyną dostępną opcją dla wirtualnej tabeli. Klucze podstawowe typu String w SQL Server są obsługiwane tylko wtedy, gdy wartości mogą być analizowane jako globalny unikalny identyfikator (GUID). Jeśli wartości nie mogą być analizowane jako identyfikator GUID, tworzenie tabeli wirtualnej powiedzie się, jednak podczas wykonywania pojawiają się następujące błędy:
  • Power Apps (make.powerapps.com): "Nie mogliśmy otworzyć Twojej tabeli. Spróbuj ponownie załadować lub otworzyć ponownie”.
  • Śledzenie sieci: „Podstawowe klucze string są obsługiwane tylko wtedy, gdy można je przeanalizować jako identyfikator GUID”.
• SQL Server tabele bez pól tekstowych innych niż klucze podstawowe do użycia jako nazwa podstawowa: jeśli tabela SQL nie ma pola tekstowego, które można użyć jako nazwę podstawową, krok konfiguracji wyświetla następujący błąd: "Tabela nie ma pola podstawowego."
• Za pomocą widoków SQL można utworzyć tabelę wirtualną, ale zapewniają one tylko operacje odczytu.
• W przypadku ograniczeń łącznika SQL Server przejdź do dokumentacji łącznika SQL Server.
• Typ danych SQL, kolumny bigint w tabeli źródłowej, są mapowane na typ danych dziesiętnych w wirtualnych tabelach Dataverse. Jeśli obsługa platformy jest dostępna na potrzeby mapowania bigint na liczbę całkowitą, musisz usunąć wcześniej utworzone kolumny w tabeli wirtualnej i utworzyć nowe kolumny.
• W tej chwili nie można uwzględnić następujących typów kolumn w tabeli wirtualnej:
  • Czas
  • Datetime2
  • obraz
  • Geometry
  • Geografia
  • RowVersion
  • Wybór
• Następujące typy kolumn są zawarte w tabeli wirtualnej, ale są wyświetlane tylko jako pola tekstowe:
  • HierarchyID
  • XML
  • Sqlvariant

Microsoft Excel Online (business)

• Excel nie jest obecnie obsługiwany w wirtualnym środowisku sterowanym tabelą.
• Aby uczestniczyć w połączeniu z tabelą wirtualną, należy przechowywać pliki Excel w OneDrive.
• Dołącz kolumnę klucza podstawowego do formularza tworzenia, jeśli nie ustawisz kolumny tak, aby automatycznie zwiększała się podczas projektowania bazowej tabeli źródłowej. Aby operacja wstawiania powiodła się, musisz wprowadzić prawidłową wartość w kolumnie klucza podstawowego.
• Jeśli tworzenie wykazu encji zajmuje dużo czasu, możesz sprawdzić stan ukończenia zadania, przechodząc do Ustawienia>Ustawienia zaawansowane>Ustawienia>Zadania systemowe.
• Kluczem podstawowym może być tylko kolumna zawierająca wartości identyfikatora GUID: ponieważ metadane tabela programu Excel pokazują wszystkie kolumny jako ciąg, bieżący projekt zakłada, że klucz podstawowy jest zawsze identyfikatorem GUID reprezentowanym jako ciąg.

  Uwaga / Notatka

  Podczas tworzenia tabeli wirtualnej nie jest wykonywana walidacja. W przypadku wybrania kolumny innej niż IDENTYFIKATOR GUID tabela zakończy się niepowodzeniem w czasie wykonywania z powodu następującego błędu: "Klucze podstawowe ciągów są obsługiwane tylko wtedy, gdy można je przeanalizować jako identyfikator GUID".

• PowerAppsId__ Obsługa automatycznie wygenerowanej kolumny: kolumna wygenerowana automatycznie PowerAppsId jest używana, jeśli zostanie znaleziona (jest to jedyna opcja dostępna dla klucza podstawowego). Podanie wartości dla PowerAppsId jest wymagane podczas tworzenia rekordu, nawet jeśli wartość jest faktycznie nadpisywana przez wartość wygenerowaną automatycznie. To wymaganie nie występuje, jeśli kolumna klucza podstawowego nie jest kolumną PowerAppsId wygenerowaną automatycznie.
• W tej chwili nie można uwzględnić następujących typów kolumn w tabeli wirtualnej:
  • Czas (są one tworzone jako pola daty i czasu).
• Aby uzyskać informacje o określonych ograniczeniach łącznika Excel, przejdź do: Odwołanie do łącznika programu Excel Online (Business).

Microsoft SharePoint

• Obecnie nie można wybrać widoku All dla kolumn SharePoint w tabeli wirtualnej. To ograniczenie jest znanym problemem.
• W tej chwili nie można uwzględnić następujących typów kolumn w tabeli wirtualnej:
  • Osoba
  • obraz
  • Zarządzane metadane
  • Lokalizacja: Współrzędne
  • Załącznik
• Wirtualna tabela pokazuje następujące specyficzne dla SharePoint kolumny:
  • Compliance Asset ID to kolumna wewnętrzna z SharePoint na potrzeby śledzenia. Możesz go zignorować.
  • ID jest zewnętrznym kluczem podstawowym z SharePoint. Jest on tylko do odczytu i można go zignorować.

Salesforce (wersja zapoznawcza)

• Aby uzyskać informacje o ograniczeniach łącznika usługi Salesforce, przejdź do dokumentacji łącznika usługi Salesforce.
• Nie można odblokować pól odwołujących się do innych obiektów usługi Salesforce.

Oracle (wersja zapoznawcza)

• Aby uzyskać informacje o ograniczeniach łącznika Oracle, przejdź do dokumentacji łącznika Oracle.
• Musisz zdefiniować klucz podstawowy dla tabeli Oracle.
• Tabela Oracle musi mieć 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 ma zdefiniowany klucz podstawowy.

• Podczas pobierania listy tabel w Power Apps (make.powerapps.com) występuje jeden z następujących błędów lub po wybraniu Finish w celu utworzenia tabeli:

  • "Nie znaleziono zasobu dla segmentu msdyn_get_required_fields"
  • "Błąd podczas wywoływania... Sprawdź, czy połączenie... istnieje w środowisku"
  • "Sekwencja nie pasuje do żadnego elementu dla msdyn_get_required_fields"
    Rozwiązanie: W niektórych przypadkach możesz nie mieć najbardziej aktualnego rozwiązania dla dostawcy łącznika wirtualnego. Aby ustalić, czy rozwiązanie dostawcy łącznika wirtualnego wymaga aktualizacji:
  1. Wybierz Rozwiązania w lewym panelu nawigacji. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
  2. Wybierz kartę Historia .
  3. SzukajConnectorProvider.
  4. Wyświetl informacje, aby sprawdzić, czy rozwiązanie wymaga aktualizacji.
  5. Jeśli historia wskazuje, że wymagana jest aktualizacja, przejdź do Microsoft commercial 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ą.

• Podczas pobierania listy połączeń zostanie wyświetlony komunikat "Nie można odnaleźć połączenia "xyz" w bieżącym środowisku.
  Rozwiązanie: Dzieje się tak, gdy w środowisku użytkownika Dataverse występuje duża liczba połączeń. Zostało to naprawione w wersji 1,029 rozwiązania dostawcy łącznika. Aby ustalić, czy rozwiązanie dostawcy łącznika wirtualnego wymaga aktualizacji:

  1. Wybierz Rozwiązania w lewym panelu nawigacji. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
  2. Wybierz kartę Historia .
  3. SzukajConnectorProvider.
  4. Wyświetl informacje, aby sprawdzić, czy rozwiązanie wymaga aktualizacji.
  5. Jeśli historia wskazuje, że wymagana jest aktualizacja, przejdź do Microsoft commercial 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ą.

• Otrzymasz powiadomienie, że podczas tworzenia tabeli wirtualnej nastąpiło przekroczenie limitu czasu.
  Rozwiązanie: Może się tak zdarzyć, gdy inne istniejące zadania powodują opóźnienie tworzenia tabeli wirtualnej. Zaczekaj kilka minut i spróbuj ponownie.

• Otrzymasz 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 Ustawienia (ikona koła zębatego) >Ustawienia zaawansowane z Power Apps.
  2. W górnym menu wybierz Ustawienia.
  3. Przejdź do 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 panelu po lewej stronie wybierz źródła danych tabel wirtualnych.
  6. Kliknij dwukrotnie każde źródło danych (wszystkie zaczynają się od VCP_DS_..."), a po zlokalizowaniu tego, w którym występuje błąd, usuń to źródło danych.
  7. Odtwórz swoją tabelę wirtualną.

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

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

• Utworzono tabelę wirtualną Excel, ale nie widać jej w obszarze Tables w Power Apps.
  Rozwiązanie: Ponieważ tworzenie tabeli wirtualnej jest asynchroniczne, stan procesu można sprawdzić w obszarze Zadania systemowe. Szukaj zadań systemowych, których nazwa zaczyna się od Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin, a wartość kolumny Dotyczy jest równa nazwie nowej tabeli wirtualnej. Jeśli status jest nadal w toku, po prostu poczekaj na zakończenie zadania. Jeśli wystąpi błąd, możesz uzyskać szczegółowe informacje, wybierając hiperłącze system, nazwa 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 zakończyło się pomyślnie, ale występują błędy środowiska uruchomieniowego związane z nieprawidłowymi lub brakującymi kolumnami.
  Rozwiązanie: Jeśli podczas tworzenia pola tabeli wystąpi błąd, proces tworzenia tabeli nie zakończy się niepowodzeniem i zostanie podjęta próba kontynuowania pracy z pozostałymi polami. Dzieje się tak, ponieważ system nie chce blokować tworzenia tabeli wirtualnej, gdy niektóre typy kolumn nie są obsługiwane. Aby uzyskać szczegółowe informacje o błędzie, włącz rejestrowanie w obszarze Administracja>Ustawienia>systemowe Dostosowania>Włącz rejestrowanie w dzienniku śledzenia wtyczki, a następnie usuń tabelę wirtualną i spróbuj utworzyć ją ponownie.

• Jeśli usunąłeś połączenie połączone z tabelą wirtualną i utworzyłeś je ponownie, aplikacja Dostawca łącznika wirtualnego traci uprawnienia do dostępu do nowego połączenia, co uniemożliwia pobieranie danych.
  Rozwiązanie: Ręcznie udostępnij ponownie utworzoną połączenie z aplikacją "Dostawca łącznika wirtualnego" przy użyciu funkcji udostępniania połączenia w celu przywrócenia dostępu.

• Gdy niestandardowy dostawca danych dla tabeli wirtualnej zostanie zaktualizowany w celu obsługi nowych operacji (np. tworzenia, aktualizowania, usuwania), platforma nie dodaje automatycznie odpowiednich uprawnień do istniejącej jednostki tabeli wirtualnej.
  Rozwiązanie: Aby włączyć nowe uprawnienia, użytkownik musi ponownie utworzyć jednostkę tabeli wirtualnej po zaktualizowaniu dostawcy danych.

Dalsze kroki

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

Konfigurowanie relacji między tabelami wirtualnymi