Solución de problemas de los conectores Dynamics 365, Dataverse (Common Data Service) y Dynamics CRM en Azure Data Factory y Azure Synapse

SE APLICA A: Azure Data Factory Azure Synapse Analytics

En este artículo se proporcionan sugerencias para solucionar problemas comunes con los conectores de Dynamics 365, Dataverse (Common Data Service) y Dynamics CRM en Azure Data Factory y Azure Synapse.

Código de error: DynamicsCreateServiceClientError

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

• Cause: el problema es un problema transitorio en el lado del servidor de Dynamics.

• Recomendación: vuelva a ejecutar la canalización. Si sigue sin funcionar, intente reducir el paralelismo. Si el problema persiste, póngase en contacto con Dynamics soporte técnico.

Faltan columnas al importar un esquema u obtener una vista previa de los datos

• Síntomas: Faltan algunas columnas al importar un esquema u obtener una vista previa de los datos. Mensaje de error: The valid structure information (column name and type) are required for Dynamics source.

• Causa: Este problema ocurre por diseño, ya que las canalizaciones de Data Factory y Synapse no pueden mostrar las columnas que no contienen valores en los primeros 10 registros. Asegúrese de que las columnas que ha agregado tengan el formato correcto.

• Recomendación: agregue manualmente las columnas en la pestaña de asignación. Para obtener más información, vea Asignación explícita.

Código de error: DynamicsMissingTargetForMultiTargetLookupField

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

• Causa: La columna de destino no existe en el origen o en la asignación de columnas.

• Recomendación:

  1. Asegúrese de que el origen contenga la columna de destino.
  2. Agregue la columna de destino en el mapa de columnas. Asegúrese de que la columna de receptor tenga el formato {fieldName}@EntityReference.

Código de error: DynamicsInvalidTargetForMultiTargetLookupField

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

• Causa: Se ha proporcionado un nombre de entidad incorrecto como entidad de destino de un campo de búsqueda de varios destinos.

• Recomendación: Proporcione un nombre de entidad válido para el campo de búsqueda de varios destinos.

Código de error: DynamicsInvalidTypeForMultiTargetLookupField

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

• Causa: El valor de la columna de destino no es una cadena.

• Recomendación: Proporcione una cadena válida en la columna de destino de búsqueda de varios destinos.

Código de error: DynamicsFailedToRequestServer

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

• Cause: el servidor de Dynamics es inestable o inaccesible, o la red está experimentando problemas.

• Recommendation: para obtener más detalles, compruebe la conectividad de red o compruebe el registro del servidor Dynamics. Para obtener más ayuda, póngase en contacto con el soporte técnico de Dynamics.

Código de error: DynamicsFailedToConnect

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

• Causas y recomendaciones: diversas causas pueden provocar este error. Busque en la lista siguiente el análisis de las posibles causas y la recomendación relacionada.

  Análisis de las causas	Recomendación
  Aparece ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. o, en 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', si el caso de uso cumple todas las condiciones siguientes: Se conecta a Dynamics 365, Common Data Service o Dynamics CRM. Usa la autenticación de Office365. El inquilino y el usuario están configurados en Microsoft Entra ID para acceso condicional y/o autenticación multifactor (consulte este enlace a la documentación de Dataverse). En estas circunstancias, la conexión solía tener éxito antes del 6/8/2021. A partir del 9/6/2021, la conexión comenzará a fallar debido a la desactivación del servicio de detección regional (consulte este vínculo).	Si su organización y el usuario están configurados en Microsoft Entra ID para acceso condicional y/o se requiere autenticación multifactor, debe usar 'Microsoft Entra service principal' para autenticarse después del 8/6/2021. Consulte este vínculo para obtener pasos detallados.
  Si ve Office 365 auth with OAuth failed en el mensaje de error, significa que el servidor podría tener algunas configuraciones no compatibles con OAuth.	Póngase en contacto con el equipo de soporte técnico de Dynamics con el mensaje de error detallado para obtener ayuda. Use la autenticación de entidad de servicio; puede consultar este artículo: Ejemplo: Dynamics Online con la entidad de servicio de Microsoft Entra y la autenticación de certificados.
  Si ve Unable to retrieve authentication parameters from the serviceUri en el mensaje de error, significa que ha introducido incorrectamente la dirección URL del servicio Dynamics o que hay un proxy/firewall configurado para interceptar el tráfico.	Asegúrese de haber indicado el URI de servicio correcto en el servicio vinculado. Si usa el IR autohospedado, asegúrese de que el firewall o proxy no intercepten las solicitudes a Dynamics Server.
  Si aparece An unsecured or incorrectly secured fault was received from the other party en el mensaje de error, se han obtenido respuestas inesperadas del lado servidor.	Asegúrese de que el nombre de usuario y la contraseña sean correctos si usa la autenticación de Office 365. Asegúrese de haber escrito el URI de servicio correcto. Si usa la dirección URL de CRM regional (la dirección URL tiene un número después de "crm"), asegúrese de usar el identificador regional correcto. Póngase en contacto con el equipo de soporte técnico de Dynamics para obtener ayuda.
  Si aparece No Organizations Found en el mensaje de error, el nombre de la organización es incorrecto o ha usado un identificador de región de CRM incorrecto en la dirección URL del servicio.	Asegúrese de haber escrito el URI de servicio correcto. Si usa la dirección URL de CRM regional (la dirección URL tiene un número después de "crm"), asegúrese de usar el identificador regional correcto. Póngase en contacto con el equipo de soporte técnico de Dynamics para obtener ayuda.
  Si aparece 401 Unauthorized y un mensaje de error relacionado con Microsoft Entra, hay un problema con la entidad de servicio.	Siga las instrucciones del mensaje de error para corregir el problema de la entidad de servicio.
  Para otros errores, el problema suele encontrarse en el lado servidor.	Use XrmToolBox para establecer la conexión. Si el error persiste, póngase en contacto con el equipo de soporte técnico de Dynamics para obtener ayuda.

Código de error: DynamicsOperationFailed

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

• Causa: Error en la operación en el lado servidor.

• Recomendación: extraiga el código de error de la operación de Dynamics que aparece en el mensaje de error: Dynamics operation failed with error code: {code}, y consulte el artículo Códigos de error de servicio web para obtener información más detallada. Si es necesario, puede ponerse en contacto con el equipo de soporte técnico de Dynamics.

Código de error: "DynamicsInvalidFetchXml"

• Mensaje: The Fetch Xml query specified is invalid.

• Causa: Existe un error en el XML de captura.

• Recomendación: Corrija el error en el XML de captura.

Código de error: DynamicsMissingKeyColumns

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

• Causa: Los datos de origen no contienen la columna de clave para la entidad receptora.

• Recomendación: Confirme que las columnas de clave estén en los datos de origen o asigne una columna de origen a la columna de clave de la entidad receptora.

Código de error: DynamicsPrimaryKeyMustBeGuid

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

• Causa: el tipo de la columna de clave principal no es "Guid".

• Recomendación: Asegúrese de que la columna de clave principal de los datos de origen sea de tipo "Guid".

Código de error: DynamicsAlternateKeyNotFound

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

• Causa: La clave alternativa proporcionada no existe, lo que podría deberse a nombres de clave incorrectos o permisos insuficientes.

• Recomendación:
  

  • Corrija los errores tipográficos en el nombre de clave.
    
  • Asegúrese de tener permisos suficientes en la entidad.

Código de error: DynamicsInvalidSchemaDefinition

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

• Causa: Falta la propiedad "type" en las columnas receptoras de la asignación de columnas.

• Recomendación: puede agregar la propiedad "type" a esas columnas de la asignación de columnas mediante el editor JSON en el portal.

Código del error: UserErrorUnsupportedAttributeType

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

• Causa: al cargar los datos en el receptor de Dynamics, Azure Data Factory impone la validación en los metadatos del atributo de búsqueda. Sin embargo, hay el problema conocido de ciertas entidades Dynamics que no tienen metadatos de atributo de búsqueda válidos que contiene una lista de destinos, lo que produciría un error en la validación.

• Recommendation: póngase en contacto con el equipo de soporte técnico de Dynamics para mitigar el problema.

La actividad de copia de Dynamics 365 lee más filas que el número real

• Síntomas: la actividad de copia de Dynamics 365 lee más filas que el número real.

• Cause: el servidor de Dynamics 365 siempre indica más registros disponibles.

• Recomendación: Use XrmToolBox para probar FetchXML con paginación. XrmToolBox con algunas herramientas instaladas puede obtener el recuento de registros. Para obtener más información, vea XrmToolBox.

No se puede acceder a columnas virtuales desde orígenes de Dynamics en la actividad de copia

• Síntomas: no se puede acceder a columnas virtuales desde orígenes de Dynamics en la actividad de copia.

• Causa: la columna virtual no se admite ahora.

• Recomendación: para el valor Conjunto de opciones, siga las opciones siguientes para obtenerlo:

  • Puede vincular la entidad StringMap a la entidad de destino y obtener los valores asociados.

Copia paralela en un almacén de datos de CRM de Dynamics

• Symptoms: No sabe si es posible configurar la copia en paralelo en un almacén de datos crm de Dynamics y tampoco conoce el intervalo de valores que se pueden establecer en la sección "Grado de paralelismo de copia".

• Recomendación: la copia paralela controla el paralelismo y la sección "Grado de paralelismo de copia" se puede establecer en un valor distinto de cero. Un número grande puede provocar una limitación en el lado de Dynamics Server, lo que puede reducir el rendimiento, pero ahora la limitación se controla mediante la toma del SDK público.

  

Conversión de tipos en Dynamics

• Symptoms: Intentas convertir el GUID en una cadena en el origen de Dynamics, pero se produce un error.

• Cause: cuando se usa Dynamics como origen, no se admite la conversión de tipos.

• Recomendación: habilite el entorno de pruebas y vuelva a intentarlo.

Contenido relacionado

Para obtener ayuda para solucionar problemas, pruebe estos recursos:

• Guía de solución de problemas de conectores
• Blog de Data Factory
• Solicitud de características de Data Factory
• vídeos de Azure
• Página de Preguntas y Respuestas de Microsoft
• Foro de Stack Overflow para Data Factory
• Información de X acerca de Data Factory