Solución de problemas relacionados con conectores en Azure Data Factory y Azure Synapse Analytics

Artículo
10/20/2023

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: JreNotFound

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: WildcardPathSinkNotSupported

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.
Solución: Sepa por qué ya no se recomienda el "modo FIPS", y valore si puede deshabilitar FIPS en la máquina del entorno de ejecución de integración autohospedado.

De manera alternativa, si solo quiere que se omita FIPS y que las ejecuciones de actividad se realicen correctamente, haga lo siguiente:
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í:
3. Guarde el archivo y, luego, reinicie la máquina del entorno de ejecución de integración autohospedado.

Código de error: JniException

Mensaje: An error occurred when invoking Java Native Interface.
Causa: si el mensaje de error contiene "Cannot create JVM: JNI return code [-6][JNI call failed: Invalid arguments.]" ("No se puede crear JVM: código de retorno de JNI [-6][La llamada de JNI no se ha podido realizar: los argumentos no son válidos]."), la posible causa es que JVM no se puede crear porque se han establecido algunos argumentos no válidos (globales).
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: GetOAuth2AccessTokenErrorResponse

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: FailedToGetOAuth2AccessToken

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: OAuth2AccessTokenTypeNotSupported

Mensaje: The toke 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: OAuth2ClientIdColonNotAllowed

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: ManagedIdentityCredentialObjectNotSupported

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: QueryMissingFormatSettingsInDataset

Mensaje: The format settings are missing in dataset %dataSetName;.
Causa: el tipo de conjunto de datos es binario, lo 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: QueryUnsupportedCommandBehavior

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: DataConsistencyFailedToGetSourceFileMetadata

Mensaje: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Causa: hay un problema transitorio en el almacén de datos receptor o no se permite recuperar metadatos del almacén de datos receptor.

Código de error: DataConsistencyFailedToGetSinkFileMetadata

Mensaje: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Causa: hay un problema transitorio en el almacén de datos receptor o no se permite recuperar metadatos del almacén de datos receptor.

Código de error: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

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: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

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: SkipMissingFileNotSupportedForNonDirectBinaryCopy

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: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

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: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

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: SkipForbiddenFileNotSupportedForThisConnector

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: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

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: SkipInvalidFileNameNotSupportedForSource

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: SkipInvalidFileNameNotSupportedForSink

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: SkipAllErrorFileNotSupportedForNonBinaryCopy

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: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

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: DeleteFilesAfterCompletionNotSupportedForThisConnector

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: FailedToDownloadCustomPlugins

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: UserErrorOdbcInvalidQueryString

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: FailToResolveParametersInExploratoryController

Mensaje: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Causa: El servicio tiene una limitación para admitir el servicio vinculado que hace referencia a otro servicio vinculado con parámetros para probar la conexión u obtener una vista previa de los datos. Por ejemplo, pasar un parámetro de una instancia de Key Vault a un servicio vinculado puede generar el problema.
Recomendación: Para eliminar el error, quite los parámetros del servicio vinculado al que se hace referencia. De lo contrario, ejecute la canalización sin probar la conexión ni obtener una vista previa de los datos.

Para obtener ayuda para solucionar problemas, pruebe estos recursos: