Condividi tramite

Risolvere i problemi relativi ai connettori Dynamics 365, Dataverse (Common Data Service) e Dynamics CRM in Azure Data Factory e Azure Synapse

  • Articolo

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

Questo articolo fornisce suggerimenti per risolvere i problemi comuni relativi ai connettori Dynamics 365, Dataverse (Common Data Service) e Dynamics CRM in Azure Data Factory e Azure Synapse.

Codice errore: DynamicsCreateServiceClientError

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

  • Causa: il problema è temporaneo ed è sul lato server Dynamics.

  • Raccomandazione: Eseguire di nuovo la pipeline. Se il problema persiste, provare a ridurre il parallelismo. Se il problema persiste, contattare il supporto tecnico di Dynamics.

Colonne mancanti quando si importano uno schema o i dati di anteprima

  • Sintomi: alcune colonne mancano quando si importano uno schema o i dati di anteprima. Messaggio di errore: The valid structure information (column name and type) are required for Dynamics source.

  • Causa: questo problema è normale, perché le pipeline di Data Factory e Synapse non sono in grado di visualizzare colonne che non contengono valori nei primi 10 record. Assicurarsi che le colonne aggiunte siano nel formato corretto.

  • Raccomandazione: aggiungere manualmente le colonne nella scheda mapping. Per altri dettagli, vedere Mapping esplicito.

Codice errore: DynamicsMissingTargetForMultiTargetLookupField

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

  • Causa: la colonna di destinazione non esiste nell'origine o nel mapping delle colonne.

  • Raccomandazione:

    1. Assicurarsi che l'origine contenga la colonna di destinazione.
    2. Aggiungere la colonna di destinazione nel mapping di colonne. Assicurarsi che la colonna sink sia nel formato {fieldName}@EntityReference.

Codice errore: DynamicsInvalidTargetForMultiTargetLookupField

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

  • Causa: un nome di entità errato viene fornito come entità di destinazione di un campo di ricerca a più entità.

  • Raccomandazione: specificare un nome di entità valido per il campo di ricerca a più entità.

Codice errore: DynamicsInvalidTypeForMultiTargetLookupField

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

  • Causa: il valore nella colonna di destinazione non è una stringa.

  • Raccomandazione: specificare una stringa valida nella colonna di destinazione di ricerca multi target.

Codice errore: DynamicsFailedToRequetServer

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

  • Causa: il server Dynamics è instabile o inaccessibile oppure si verificano problemi di rete.

  • Raccomandazione: per altri dettagli, controllare la connettività di rete o controllare il log del server Dynamics. Per altre informazioni, contattare il supporto tecnico di Dynamics.

Codice errore: DynamicsFailedToConnect

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

  • Cause e raccomandazioni: cause diverse possono causare questo errore. Controllare l'elenco di seguito per un’analisi delle possibili cause e raccomandazioni correlate.

    Analisi delle cause Elemento consigliato
    Viene visualizzato ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. o in caso contrario 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' Se il caso d'uso soddisfa tutte le tre condizioni seguenti:
  • Ci si connette a Dynamics 365, Common Data Service o Dynamics CRM.
  • Si usa l'autenticazione di Office365.
  • Il tenant e l'utente sono configurati in Microsoft Entra ID per l'accesso condizionale e/o l’autenticazione a più fattori (vedere questo collegamento alla documentazione dataverse).
    • In queste circostanze, la connessione usata per avere esito positivo prima dell'08/06/2021. A partire dal 09/06/2021, la connessione inizierà a riscontrare errori a causa della deprecazione del servizio di individuazione a livello di area (vedere questo collegamento).    		 Se il tenant e l'utente sono configurati in Microsoft Entra ID per l'accesso condizionale e/o Multi-Factor Authentication, è necessario usare l'entità servizio Microsoft Entra per eseguire l'autenticazione dopo il 06/08/2021. Fare riferimento a questo collegamento per i passaggi dettagliati.
    Se viene visualizzato Office 365 auth with OAuth failed nel messaggio di errore, significa che il server potrebbe avere alcune configurazioni non compatibili con OAuth.
  • Contattare il team di supporto di Dynamics con il messaggio di errore dettagliato per assistenza.
  • Usare l'autenticazione dell'entità servizio ed è possibile fare riferimento a questo articolo: Esempio: Dynamics online usando l'entità servizio Microsoft Entra e l'autenticazione del certificato.
    		•
    Se viene visualizzato Unable to retrieve authentication parameters from the serviceUri nel messaggio di errore, significa che si inserisce l'URL del servizio Dynamics errato o proxy/firewall per intercettare il traffico.
  • Assicurarsi di aver inserito l'URI del servizio corretto nel servizio collegato.
  • Se si usa il runtime di integrazione self-hosted, assicurarsi che il firewall o il proxy non intercetti le richieste al server Dynamics.
    		•
    Se viene visualizzato An unsecured or incorrectly secured fault was received from the other party nel messaggio di errore, significa che le risposte impreviste sono state ottenute dal lato server.
  • Assicurarsi che il nome utente e la password siano corretti se si usa l'autenticazione di Office 365.
  • Assicurarsi di avere immesso l'URI del servizio corretto.
  • Se si usa l'URL CRM regionale (nell'URL c’è un numero dopo 'crm'), assicurarsi di usare l'identificatore di area corretto.
  • Per assistenza, contattare il team di supporto di Dynamics.
    		•
    Se viene visualizzato No Organizations Found nel messaggio di errore, significa che il nome dell'organizzazione non è corretto o è stato usato un identificatore di area CRM errato nell'URL del servizio.
  • Assicurarsi di avere immesso l'URI del servizio corretto.
  • Se si usa l'URL CRM regionale (l'URL ha un numero dopo 'crm'), assicurarsi di usare l'identificatore di area corretto.
  • Per assistenza, contattare il team di supporto di Dynamics.
    		•
    Se viene visualizzato 401 Unauthorized e il messaggio di errore correlato a Microsoft Entra, significa che si è verificato un problema con l'entità servizio. Seguire le indicazioni nel messaggio di errore per risolvere il problema dell'entità servizio.
    Per altri errori, in genere il problema è lato server. Usare XrmToolBox per stabilire una connessione. Se l'errore persiste, contattare il team di supporto di Dynamics per assistenza.

Codice errore: DynamicsOperationFailed

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

  • Causa: l'operazione non è riuscita sul lato server.

  • Raccomandazione: estrarre il codice di errore dell'operazione Dynamics dal messaggio di errore: Dynamics operation failed with error code: {code}e fare riferimento all'articolo Codici errore del servizio Web per informazioni più dettagliate. Se necessario, contattare il team di supporto di Dynamics.

Codice errore: DynamicsInvalidFetchXml

  • Messaggio: The Fetch Xml query specified is invalid.

  • Causa: esiste un errore nel codice XML di recupero.

  • Raccomandazione: correggere l'errore nel codice XML di recupero.

Codice errore: DynamicsMissingKeyColumns

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

  • Causa: i dati di origine non contengono la colonna chiave per l'entità sink.

  • Raccomandazione: verificare che le colonne chiave si trovino nei dati di origine o eseguire il mapping di una colonna di origine alla colonna chiave nell'entità sink.

Codice errore: DynamicsPrimaryKeyMustBeGuid

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

  • Causa: il tipo della colonna chiave primaria non è 'Guid'.

  • Raccomandazione: assicurarsi che la colonna chiave primaria nei dati di origine sia di tipo 'Guid'.

Codice errore: DynamicsAlternateKeyNotFound

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

  • Causa: la chiave alternativa specificata non esiste; questo può essere causato da nomi di chiave errati o autorizzazioni insufficienti.

  • Raccomandazione:

    • Correggere gli errori di digitazione nel nome della chiave.
    • Assicurarsi di disporre di autorizzazioni sufficienti per l'entità.

Codice errore: DynamicsInvalidSchemaDefinition

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

  • Causa: le colonne sink nel mapping delle colonne non hanno la proprietà 'type'.

  • Raccomandazione: è possibile aggiungere la proprietà 'type' a tali colonne nel mapping delle colonne usando l'editor JSON nel portale.

Codice errore: UserErrorUnsupportedAttributeType

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

  • Causa: quando si caricano dati nel sink Dynamics, Azure Data Factory impone la convalida sui metadati dell'attributo di ricerca. Tuttavia, esiste il problema noto di alcune entità Dynamics che non hanno metadati di attributo di ricerca validi che contengono un elenco di destinazioni, che non riuscirebbero alla convalida.

  • Raccomandazione: contattare il team di supporto di Dynamics per mitigare il problema.

L'attività Copy di Dynamics 365 legge più righe del numero effettivo

  • Sintomi: l'attività Copy di Dynamics 365 legge più righe del numero effettivo.

  • Causa: il server Dynamics 365 indica sempre più record disponibili.

  • Raccomandazione: usare XrmToolBox per testare FetchXML con il paging. XrmToolBox con alcuni strumenti installati può ottenere il conteggio dei record. Per altre informazioni, vedere XrmToolBox.

Impossibile accedere alle colonne virtuali dalle origini Dynamics nell'attività di copia

  • Sintomi: non è possibile accedere alle colonne virtuali dalle origini Dynamics nell'attività di copia.

  • Causa: la colonna virtuale non è ora supportata.

  • Raccomandazione: seguire le opzioni seguenti per ottenere il valore del set di opzioni:

Copia parallela in un archivio dati Dynamics CRM

  • Sintomi: non si sa se è possibile configurare la copia parallela in un archivio dati Dynamics CRM e non si conosce anche l'intervallo di valori che è possibile impostare nella sezione "Degree of copy parallelism".

  • Raccomandazione: la copia parallela controlla il parallelismo e la sezione "Grado di parallelismo copia" può essere impostata su un valore diverso da zero. Un numero elevato può causare limitazioni sul lato server dynamics, che può ridurre la velocità effettiva, ma ora la limitazione viene gestita usando l'SDK pubblico.

    Diagramma della sezione Grado di parallelismo della copia.

Conversione dei tipi Dynamics

  • Sintomi: si tenta di convertire il GUID in una stringa nell'origine Dynamics, ma si verifica un errore.

  • Causa: quando Dynamics viene usato come origine, la conversione del tipo non è supportata.

  • Raccomandazione: abilitare la gestione temporanea e riprovare.

Contenuto correlato

Per altre informazioni sulla risoluzione dei problemi, usare le risorse seguenti: