Share via


Solucionar problemas do conector REST no Azure Data Factory e no Azure Synapse

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Este artigo fornece sugestões para solucionar problemas comuns com o conector REST no Azure Data Factory e no Azure Synapse.

Código de erro: RestSinkCallFailed

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

  • Causa: Este erro ocorre quando uma fábrica de dados ou pipeline Synapse fala com o ponto de extremidade REST sobre o protocolo HTTP e a operação de solicitação falha.

  • Recomendação: Verifique o código de status HTTP ou a mensagem na mensagem de erro e corrija o problema do servidor remoto.

Código de erro: RestSourceCallFailed

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

  • Causa: este erro ocorre quando o Azure Data Factory fala com o ponto de extremidade REST sobre o protocolo HTTP e a operação de solicitação falha.

  • Recomendação: Verifique o código de status HTTP ou o URL da solicitação ou a carga útil de resposta na mensagem de erro e corrija o problema do servidor remoto.

Código de erro: RestSinkUNSupportedCompressionType

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

  • Recomendação: Verifique os tipos de compressão suportados para o coletor REST.

Resposta de rede inesperada do conector REST

  • Sintomas: o ponto final às vezes recebe uma resposta inesperada (400, 401, 403, 500) do conector REST.

  • Causa: o conector de origem REST utiliza o URL e o método/cabeçalho/corpo de HTTP do serviço associado/conjunto de dados/origem de cópia como parâmetros quando constrói um pedido HTTP. O problema é provavelmente causado por alguns erros num ou mais parâmetros especificados.

  • Resolução:

    • Use 'curl' em uma janela do Prompt de Comando para ver se o parâmetro é a causa (os cabeçalhos Accept e User-Agent devem sempre ser incluídos):

      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>

      Se o comando retornar a mesma resposta inesperada, corrija os parâmetros anteriores com 'curl' até retornar a resposta esperada.

      Você também pode usar 'curl--help' para um uso mais avançado do comando.

    • Se apenas o conector REST devolver uma resposta inesperada, contacte o suporte da Microsoft para aprofundar a resolução do problema.

    • Observe que 'curl' pode não ser adequado para reproduzir um problema de validação de certificado SSL. Em alguns cenários, o comando 'curl' foi executado com êxito sem encontrar problemas de validação de certificado SSL. Mas quando a mesma URL é executada em um navegador, nenhum certificado SSL é realmente retornado para que o cliente estabeleça confiança com o servidor.

      Ferramentas como Postman e Fiddler são recomendadas para o caso anterior.

Para obter mais ajuda na solução de problemas, tente estes recursos: