Rozwiązywanie problemów z łącznikami Dynamics 365, Dataverse (Common Data Service) i Dynamics CRM w usługach Azure Data Factory i Azure Synapse

  • Artykuł

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

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

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: w przypadku importowania schematu lub podglądu niektórych kolumn brakuje niektórych kolumn. Komunikat o błędzie: The valid structure information (column name and type) are required for Dynamics source.

  • Przyczyna: Ten problem jest zgodnie z projektem, 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 ujścia 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 jednostki jest podana jako jednostka docelowa pola odnośnika z wieloma elementami docelowymi.

  • 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: DynamicsFailedToRequetServer

  • 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: DynamicsFailedTo Połączenie

  • 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żliwymi analizami 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ługami Dynamics 365, Common Data Service lub Dynamics CRM.
  • Używasz uwierzytelniania usługi Office365.
  • Dzierżawa i użytkownik jest skonfigurowany w usłudze Microsoft Entra ID na potrzeby dostępu warunkowego i/lub uwierzytelniania wieloskładnikowego jest wymagany (zobacz ten link do dokumentu usługi Dataverse).
    • W tych okolicznościach połączenie powiodło się przed 8.06.2021 r. Uruchomienie połączenia 6/9/2021 zakończy się niepowodzeniem z powodu wycofania regionalnej usługi odnajdywania (zobacz ten link).    		 Jeśli dzierżawa i użytkownik jest skonfigurowany w usłudze Microsoft Entra ID na potrzeby dostępu warunkowego i/lub uwierzytelniania wieloskładnikowego, musisz użyć nazwy głównej usługi "Microsoft Entra", aby uwierzytelnić się po 2021-06-8.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 pomocy technicznej usługi Dynamics, aby uzyskać pomoc.
  • Użyj uwierzytelniania jednostki usługi i zapoznaj się z tym artykułem: Przykład: Dynamics Online przy użyciu jednostki usługi Microsoft Entra i uwierzytelniania certyfikatu.
    		•
    Jeśli zostanie wyświetlony Unable to retrieve authentication parameters from the serviceUri komunikat o błędzie, oznacza to, że wprowadzasz nieprawidłowy adres URL usługi Dynamics lub serwer proxy/zaporę w celu przechwycenia ruchu.
  • Upewnij się, że w połączonej usłudze umieszczono prawidłowy identyfikator URI usługi.
  • Jeśli używasz własnego środowiska IR, upewnij się, że zapora/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 masz 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 masz 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 DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • Przyczyna: Dane źródłowe nie zawierają kolumny klucza dla jednostki ujścia.

  • Zalecenie: Upewnij się, że kolumny kluczy znajdują się w danych źródłowych lub zamapuj kolumnę źródłową na kolumnę klucza w jednostce ujścia.

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 jednostki.

Kod błędu: DynamicsInvalidSchemaDefinition

  • Komunikat: The valid structure information (column name and type) are required for Dynamics source.

  • Przyczyna: Kolumny ujścia w mapowaniu kolumn przegapić właściwość "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 ujścia usługi Dynamics usługa Azure Data Factory nakłada walidację na metadane atrybutu odnośnika. Istnieje jednak znany problem polegający na tym, że niektóre jednostki usługi Dynamics nie mają prawidłowych metadanych atrybutów odnośnika, które zawierają listę obiektów docelowych, co zakończy się 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ż 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ć:

Równoległa kopia w magazynie danych programu Dynamics CRM

  • Objawy: nie wiesz, czy istnieje możliwość skonfigurowania kopii równoległej w magazynie danych usługi 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 równoległością kopiowania i sekcja "Stopień równoległości kopiowania" może być ustawiona na wartość inną niż zero. Duża liczba może spowodować ograniczenie przepustowości po stronie serwera dynamics, co może zmniejszyć przepływność, ale teraz ograniczanie jest obsługiwane przez użycie publicznego zestawu SDK.

    Diagram of Degree of copy parallelism section.

Konwersja typu dynamics

  • Objawy: próbujesz przekonwertować identyfikator GUID na ciąg w źródle usługi Dynamics, ale wystąpi błąd.

  • Przyczyna: Jeśli 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ę.

Powiązana zawartość

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