Compartir a través de

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

  • Artículo

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

En este artículo se proporcionan sugerencias para solucionar problemas comunes con los conectores 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.

  • Causa: Se trata de un problema transitorio en el 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 el servicio de soporte técnico de Dynamics.

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 es así por naturaleza, ya que las canalizaciones de Data Factory y Synapse no puede mostrar las columnas que no contienen valores en los 10 primeros registros. Asegúrese de que las columnas que ha agregado tengan el formato correcto.

  • Recomendación: Agregue manualmente las columnas en la pestaña asignación. Para obtener más información, consulte 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 la asignación 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.

  • Causa: El servidor de Dynamics es inestable o no es accesible, o bien en la red se experimentan problemas.

  • Recomendación: Para conocer los detalles, compruebe la conectividad de red o el registro del servidor de Dynamics. Si necesita ayuda adicional, 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 va a conectar a Dynamics 365, Common Data Service o Dynamics CRM.
  • Va a usar la autenticación de Office365.
  • El inquilino y el usuario están configurados en Microsoft Entra ID para el acceso condicional, o bien si la autenticación multifactor es necesaria (consulte este vínculo para ver la documentación de Dataverse).
    • En estas circunstancias, la conexión que se use funcionará correctamente hasta el 8/6/2021. A partir del 9/6/2021, la conexión comenzará a producir un error debido al desuso del servicio de detección regional (consulte este vínculo).    		 Si el inquilino y el usuario están configurados en Microsoft Entra ID para el acceso condicional, o bien, si la autenticación multifactor es necesaria, deberá utilizar una "entidad de servicio de Microsoft Entra" para autenticarse después del 8/6/2021. Consulte este vínculo para obtener pasos detallados.
    Si aparece Office 365 auth with OAuth failed en el mensaje de error, es posible que el servidor tenga algunas configuraciones no compatibles con OAuth.
  • Para obtener ayuda, póngase en contacto con el equipo de soporte técnico de Dynamics con el mensaje de error detallado.
  • Use la autenticación de entidad de servicio; puede consultar este artículo: Ejemplo: Dynamics en línea con la entidad de servicio de Microsoft Entra y la autenticación de certificados.
    		•
    Si aparece Unable to retrieve authentication parameters from the serviceUri en el mensaje de error, puede que haya escrito una dirección URL de servicio de Dynamics incorrecta o aplicado un proxy o firewall 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 al servidor de Dynamics.
    		•
    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.
  • Para obtener ayuda, póngase en contacto con el equipo de soporte técnico de Dynamics.
    		•
    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.
  • Para obtener ayuda, póngase en contacto con el equipo de soporte técnico de Dynamics.
    		•
    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 puede 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 de 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, se encuentra el problema conocido de determinadas entidades de 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.

  • Recomendación: 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.

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

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

  • Síntomas: no sabe si es posible configurar la copia en paralelo en un almacén de datos de Dynamics CRM 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 servidor de Dynamics, lo que puede reducir el rendimiento, pero ahora la limitación se controla mediante la toma del SDK público.

    Diagrama de la sección Grado de paralelismo de copia.

Conversión de tipos de Dynamics

  • Síntomas: intenta 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 almacenamiento provisional y vuelva a intentarlo.

Contenido relacionado

Para obtener ayuda para solucionar problemas, pruebe estos recursos: