Felsöka Dynamics 365-, Dataverse- och Dynamics CRM-kontakter i Azure Data Factory och Azure Synapse

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

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

Felkod: DynamicsCreateServiceClientError

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

• Cause: 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. Om problemet kvarstår kontaktar du Dynamics support.

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 textsträng i kolumnen för flerfunktionsuppslag.

Felkod: DynamicsFailedToRequestServer

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

• Cause: Dynamics-servern är inte tillgänglig eller så har nätverket problem.

• Recommendation: För mer information, kontrollera nätverksanslutningen eller kontrollera Dynamics-serverloggen. Kontakta supporten för Dynamics om du vill ha mer hjälp.

Felkod: DynamicsFailedToConnect

• Message: 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 av följande tre villkor: Du ansluter till Dynamics 365, Common Data Service eller Dynamics CRM. Du använder Office365-autentisering. Hyresgästen och användaren konfigureras i Microsoft Entra ID för villkorlig åtkomst och/eller multifaktorautentisering krävs (se den här länken till Dataverse-dokumentet). Anslutningen lyckades under dessa omständigheter före 2021-06-08. Från och med 2021-06-09 börjar anslutningen misslyckas på grund av utfasningen av den regionala identifieringstjänsten (se den här länken).	Om din klientorganisation och användare har konfigurerats i Microsoft Entra ID för konditionell åtkomst och/eller om multifaktorautentisering krävs, måste du använda 'Microsoft Entra tjänstens huvudprincip' för att autentisera efter 2021-06-08. 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 supportteamet med det detaljerade felmeddelandet om du vill ha hjälp. Använd autentisering med 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 Dynamics tjänst-URL 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 autentisering. 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 supportteamet för Dynamics 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 supportteamet för Dynamics om du vill ha hjälp.
  Om du ser 401 Unauthorized och Microsoft Entra-relaterade felmeddelande innebär det att det finns ett problem med tjänstens principal.	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. Kontakta supportteamet för Dynamics om felet kvarstår.

Felkod: DynamicsOperationFailed

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

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

• Recommendation: Extrahera felkoden för åtgärden dynamics från felmeddelandet: Dynamics operation failed with error code: {code} och se artikeln Web service error codes för mer detaljerad information. Du kan kontakta supportteamet för Dynamics 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 på primärnyckelkolumnen ä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

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

• Orsak: Mottagarkolumner i kolumnmappningen saknar 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

• Cause: När data läses in till Dynamics-sink, tillämpar Azure Data Factory en validering på uppslagsattributens metadata. Det finns dock ett känt problem med vissa Dynamics entiteter som inte har giltiga metadata för uppslagsattribut som innehåller en lista över mål, vilket skulle misslyckas med valideringen.

• Recommendation: Kontakta supportteamet för Dynamics för att åtgärda problemet.

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

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

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

• Rekommendation: Använd XrmToolBox för att testa FetchXML med paginering. 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

• Symptoms: 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 Option Set, följ alternativen nedan för att hämta det:

  • Du kan länka StringMap-entiteten till målentiteten och hämta de associerade värdena.

Den parallella kopian i ett Dynamics CRM-datalager

• Symptoms: Du vet inte om det är möjligt att konfigurera parallellkopian i ett Dynamics CRM-datalager, och du vet inte heller det intervall med värden 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 förfrågningar kan orsaka begränsning på Dynamics Server-sidan, vilket kan minska genomströmningen, men nu hanteras begränsningen genom att använda det publika SDK.

  

Dynamics-typekonvertering

• Symptoms: Du försöker konvertera GUID:t till en sträng i Dynamics källa, men du får ett fel.

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

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

Relaterat innehåll

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

• Felsökningsguide för kontakter
• Data Factory-bloggen
• Data Factory-funktionsbegäranden
• Azure videor
• Microsoft Q&A sida
• Stack Overflow-forum för Data Factory
• X-information om Data Factory