Share via


Felsöka Anslutningsappar för Dynamics 365, Dataverse (Common Data Service) och Dynamics CRM i Azure Data Factory och Azure Synapse

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln innehåller förslag på hur du felsöker vanliga problem med Anslutningsprogram för Dynamics 365, Dataverse (Common Data Service) och Dynamics CRM i Azure Data Factory och Azure Synapse.

Felkod: DynamicsCreateServiceClientError

  • Meddelande: This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • Orsak: Problemet är ett tillfälligt problem på Dynamics-serversidan.

  • Rekommendation: Kör pipelinen igen. Om det misslyckas igen kan du försöka minska parallelliteten. Kontakta Dynamics-supporten om problemet kvarstår.

Kolumner saknas när du importerar ett schema eller förhandsgranskar data

  • Symptom: Vissa kolumner saknas när du importerar ett schema eller förhandsgranskningsdata. Felmeddelande: The valid structure information (column name and type) are required for Dynamics source.

  • Orsak: Det här problemet är avsiktligt eftersom Data Factory- och Synapse-pipelines inte kan visa kolumner som inte innehåller några värden i de första 10 posterna. Kontrollera att kolumnerna som du har lagt till är i rätt format.

  • Rekommendation: Lägg till kolumnerna manuellt på mappningsfliken. Mer information finns i Explicit mappning.

Felkod: DynamicsMissingTargetForMultiTargetLookupField

  • Meddelande: Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • Orsak: Målkolumnen finns inte i källan eller i kolumnmappningen.

  • Rekommendation:

    1. Kontrollera att källan innehåller målkolumnen.
    2. Lägg till målkolumnen i kolumnmappningen. Kontrollera att mottagarkolumnen har formatet {fieldName}@EntityReference.

Felkod: DynamicsInvalidTargetForMultiTargetLookupField

  • Meddelande: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • Orsak: Ett fel entitetsnamn anges som målentitet för ett uppslagsfält med flera mål.

  • Rekommendation: Ange ett giltigt entitetsnamn för uppslagsfältet med flera mål.

Felkod: DynamicsInvalidTypeForMultiTargetLookupField

  • Meddelande: The provided target type is not a valid string. Field: '%fieldName;'.

  • Orsak: Värdet i målkolumnen är inte en sträng.

  • Rekommendation: Ange en giltig sträng i kolumnen för uppslagsmål med flera mål.

Felkod: DynamicsFailedToRequetServer

  • Meddelande: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • Orsak: Dynamics-servern är otillgänglig eller otillgänglig, eller så har nätverket problem.

  • Rekommendation: Mer information finns i nätverksanslutningen eller i Dynamics Server-loggen. Kontakta Dynamics-supporten om du vill ha mer hjälp.

Felkod: DynamicsFailedTo Anslut

  • Meddelande: Failed to connect to Dynamics: %message;

  • Orsaker och rekommendationer: Olika orsaker kan leda till det här felet. Kontrollera listan nedan för möjlig orsaksanalys och relaterad rekommendation.

    Orsaksanalys Rekommendation
    Du ser ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. eller på annat sätt 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' Om ditt användningsfall uppfyller alla följande tre villkor:
  • Du ansluter till Dynamics 365, Common Data Service eller Dynamics CRM.
  • Du använder Office365-autentisering.
  • Din klient och användare är konfigurerade i Microsoft Entra-ID för villkorlig åtkomst och/eller Multi-Factor Authentication krävs (se den här länken till Dataverse-dokumentet).
  • Under dessa omständigheter lyckades anslutningen före 2021-06-08. Från och med 2021-09-09 misslyckas anslutningen på grund av utfasningen av den regionala identifieringstjänsten (se den här länken).
    Om din klient och användare har konfigurerats i Microsoft Entra-ID för villkorlig åtkomst och/eller Multi-Factor Authentication krävs måste du använda "Microsoft Entra-tjänstens huvudnamn" för att autentisera efter den 6/8/2021. Se den här länken för detaljerade steg.
    Om du ser Office 365 auth with OAuth failed i felmeddelandet innebär det att servern kanske har vissa konfigurationer som inte är kompatibla med OAuth.
  • Kontakta Dynamics supportteam med det detaljerade felmeddelandet om du vill ha hjälp.
  • Använd autentiseringen för tjänstens huvudnamn och du kan läsa den här artikeln: Exempel: Dynamics online med microsoft Entra-tjänstens huvudnamn och certifikatautentisering.
  • Om du ser Unable to retrieve authentication parameters from the serviceUri i felmeddelandet innebär det att du antingen anger fel URL för Dynamics-tjänsten eller proxy/brandvägg för att fånga upp trafiken.
  • Kontrollera att du har placerat rätt tjänst-URI i den länkade tjänsten.
  • Om du använder lokalt installerad IR kontrollerar du att brandväggen/proxyn inte fångar upp begäranden till Dynamics-servern.
  • Om du ser An unsecured or incorrectly secured fault was received from the other party i felmeddelandet innebär det att oväntade svar har hämtats från serversidan.
  • Kontrollera att ditt användarnamn och lösenord är korrekta om du använder Office 365-autentiseringen.
  • Kontrollera att du har angett rätt tjänst-URI.
  • Om du använder en regional CRM-URL (URL:en har ett tal efter crm) kontrollerar du att du använder rätt regional identifierare.
  • Kontakta Dynamics supportteam om du vill ha hjälp.
  • Om du ser No Organizations Found i felmeddelandet innebär det att antingen ditt organisationsnamn är fel eller att du har använt fel CRM-regionidentifierare i tjänstens URL.
  • Kontrollera att du har angett rätt tjänst-URI.
  • Om du använder den regionala CRM-URL:en (URL:en har ett tal efter crm) kontrollerar du att du använder rätt regional identifierare.
  • Kontakta Dynamics supportteam om du vill ha hjälp.
  • Om du ser 401 Unauthorized och Microsoft Entra-relaterade felmeddelanden innebär det att det finns ett problem med tjänstens huvudnamn. Följ riktlinjerna i felmeddelandet för att åtgärda problemet med tjänstens huvudnamn.
    För andra fel är problemet vanligtvis på serversidan. Använd XrmToolBox för att upprätta anslutning. Om felet kvarstår kontaktar du Dynamics supportteam för att få hjälp.

Felkod: DynamicsOperationFailed

  • Meddelande: Dynamics operation failed with error code: %code;, error message: %message;.

  • Orsak: Åtgärden misslyckades på serversidan.

  • Rekommendation: Extrahera felkoden för dynamics-åtgärden från felmeddelandet: Dynamics operation failed with error code: {code}och se artikeln Felkoder för webbtjänsten för mer detaljerad information. Du kan kontakta Dynamics-supportteamet om det behövs.

Felkod: DynamicsInvalidFetchXml

  • Meddelande: The Fetch Xml query specified is invalid.

  • Orsak: Det finns ett fel i XML-hämtningen.

  • Rekommendation: Åtgärda felet i xml-hämtningen.

Felkod: DynamicsMissingKeyColumns

  • Meddelande: Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • Orsak: Källdata innehåller inte nyckelkolumnen för mottagarentiteten.

  • Rekommendation: Bekräfta att nyckelkolumner finns i källdata eller mappa en källkolumn till nyckelkolumnen i mottagarentiteten.

Felkod: DynamicsPrimaryKeyMustBeGuid

  • Meddelande: The primary key attribute '%attribute;' must be of type guid.

  • Orsak: Typen av primärnyckelkolumn är inte Guid.

  • Rekommendation: Kontrollera att primärnyckelkolumnen i källdata är av typen Guid.

Felkod: DynamicsAlternateKeyNotFound

  • Meddelande: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • Orsak: Den angivna alternativa nyckeln finns inte, vilket kan orsakas av fel nyckelnamn eller otillräckliga behörigheter.

  • Rekommendation:

    • Åtgärda stavfel i nyckelnamnet.
    • Kontrollera att du har tillräcklig behörighet för entiteten.

Felkod: DynamicsInvalidSchemaDefinition

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

  • Orsak: Mottagarkolumner i kolumnmappningen missar egenskapen "typ".

  • Rekommendation: Du kan lägga till egenskapen "type" i dessa kolumner i kolumnmappningen med hjälp av JSON-redigeraren på portalen.

Felkod: UserErrorUnsupportedAttributeType

  • Meddelande: The attribute type 'Lookup' of field %attributeName; is not supported

  • Orsak: Vid inläsning av data till Dynamics-mottagare tillämpar Azure Data Factory validering på uppslagsattributets metadata. Det finns dock ett känt problem med att vissa Dynamics-entiteter inte har giltiga metadata för uppslagsattribut som innehåller en lista över mål, vilket skulle misslyckas med valideringen.

  • Rekommendation: Kontakta Dynamics supportteam för att åtgärda problemet.

Kopieringsaktiviteten från Dynamics 365 läser fler rader än det faktiska talet

  • Symptom: Kopieringsaktiviteten från Dynamics 365 läser fler rader än det faktiska talet.

  • Orsak: Dynamics 365-servern anger alltid fler tillgängliga poster.

  • Rekommendation: Använd XrmToolBox för att testa FetchXML med växling. XrmToolBox med vissa installerade verktyg kan hämta antal poster. Mer information finns i XrmToolBox.

Det går inte att komma åt virtuella kolumner från Dynamics-källor i kopieringsaktiviteten

  • Symptom: Du kan inte komma åt virtuella kolumner från Dynamics-källor i kopieringsaktiviteten.

  • Orsak: Den virtuella kolumnen stöds inte nu.

  • Rekommendation: För värdet Alternativuppsättning följer du alternativen nedan för att hämta det:

Den parallella kopian i ett Dynamics CRM-datalager

  • Symptom: Du vet inte om det är möjligt att konfigurera parallellkopian i ett Dynamics CRM-datalager, och du vet inte heller det värdeintervall som kan anges i avsnittet "Grad av kopieringsparallellitet".

  • Rekommendation: Parallellkopiering styr parallellitet och avsnittet "Grad av kopieringsparallellitet" kan anges till ett värde som inte är noll. Ett stort antal kan orsaka begränsning på Dynamics Server-sidan, vilket kan minska dataflödet, men nu hanteras begränsningen genom att ta den offentliga SDK:t.

    Diagram of Degree of copy parallelism section.

Konvertering av Dynamics-typ

  • Symptom: Du försöker konvertera GUID:et till en sträng i Dynamics-källan, men du får ett fel.

  • Orsak: När Dynamics används som källa stöds inte typkonverteringen.

  • Rekommendation: Aktivera mellanlagring och försök igen.

Om du vill ha mer felsökningshjälp kan du prova dessa resurser: