Rozwiązywanie problemów z łącznikami Dynamics 365, Dataverse (Common Data Service) i Dynamics CRM w Data Factory w Microsoft Fabric

2025-03-27

Ten artykuł zawiera sugestie dotyczące rozwiązywania typowych problemów z usługami Dynamics 365, Dataverse (Common Data Service) i łącznikami Dynamics CRM w usłudze Data Factory w Microsoft Fabric.

Kod błędu: DynamicsCreateServiceClientError

Komunikat: This is a transient issue on Dynamics server side. Try to rerun the pipeline.
Przyczyna: Problem jest przejściowym problemem po stronie serwera Dynamics.
Zalecenie: Uruchom ponownie potok. Jeśli wystąpi błąd ponownie, spróbuj zmniejszyć równoległość. Jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usługi Dynamics.

Brak kolumn podczas importowania schematu lub podglądu danych

Objawy: Niektóre kolumny brakuje podczas importowania schematu lub przeglądania danych. Komunikat o błędzie: The valid structure information (column name and type) are required for Dynamics source.
Przyczyna: Ten problem jest zamierzony, ponieważ potoki usługi Data Factory i Synapse nie mogą wyświetlać kolumn, które nie zawierają żadnych wartości w pierwszych 10 rekordach. Upewnij się, że dodane kolumny mają poprawny format.
Zalecenie: Ręcznie dodaj kolumny na karcie mapowania. Aby uzyskać więcej informacji, zobacz Jawne mapowanie.

Kod błędu: DynamicsMissingTargetForMultiTargetLookupField

Komunikat: Cannot find the target column for multi-target lookup field: '%fieldName;'.
Przyczyna: kolumna docelowa nie istnieje w źródle ani w mapowaniu kolumn.
Zalecenie:
1. Upewnij się, że źródło zawiera kolumnę docelową.
2. Dodaj kolumnę docelową w mapowaniu kolumn. Upewnij się, że kolumna docelowa ma format {fieldName}@EntityReference.

Kod błędu: DynamicsInvalidTargetForMultiTargetLookupField

Komunikat: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'
Przyczyna: Nieprawidłowa nazwa encji została podana jako docelowa encja pola wyszukiwania z wieloma celami.
Zalecenie: podaj prawidłową nazwę jednostki dla pola odnośnika z wieloma elementami docelowymi.

Kod błędu: DynamicsInvalidTypeForMultiTargetLookupField

Komunikat: The provided target type is not a valid string. Field: '%fieldName;'.
Przyczyna: Wartość w kolumnie docelowej nie jest ciągiem.
Zalecenie: podaj prawidłowy ciąg w kolumnie docelowej wyszukiwania wielokierunkowego.

Kod błędu: DynamicsFailedToRequestServer

Komunikat: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.
Przyczyna: Serwer Dynamics jest niezmienialny lub niedostępny albo występują problemy z siecią.
Zalecenie: Aby uzyskać więcej informacji, sprawdź łączność sieciową lub sprawdź dziennik serwera Dynamics. Aby uzyskać dalszą pomoc, skontaktuj się z pomocą techniczną usługi Dynamics.

Kod błędu: DynamicsFailedToConnect

Komunikat: Failed to connect to Dynamics: %message;

Przyczyny i zalecenia: Różne przyczyny mogą prowadzić do tego błędu. Zapoznaj się z poniższą listą, aby zapoznać się z możliwą analizą przyczyn i powiązanymi zaleceniami.

Analiza przyczyny	Zalecenie
Widzisz `ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled.` lub w przeciwnym razie `Unable to Login to Dynamics CRM, message:ERROR REQUESTING Token FROM THE Authentication context - USER intervention required but not permitted by prompt behavior AADSTS50079: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multi-factor authentication to access '00000007-0000-0000-c000-000000000000'` jeśli przypadek użycia spełnia wszystkie następujące trzy warunki: • Nawiązujesz połączenie z usługą Dynamics 365, Common Data Service lub Dynamics CRM. • Używasz uwierzytelniania usługi Office365. • Dzierżawa i użytkownik są skonfigurowani w usłudze Microsoft Entra ID na potrzeby dostępu warunkowego i/lub uwierzytelniania wieloskładnikowego są wymagane (zobacz ten link do dokumentu usługi Dataverse). W tych okolicznościach połączenie działało pomyślnie przed 8.06.2021 r. Począwszy od 9.06.2021 r., połączenia zaczną zawodzić z powodu wycofania regionalnej Usługi Discovery (zobacz ten link).	Jeśli dzierżawca i użytkownik są skonfigurowani w usłudze Microsoft Entra ID na potrzeby dostępu warunkowego i/lub uwierzytelniania wieloskładnikowego, musisz użyć obiektu usługi Microsoft Entra, aby uwierzytelnić się po 8 czerwca 2021. Zapoznaj się z tym linkiem , aby uzyskać szczegółowe instrukcje.
Jeśli zostanie wyświetlony `Office 365 auth with OAuth failed` komunikat o błędzie, oznacza to, że serwer może mieć pewne konfiguracje niezgodne z protokołem OAuth.	• Skontaktuj się z zespołem wsparcia Dynamics, aby uzyskać pomoc. • Użyj uwierzytelniania przy użyciu jednostki usługi, i możesz odnieść się do tego artykułu: Przykład: Dynamics online przy użyciu jednostki usługi Microsoft Entra i uwierzytelniania certyfikatu.
Jeśli w komunikacie o błędzie pojawi się `Unable to retrieve authentication parameters from the serviceUri`, oznacza to, że albo wprowadzono nieprawidłowy adres URL usługi Dynamics, albo serwer proxy/zapora przechwytuje ruch.	• Upewnij się, że w połączeniu umieścisz prawidłowy identyfikator URI usługi. • Jeśli używasz samodzielnie hostowanego środowiska wykonawczego IR, upewnij się, że firewall/serwer proxy nie przechwytuje żądań do serwera Dynamics.
Jeśli zostanie wyświetlony `An unsecured or incorrectly secured fault was received from the other party` komunikat o błędzie, oznacza to, że nieoczekiwane odpowiedzi zostały odebrane po stronie serwera.	• Upewnij się, że nazwa użytkownika i hasło są poprawne, jeśli używasz uwierzytelniania usługi Office 365. • Upewnij się, że wprowadzasz prawidłowy identyfikator URI usługi. • Jeśli używasz regionalnego adresu URL CRM (adres URL ma liczbę po "crm"), upewnij się, że używasz poprawnego identyfikatora regionalnego. • Skontaktuj się z zespołem pomocy technicznej usługi Dynamics, aby uzyskać pomoc.
Jeśli zostanie wyświetlony `No Organizations Found` komunikat o błędzie, oznacza to, że nazwa organizacji jest nieprawidłowa lub użyto nieprawidłowego identyfikatora regionu CRM w adresie URL usługi.	• Upewnij się, że wprowadzasz prawidłowy identyfikator URI usługi. • Jeśli używasz regionalnego adresu URL CRM (adres URL ma liczbę po "crm"), upewnij się, że używasz poprawnego identyfikatora regionalnego. • Skontaktuj się z zespołem pomocy technicznej usługi Dynamics, aby uzyskać pomoc.
Jeśli widzisz `401 Unauthorized` komunikat o błędzie związany z usługą Microsoft Entra, oznacza to, że występuje problem z jednostką usługi.	Postępuj zgodnie ze wskazówkami w komunikacie o błędzie, aby rozwiązać problem z jednostką usługi.
W przypadku innych błędów zazwyczaj problem występuje po stronie serwera.	Użyj narzędzia XrmToolBox , aby nawiązać połączenie. Jeśli błąd będzie się powtarzać, skontaktuj się z zespołem pomocy technicznej usługi Dynamics, aby uzyskać pomoc.

Kod błędu: DynamicsOperationFailed

Komunikat: Dynamics operation failed with error code: %code;, error message: %message;.
Przyczyna: Operacja nie powiodła się po stronie serwera.
Zalecenie: Wyodrębnij kod błędu operacji dynamics z komunikatu o błędzie: Dynamics operation failed with error code: {code}i zapoznaj się z artykułem Kody błędów usługi sieci Web, aby uzyskać bardziej szczegółowe informacje. W razie potrzeby możesz skontaktować się z zespołem pomocy technicznej usługi Dynamics.

Kod błędu: DynamicsInvalidFetchXml

Komunikat: The Fetch Xml query specified is invalid.
Przyczyna: W pliku XML pobierania wystąpił błąd.
Zalecenie: Napraw błąd podczas pobierania kodu XML.

Kod błędu: DynamicsMissingKeyColumns

Komunikat: Input data must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;
Przyczyna: Dane źródłowe nie zawierają kolumny klucza dla jednostki docelowej.
Zalecenie: Upewnij się, że kolumny kluczy znajdują się w danych źródłowych lub zamapuj kolumnę źródłową na kolumnę klucza w jednostce docelowej.

Kod błędu: DynamicsPrimaryKeyMustBeGuid

Komunikat: The primary key attribute '%attribute;' must be of type guid.
Przyczyna: Typ kolumny klucza podstawowego nie jest GUID.
Zalecenie: upewnij się, że kolumna klucza podstawowego w danych źródłowych ma typ "Guid".

Kod błędu: DynamicsAlternateKeyNotFound

Komunikat: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.
Przyczyna: podany klucz alternatywny nie istnieje, co może być spowodowane przez nieprawidłowe nazwy kluczy lub niewystarczające uprawnienia.
Zalecenie:
- Napraw literówki w nazwie klucza.
- Upewnij się, że masz wystarczające uprawnienia do obiektu.

Kod błędu: DynamicsInvalidSchemaDefinition

Komunikat: The valid structure information (column name and type) are required for Dynamics source.
Przyczyna: kolumnom docelowym w mapowaniu kolumn brakuje właściwości „type”.
Zalecenie: właściwość "type" można dodać do tych kolumn w mapowaniu kolumn przy użyciu edytora JSON w portalu.

Kod błędu: UserErrorUnsupportedAttributeType

Komunikat: The attribute type 'Lookup' of field %attributeName; is not supported
Przyczyna: Podczas ładowania danych do miejsca docelowego usługi Dynamics usługa Azure Data Factory nakłada walidację na metadane atrybutu wyszukiwania. Istnieje jednak znany problem polegający na tym, że niektóre jednostki Dynamics nie mają prawidłowych metadanych atrybutów odnośnika, które zawierają listę obiektów docelowych, co mogłoby skutkować niepowodzeniem weryfikacji.
Zalecenie: Skontaktuj się z zespołem pomocy technicznej usługi Dynamics, aby rozwiązać ten problem.

Działanie kopiowania z usługi Dynamics 365 odczytuje więcej wierszy niż ich rzeczywista liczba

Objawy: działanie kopiowania z usługi Dynamics 365 odczytuje więcej wierszy niż rzeczywista liczba.
Przyczyna: Serwer usługi Dynamics 365 zawsze wskazuje więcej dostępnych rekordów.
Zalecenie: Użyj narzędzia XrmToolBox , aby przetestować kod FetchXML z stronicowaniem. Narzędzie XrmToolBox z niektórymi zainstalowanymi narzędziami może pobierać liczbę rekordów. Aby uzyskać więcej informacji, zobacz XrmToolBox.

Nie można uzyskać dostępu do kolumn wirtualnych ze źródeł usługi Dynamics w działaniu kopiowania

Objawy: Nie można uzyskać dostępu do kolumn wirtualnych ze źródeł usługi Dynamics w działaniu kopiowania.
Przyczyna: kolumna wirtualna nie jest teraz obsługiwana.
Zalecenie: W przypadku wartości Zestawu opcji postępuj zgodnie z poniższymi opcjami, aby ją pobrać:
- Kod typu obiektu można uzyskać, korzystając z instrukcji How to Find the Object Type Code for Any Entity (Jak znaleźć kod typu obiektu dla dowolnej jednostki).
- Możesz połączyć jednostkę StringMap z jednostką docelową i uzyskać skojarzone wartości.

Równoległe kopie w magazynie danych programu Dynamics CRM

Objawy: nie wiesz, czy istnieje możliwość skonfigurowania kopii równoległej w magazynie danych programu Dynamics CRM, a także nie znasz zakresu wartości, które można ustawić w sekcji "Stopień równoległości kopiowania".
Zalecenie: równoległe sterowanie kontroluje równoległość kopiowania, a sekcja "Stopień równoległości kopiowania" może być ustawiona na wartość niezerową. Duża liczba może spowodować ograniczenie przepustowości po stronie serwera Dynamics, co może obniżyć przepływność, ale teraz ograniczenie jest obsługiwane przez użycie publicznego zestawu SDK.

Konwersja typu dynamicznego

Objawy: próbujesz przekonwertować identyfikator GUID na ciąg w źródle usługi Dynamics, ale wystąpi błąd.
Przyczyna: Gdy usługa Dynamics jest używana jako źródło, konwersja typu nie jest obsługiwana.
Zalecenie: włącz przemieszczanie i ponów próbę.

Aby uzyskać pomoc dotyczącą rozwiązywania problemów, wypróbuj następujące zasoby: