Solución de problemas relacionados con conectores en Azure Data Factory y Azure Synapse Analytics
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.
- Azure Blob Storage
- Azure Cosmos DB (incluido el conector de Azure Cosmos DB for NoSQL)
- Azure Data Lake (Gen1 y Gen2)
- Azure Database para PostgreSQL
- Almacenamiento de Azure Files
- Azure Synapse Analytics, Azure SQL Database, y SQL Server
- DB2
- Formato de texto delimitado
- Dynamics 365, Dataverse (Common Data Service) y Dynamics CRM
- FTP, SFTP y HTTP
- Hive
- Oracle
- Formato ORC
- Formato Parquet
- REST
- Salesforce y Salesforce Service Cloud
- Lista de SharePoint Online
- Formato XML
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: 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:
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.
Abra el archivo diawp.exe.config y, luego, al final de la sección
<runtime>
, agregue<enforceFIPSPolicy enabled="false"/>
, como se muestra aquí: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: