Compartir vía

Solución de problemas relacionados con conectores 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 indica cómo solucionar problemas relacionados con conectores en Azure Data Factory y Azure Synapse Analytics.

Problemas específicos del conector

Puede consultar las páginas de solución de problemas de cada conector para ver sus problemas específicos con explicaciones de sus causas y recomendaciones para resolverlos.

Errores generales de la actividad de copia

Los errores siguientes son generales para la actividad de copia y podrían producirse con cualquier conector.

Código de error: 2200

  • Mensaje: The underlying connection was closed: An unexpected error occurred on a send.

  • Causa: normalmente indica un error de autenticación durante las operaciones de transferencia de datos. Esto puede ocurrir cuando la entidad remota cierra la secuencia de transporte.

  • Recomendación:

    • compruebe la conexión de origen y pruébela para asegurarse de que funciona correctamente.
    • Compruebe el método de autenticación usado para la conexión.
    • Revise los valores de configuración del firewall de Azure Cosmos DB para asegurarse de que permiten el tráfico necesario.

Código de error: 20000

  • Mensaje: Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.

  • Causa: El entorno de ejecución de integración autohospedado no encuentra Java Runtime, y es necesario para leer orígenes específicos.

  • Recomendación: Compruebe el entorno de ejecución de integración en Uso del entorno de ejecución de integración autohospedado.

Código de error: 20002

  • Mensaje: An error occurred when invoking Java Native Interface.

  • Causa: si el mensaje de error contiene "No se puede crear JVM: Código de retorno JNI [-6][Error en la llamada JNI: Argumentos no válidos.], la posible causa es que JVM no se puede crear porque algunos argumentos ilegales (globales) se establecen.

  • Recomendación: inicie sesión en la máquina que hospeda cada nodo del entorno de ejecución de integración autohospedado. Asegúrese de que la variable del sistema esté configurada correctamente, como se indica a continuación: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Reinicie todos los nodos del entorno de ejecución de integración y vuelva a ejecutar la canalización.

Código de error: 20020

  • Mensaje: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

  • Causa: El conjunto de datos de receptor no admite caracteres comodín.

  • Recomendación: Compruebe el conjunto de datos de receptor y escriba de nuevo la ruta de acceso sin caracteres comodín.

Problema de PFIPS

  • Síntomas: Se produce un error en la actividad de copia en la máquina del entorno de ejecución de integración autohospedado habilitado para FIPS con el mensaje de error siguiente: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

  • Causa: Este error puede producirse al copiar datos con conectores como Azure Blob, SFTP, etc. El Estándar federal de procesamiento de información (FIPS) define un determinado conjunto de algoritmos criptográficos que se pueden usar. Cuando se habilita el modo FIPS en el equipo, algunas clases criptográficas de las que depende la actividad se bloquean en algunos escenarios.

  • Resolución: obtenga información por qué ya no se recomienda "Modo FIPS", y evalúe si puede deshabilitar FIPS en su máquina de IR autohospedada.

    Como alternativa, si solo desea omitir FIPS y hacer que las ejecuciones de actividad se realicen correctamente, siga estos pasos:

    1. Abra la carpeta donde está instalado el entorno de ejecución de integración autohospedado. La ruta de acceso suele ser C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.

    2. Abra el archivo diawp.exe.config y, luego, al final de la sección <runtime>, agregue <enforceFIPSPolicy enabled="false"/>, como se muestra aquí:

      Captura de pantalla de una sección del archivo diawp.exe.config que muestra FIPS deshabilitado.

    3. Guarde el archivo y, luego, reinicie la máquina del entorno de ejecución de integración autohospedado.

Código de error: 20150

  • Mensaje: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

  • Causa: el id. de cliente o el secreto de cliente no son válidos y la autenticación no se pudo completar en el servidor de autorización.

  • Recomendación: corrija toda la configuración del flujo de credenciales de cliente de OAuth2 del servidor de autorización.

Código de error: 20151

  • Mensaje: Failed to get access token from your token endpoint. Error message: %errorMessage;.

  • Causa: la configuración del flujo de credenciales de cliente de OAuth2 no es válida.

  • Recomendación: corrija toda la configuración del flujo de credenciales de cliente de OAuth2 del servidor de autorización.

Código de error: 20152

  • Mensaje: The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

  • Causa: no se admite el servidor de autorización.

  • Recomendación: use un servidor de autorización que pueda devolver tokens con tipos de token admitidos.

Código de error: 20153

  • Mensaje: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

  • Causa: el id. de cliente incluye el carácter de dos puntos no válido (:).

  • Recomendación: use un id. de cliente válido.

Código de error: 20523

  • Mensaje: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • Recomendación: compruebe la versión admitida y actualice el entorno de ejecución de integración a una versión superior.

Código de error: 20551

  • Mensaje: The format settings are missing in dataset %dataSetName;.

  • Causa: el tipo de conjunto de datos es Binary, que no se admite.

  • Recomendación: use el conjunto de datos DelimitedText, Json, Avro, Orc o Parquet en su lugar.

  • Causa: para el almacenamiento de archivos, falta la configuración de formato en el conjunto de datos.

  • Recomendación: anule la selección de "Copia binaria" en el conjunto de datos y establezca la configuración de formato correcta.

Código de error: 20552

  • Mensaje: The command behavior "%behavior;" is not supported.

  • Recomendación: no agregue el comportamiento del comando como parámetro para la dirección URL de solicitud de la API de GetSchema o la versión preliminar.

Código de error: 20701

  • Mensaje: Failed to retrieve source file ('%name;') metadata to validate data consistency.

  • Causa: no se permite un problema transitorio en el almacén de datos receptor o la recuperación de metadatos del almacén de datos receptor.

Código de error: 20703

  • Mensaje: Failed to retrieve sink file ('%name;') metadata to validate data consistency.

  • Causa: no se permite un problema transitorio en el almacén de datos receptor o la recuperación de metadatos del almacén de datos receptor.

Código de error: 20704

  • Mensaje: Data consistency validation is not supported in current copy activity settings.

  • Causa: la validación de coherencia de datos solo se admite en el escenario de copia binaria directa.

  • Recomendación: quite la propiedad "validateDataConsistency" en la carga de la actividad de copia.

Código de error: 20705

  • Mensaje: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • Recomendación: compruebe la versión admitida del entorno de ejecución de integración y actualícela a una versión posterior, o bien quite la propiedad "validateDataConsistency" de las actividades de copia.

Código de error: 20741

  • Mensaje: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • Recomendación: quite "fileMissing" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20742

  • Mensaje: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.

  • Recomendación: quite "dataInconsistency" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20743

  • Mensaje: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • Recomendación: quite "fileForbidden" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20744

  • Mensaje: Skip forbidden file is not supported for this connector: ('%connectorName;').

  • Recomendación: quite "fileForbidden" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20745

  • Mensaje: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • Recomendación: quite "invalidFileName" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20746

  • Mensaje: Skip invalid file name is not supported for '%connectorName;' source.

  • Recomendación: quite "invalidFileName" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20747

  • Mensaje: Skip invalid file name is not supported for '%connectorName;' sink.

  • Recomendación: quite "invalidFileName" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20748

  • Mensaje: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

  • Recomendación: quite "allErrorFile" del parámetro skipErrorFile en la carga de la actividad de copia.

Código de error: 20771

  • Mensaje: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

  • Recomendación: quite el parámetro "deleteFilesAfterCompletion" o use la copia binaria directa.

Código de error: 20772

  • Mensaje: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

  • Recomendación: quite el parámetro "deleteFilesAfterCompletion" en la carga de la actividad de copia.

Código de error: 27002

  • Mensaje: Failed to download custom plugins.

  • Causa: los vínculos de descarga no son válidos o hay problemas de conectividad transitorios.

  • Recomendación: vuelva a intentar la operación si el mensaje muestra que se trata de un problema transitorio. Si el problema persiste, póngase en contacto con el equipo de soporte técnico.

Errores generales del conector

Código de error: 9611

  • Mensaje: The following ODBC Query is not valid: '%'.

  • Causa: se proporciona una consulta incorrecta o no válida para capturar los datos o esquemas.

  • Recomendación: compruebe que la consulta es válida y puede devolver datos o esquemas. Use Actividad de script si desea ejecutar scripts que no son de consulta y se admite el almacén de datos. Como alternativa, considere la posibilidad de usar el procedimiento almacenado que devuelve un resultado ficticio para ejecutar los scripts que no son de consulta.

Código de error: 11775

  • Mensaje: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

  • Causa: La causa exacta depende del texto devuelto en '%'. Si es La operación ha agotado el tiempo de espera, puede deberse a que la instancia de PostgreSQL se detiene o porque el método de conectividad de red configurado para la instancia no permite conexiones desde Integration Runtime seleccionado. El usuario o la contraseña proporcionados son incorrectos. Si es 28P01: error de autenticación de contraseña para el usuario <el usuario>, significa que el usuario proporcionado no existe en la instancia o que la contraseña es incorrecta. Si es 28000: no pg_hba.conf entry for host "##.#.##.##.#", usuario "<youruser>", database "<yourdatabase>", sin cifrado, significa que el método de cifrado seleccionado no es compatible con la configuración del servidor.

  • Recomendación: confirme que el usuario proporcionado existe en la instancia de PostgreSQL y que la contraseña corresponde a la asignada actualmente a ese usuario. Asegúrese de que la instancia de PostgreSQL acepta el método de cifrado seleccionado, en función de su configuración actual. Si el método de conectividad de red de la instancia está configurado para el acceso privado (integración de red virtual), use un entorno de ejecución de integración autohospedado (IR) para conectarse a ella. Si está configurado para el acceso público (direcciones IP permitidas), se recomienda usar una instancia de Azure IR con una red virtual administrada e implementar un punto de conexión privado administrado para conectarse a la instancia. Cuando está configurado para el acceso público (direcciones IP permitidas), una alternativa menos recomendada consiste en crear reglas de firewall en la instancia para permitir el tráfico que se origina en las direcciones IP que usa Azure IR.

Contenido relacionado

Para obtener ayuda para solucionar problemas, pruebe estos recursos: