Compartir a través de


Solución de problemas del conector REST en Azure Data Factory y Azure Synapse

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 más información sobre cómo iniciar una nueva evaluación gratuita!

En este artículo se proporcionan sugerencias para solucionar problemas comunes con el conector REST en Azure Data Factory y Azure Synapse.

Código de error: RestSinkCallFailed

  • Mensaje: Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • Causa: este error se produce cuando una canalización de Data Factory o Synapse se comunica con el punto de conexión REST mediante el protocolo HTTP y se produce un error en la operación de solicitud.

  • Recomendación: compruebe el código de estado HTTP o el mensaje de error y solucione el problema del servidor remoto.

Código de error: RestSourceCallFailed

  • Mensaje: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • Causa: Este error se produce cuando Azure Data Factory se comunica con el punto de conexión REST sobre el protocolo HTTP, y se produce un error en la operación de solicitud.

  • Recomendación: compruebe el código de estado HTTP, la URL de solicitud o la carga de la respuesta del mensaje de error y solucione el problema del servidor remoto.

Código de error: RestSinkUNSupportedCompressionType

  • Mensaje: User Configured CompressionType is Not Supported By Azure Data Factory:%message;

  • Recomendación: compruebe los tipos de compresión admitidos para el receptor REST.

Respuesta de red inesperada del conector REST

  • Síntomas: A veces, el punto de conexión recibe una respuesta inesperada (400/401/403/500) del conector REST.

  • Causa: El conector de origen REST utiliza la dirección URL y el método HTTP/encabezado/cuerpo del servicio vinculado/conjunto de datos/origen de copia como parámetros al crear una solicitud HTTP. Lo más probable es que el problema se deba a errores en uno o varios parámetros especificados.

  • Solución:

    • Utilice "curl" en la ventana del símbolo del sistema para ver si el parámetro es la causa (los encabezados Accept y User-Agent se deben incluir siempre):

      curl -i -X <HTTP method> -H <HTTP header1> -H <HTTP header2> -H "Accept: application/json" -H "User-Agent: azure-data-factory/2.0" -d '<HTTP body>' <URL>

      Si el comando devuelve la misma respuesta inesperada, corrija los parámetros anteriores con "curl" hasta que devuelva la respuesta esperada.

      También puede usar "curl--help" para realizar un uso más avanzado del comando.

    • Si solo el conector REST devuelve una respuesta inesperada, póngase en contacto con el servicio de soporte técnico de Microsoft para solucionar el problema.

    • Tenga en cuenta que "curl" puede no ser adecuado para reproducir el problema de validación de certificados SSL. En algunos escenarios, el comando "curl" se ha ejecutado correctamente sin generar ningún problema de validación de certificados SSL. Sin embargo, cuando se ejecuta la misma dirección URL en un explorador, en realidad no se devuelve ningún certificado SSL para que el cliente establezca una relación de confianza con el servidor.

      Se recomiendan herramientas como Fiddler para el caso anterior.

El certificado de entidad de servicio en Azure Key Vault no es correcto

  • Mensaje: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • Causa: solo admite el certificado de entidad de servicio de cadena base64 para la autenticación de certificados de entidad de servicio del conector Rest.
  • Recomendación: siga esta sección para guardar el certificado de entidad de servicio en Azure Key Vault correctamente.

Para obtener ayuda para solucionar problemas, pruebe estos recursos: